Cet article explique comment ajouter des widgets Regiondo à un site web Jimdo et comment personnaliser leur design avec du CSS.
1. Pourquoi le code standard du widget doit être modifié
- Le code du Widget Editor Regiondo se compose de deux parties :
- Élément HTML personnalisé : définit le widget et son ID de widget unique.
- Chargeur JavaScript : charge et initialise le widget.
- L’éditeur Jimdo supprime les éléments HTML non pris en charge, comme
<product-catalog-widget>, lors de l’enregistrement ou de la publication du code. Il conserve le chargeur JavaScript. - Par conséquent, le fichier JavaScript se charge, mais le widget ne peut pas s’afficher, car son élément HTML est manquant.
Exemple de code standard du widget Catalogue :
<product-catalog-widget widget-id="b1af74e1-cc6a-4b5f-ace4-324a0bd80d4e"></product-catalog-widget> <script type="text/javascript" src="https://widgets.regiondo.net/catalog/v1/catalog-widget.min.js"></script>
2. Ajouter le widget à ton site web Jimdo
Si l’éditeur du site web autorise le JavaScript mais supprime les éléments HTML personnalisés, l’élément du widget peut être créé avec document.write(). Au lieu de coller l’élément du widget personnalisé directement dans l’éditeur HTML, intègre-le dans une balise <script> standard. Le chargeur JavaScript reste le même.
- Copie le code correspondant à ton type de widget.
- Remplace
INSERT WIDGET ID HEREpar l’ID de widget réel généré dans le Tableau de bord Regiondo. - Colle le code dans l’éditeur HTML de ton site web Jimdo, à l’endroit où le widget doit apparaître.
Important :
- Pour chaque type de widget, l’élément HTML et le chargeur JavaScript restent les mêmes. Remplace uniquement l’ID du widget.
- Si le widget ne s’affiche pas après l’ajout du code, contacte notre équipe Support.
2.1. Widget Catalogue
<script type="text/javascript">
document.write('<product-catalog-widget widget-id="INSERT WIDGET ID HERE"></product-catalog-widget>');
</script>
<script type="text/javascript" src="https://widgets.regiondo.net/catalog/v1/catalog-widget.min.js"></script>2.2. Widget Produit
<script type="text/javascript">
document.write('<product-details-widget widget-id="INSERT WIDGET ID HERE"></product-details-widget>');
</script>
<script type="text/javascript" src="https://widgets.regiondo.net/product/v1/product-widget.min.js"></script>2.3. Widget de réservation
<script type="text/javascript">
document.write('<booking-widget widget-id="INSERT WIDGET ID HERE"></booking-widget>');
</script>
<script type="text/javascript" src="https://widgets.regiondo.net/booking/v1/booking-widget.min.js"></script>2.4. Widget Bouton
<script type="text/javascript">
document.write('<button-widget widget-id="INSERT WIDGET ID HERE"></button-widget>');
</script>
<script type="text/javascript" src="https://widgets.regiondo.net/button/v1/button-widget.min.js"></script>
3. Comment fonctionne cette solution
- Jimdo conserve l’élément
<script>standard, car il ne s’agit pas d’une balise non prise en charge. - Pendant le chargement de la page,
document.write()crée l’élément du widget Regiondo. - Le chargeur JavaScript Regiondo trouve cet élément et affiche le widget.
Remarque :
document.write()doit s’exécuter lors du premier chargement de la page. Cela ne fonctionne pas si le créateur de site web retarde les scripts ou les exécute après le chargement de la page.
4. Personnaliser le design du widget avec du CSS
- Les widgets Catalogue et Produit de Regiondo utilisent le Shadow DOM, qui maintient leur design séparé du reste de ton site web.
- Les règles CSS de la feuille de style habituelle de ton site web ne peuvent pas modifier l’apparence du widget.
- Pour appliquer un CSS personnalisé, le widget doit faire référence à un template de style avec l’attribut
styles-template-id. - Les éléments
<template>et<style>sont également des balises HTML : Jimdo peut donc les supprimer comme l’élément du widget. Le template CSS doit par conséquent être placé dansdocument.write()avec l’élément du widget.
4.1. Exemple de widget Catalogue avec CSS personnalisé
Cet exemple personnalise le widget Catalogue :
- Les boutons de réservation sont noirs avec du texte blanc.
- Les titres des produits sont rouges.
- L’arrière-plan du catalogue reste transparent.
<script type="text/javascript">
document.write(`
<template id="product-catalog-widget-styles">
<style>
.regiondo-list-product-button {
background-color: black !important;
color: white !important;
}
.regiondo-list-product-header {
color: red !important;
}
.regiondo-catalog {
background-color: transparent !important;
}
</style>
</template>
<product-catalog-widget
styles-template-id="product-catalog-widget-styles"
widget-id="INSERT WIDGET ID HERE">
</product-catalog-widget>
`);
</script>
<script type="text/javascript" src="https://widgets.regiondo.net/catalog/v1/catalog-widget.min.js"></script>4.2. Comment fonctionne le template CSS
-
document.write()crée à la fois le template CSS et l’élément du widget Catalogue. -
<template id="product-catalog-widget-styles">contient les règles CSS du widget. -
styles-template-id="product-catalog-widget-styles"relie le widget au template CSS. - Le chargeur JavaScript affiche le widget et applique les styles du template.
- Tu peux modifier les règles CSS pour obtenir l’apparence souhaitée.
Important :
- Un élément
<style>seul ne suffit pas pour styliser le widget. L’attributstyles-template-idcorrespondant est obligatoire.- Les sélecteurs CSS doivent correspondre à des éléments qui existent dans le widget.
- N’inclus que les règles CSS dont tu as réellement besoin. Un CSS ancien ou inutilisé provenant de précédentes tentatives de personnalisation peut entraîner des modifications indésirables.
- Pour obtenir de l’aide sur la personnalisation du style, contacte notre équipe Support.
Articles associés
- Comment ajuster le code de l’éditeur de widgets
- Comment utiliser le Widget Editor
- Comment fonctionne l’intégration du nouveau React Catalog & Product Widget?