Questo articolo spiega come aggiungere i widget di Regiondo a un sito web Jimdo e come personalizzarne il design con il CSS.
1. Perché il codice standard del widget deve essere modificato
- Il codice del Widget Editor di Regiondo è composto da due parti:
- Elemento HTML personalizzato: definisce il widget e il suo ID widget univoco.
- Loader JavaScript: carica e inizializza il widget.
- L’editor di Jimdo rimuove gli elementi HTML non supportati, come
<product-catalog-widget>, quando il codice viene salvato o pubblicato. Mantiene invece il loader JavaScript. - Di conseguenza, il file JavaScript viene caricato, ma il widget non può essere visualizzato perché manca il suo elemento HTML.
Esempio del codice standard 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. Aggiungi il widget al tuo sito web Jimdo
Se l’editor del sito web consente JavaScript ma rimuove gli elementi HTML personalizzati, l’elemento del widget può essere creato con document.write(). Invece di incollare l’elemento personalizzato del widget direttamente nell’editor HTML, inseriscilo all’interno di un tag <script> standard. Il loader JavaScript rimane invariato.
- Copia il codice per il tuo tipo di widget.
- Sostituisci
INSERT WIDGET ID HEREcon l’ID widget effettivo generato nella Dashboard di Regiondo. - Incolla il codice nell’editor HTML del tuo sito web Jimdo, nel punto in cui deve comparire il widget.
Importante:
- Per ogni tipo di widget, l’elemento HTML e il loader JavaScript restano invariati. Sostituisci solo l’ID widget.
- Se il widget non viene visualizzato dopo aver aggiunto il codice, contatta il nostro team di supporto.
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. Come funziona la soluzione alternativa
- Jimdo mantiene l’elemento
<script>standard, perché non è un tag non supportato. - Durante il caricamento della pagina,
document.write()crea l’elemento del widget di Regiondo. - Il loader JavaScript di Regiondo trova quell’elemento e visualizza il widget.
Nota:
document.write()deve essere eseguito durante il primo caricamento della pagina. Non funziona se il website builder ritarda gli script o li esegue dopo che la pagina è stata caricata.
4. Personalizza il design del widget con il CSS
- I widget Catalog e Product di Regiondo usano lo Shadow DOM, che mantiene il loro design separato dal resto del tuo sito web.
- Le regole CSS nel foglio di stile normale del tuo sito web non possono modificare l’aspetto del widget.
- Per applicare un CSS personalizzato, il widget deve fare riferimento a un template di stile tramite l’attributo
styles-template-id. - Anche gli elementi
<template>e<style>sono tag HTML, quindi Jimdo potrebbe rimuoverli proprio come l’elemento del widget. Per questo il template CSS deve essere inserito all’interno didocument.write()insieme all’elemento del widget.
4.1. Esempio di Catalog Widget con CSS personalizzato
Questo esempio personalizza il Catalog Widget:
- I pulsanti di prenotazione sono neri con testo bianco.
- I titoli dei prodotti sono rossi.
- Lo sfondo del catalogo rimane trasparente.
<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. Come funziona il template CSS
-
document.write()crea sia il template CSS sia l’elemento del Catalog Widget. -
<template id="product-catalog-widget-styles">contiene le regole CSS per il widget. -
styles-template-id="product-catalog-widget-styles"collega il widget al template CSS. - Il loader JavaScript visualizza il widget e applica gli stili del template.
- Puoi modificare le regole CSS per ottenere l’aspetto che desideri.
Importante:
- Un elemento
<style>da solo non basta per applicare uno stile al widget. È necessario l’attributostyles-template-idcorrispondente.- I selettori CSS devono corrispondere a elementi presenti nel widget.
- Includi solo le regole CSS che ti servono davvero. CSS vecchi o inutilizzati, rimasti da precedenti tentativi di personalizzazione, possono causare modifiche indesiderate.
- Per ricevere assistenza con lo stile personalizzato, contatta il nostro team di supporto.
Articoli correlati
- Come modificare il codice del Widget Editor
- Come usare il Widget Editor
- Come funziona l’integrazione del nuovo React Catalog & Product Widget?