Este artículo explica cómo añadir widgets de Regiondo a una página web de Jimdo y cómo personalizar su diseño con CSS.
1. Por qué hay que modificar el código estándar del widget
- El código del editor de widgets de Regiondo tiene dos partes:
- Elemento HTML personalizado: define el widget y su ID de widget único.
- Cargador de JavaScript: carga e inicializa el widget.
- El editor de Jimdo elimina los elementos HTML no compatibles, como
<product-catalog-widget>, al guardar o publicar el código. Mantiene el cargador de JavaScript. - Como resultado, el archivo JavaScript se carga, pero el widget no se puede mostrar porque falta su elemento HTML.
Ejemplo del código estándar del Catalog Widget:
<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. Añadir el widget a tu página web de Jimdo
Si el editor de la página web permite JavaScript pero elimina los elementos HTML personalizados, el elemento del widget se puede crear con document.write(). En lugar de pegar el elemento personalizado del widget directamente en el editor HTML, inclúyelo dentro de una etiqueta <script> estándar. El cargador de JavaScript no cambia.
- Copia el código de tu tipo de widget.
- Sustituye
INSERT WIDGET ID HEREpor el ID de widget real generado en el Panel de mando de Regiondo. - Pega el código en el editor HTML de tu página web de Jimdo, en el lugar donde quieres que aparezca el widget.
Importante:
- Para cada tipo de widget, el elemento HTML y el cargador de JavaScript no cambian. Sustituye solo el ID del widget.
- Si el widget no se muestra después de añadir el código, ponte en contacto con nuestro equipo de soporte.
2.1. Catalog Widget
<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. Product Widget
<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. Booking Widget
<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. Button Widget
<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. Cómo funciona esta solución alternativa
- Jimdo mantiene el elemento
<script>estándar, porque no es una etiqueta no compatible. - Mientras se carga la página,
document.write()crea el elemento del widget de Regiondo. - El cargador de JavaScript de Regiondo encuentra ese elemento y muestra el widget.
Nota:
document.write()debe ejecutarse durante la carga inicial de la página. No funciona si el creador de páginas web retrasa los scripts o los ejecuta después de que se haya cargado la página.
4. Personalizar el diseño del widget con CSS
- Los widgets Catalog y Product de Regiondo utilizan Shadow DOM, que mantiene su diseño separado del resto de tu página web.
- Las reglas CSS de la hoja de estilos habitual de tu página web no pueden cambiar el aspecto del widget.
- Para aplicar CSS personalizado, el widget debe hacer referencia a una plantilla de estilos con el atributo
styles-template-id. - Los elementos
<template>y<style>también son etiquetas HTML, por lo que Jimdo puede eliminarlos igual que el elemento del widget. Por eso, la plantilla CSS debe colocarse dentro dedocument.write()junto con el elemento del widget.
4.1. Ejemplo de Catalog Widget con CSS personalizado
Este ejemplo personaliza el Catalog Widget:
- Los botones de reserva son negros con texto blanco.
- Los títulos de los productos son rojos.
- El fondo del catálogo sigue siendo transparente.
<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. Cómo funciona la plantilla CSS
-
document.write()crea tanto la plantilla CSS como el elemento del Catalog Widget. -
<template id="product-catalog-widget-styles">contiene las reglas CSS del widget. -
styles-template-id="product-catalog-widget-styles"conecta el widget con la plantilla CSS. - El cargador de JavaScript muestra el widget y aplica los estilos de la plantilla.
- Puedes cambiar las reglas CSS para conseguir el aspecto que quieras.
Importante:
- Un elemento
<style>por sí solo no basta para dar estilo al widget. Se necesita el atributostyles-template-idcorrespondiente.- Los selectores CSS deben coincidir con elementos que existan en el widget.
- Incluye solo las reglas CSS que realmente necesites. El CSS antiguo o sin usar de intentos de personalización anteriores puede provocar cambios no deseados.
- Si necesitas ayuda con la personalización del estilo, ponte en contacto con nuestro equipo de soporte.
Artículos relacionados
- Cómo ajustar el código de tu Widget Editor
- Cómo utilizar el editor de widgets
- ¿Cómo funciona la integración del nuevo React Catalog & Product Widget?