In diesem Artikel erfährst du, wie du Regiondo Widgets zu einer Jimdo-Website hinzufügst und ihr Design mit CSS anpasst.
1. Warum der Standard-Widget-Code angepasst werden muss
- Der Code aus dem Regiondo Widget Editor besteht aus zwei Teilen:
- Benutzerdefiniertes HTML-Element: definiert das Widget und seine eindeutige Widget-ID.
- JavaScript-Loader: lädt und initialisiert das Widget.
- Der Jimdo-Editor entfernt nicht unterstützte HTML-Elemente wie
<product-catalog-widget>, wenn der Code gespeichert oder veröffentlicht wird. Den JavaScript-Loader behält er bei. - Dadurch wird die JavaScript-Datei zwar geladen, das Widget kann aber nicht angezeigt werden, weil sein HTML-Element fehlt.
Beispiel für den Standard-Code des Katalog-Widgets:
<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. Widget zu deiner Jimdo-Website hinzufügen
Wenn der Website-Editor JavaScript erlaubt, aber benutzerdefinierte HTML-Elemente entfernt, kann das Widget-Element mit document.write() erstellt werden. Statt das benutzerdefinierte Widget-Element direkt in den HTML-Editor einzufügen, packst du es in einen Standard-<script>-Tag. Der JavaScript-Loader bleibt gleich.
- Kopiere den Code für deinen Widget-Typ.
- Ersetze
INSERT WIDGET ID HEREdurch die tatsächliche Widget-ID, die im Regiondo Dashboard generiert wurde. - Füge den Code im HTML-Editor deiner Jimdo-Website an der Stelle ein, an der das Widget erscheinen soll.
Wichtig:
- Für jeden Widget-Typ bleiben das HTML-Element und der JavaScript-Loader gleich. Ersetze nur die Widget-ID.
- Wenn das Widget nach dem Hinzufügen des Codes nicht angezeigt wird, wende dich an unser Support-Team.
2.1. Katalog-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. Produkt-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. Buchungs-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. So funktioniert die Lösung
- Jimdo behält das Standard-
<script>-Element bei, da es kein nicht unterstützter Tag ist. - Während die Seite lädt, erstellt
document.write()das Regiondo Widget-Element. - Der Regiondo JavaScript-Loader findet dieses Element und zeigt das Widget an.
Hinweis:
document.write()muss beim ersten Laden der Seite ausgeführt werden. Es funktioniert nicht, wenn der Website-Baukasten Skripte verzögert oder sie erst nach dem Laden der Seite ausführt.
4. Widget-Design mit CSS anpassen
- Das Katalog- und das Produkt-Widget von Regiondo verwenden Shadow DOM, wodurch ihr Design vom Rest deiner Website getrennt bleibt.
- CSS-Regeln im regulären Stylesheet deiner Website können das Aussehen des Widgets nicht ändern.
- Um eigenes CSS anzuwenden, muss das Widget mit dem Attribut
styles-template-idauf ein Style-Template verweisen. - Die Elemente
<template>und<style>sind ebenfalls HTML-Tags, daher kann Jimdo sie genau wie das Widget-Element entfernen. Das CSS-Template muss deshalb zusammen mit dem Widget-Element indocument.write()platziert werden.
4.1. Beispiel für das Katalog-Widget mit eigenem CSS
Dieses Beispiel passt das Katalog-Widget an:
- Die Buchungsbuttons sind schwarz mit weißem Text.
- Die Produkttitel sind rot.
- Der Hintergrund des Katalogs bleibt 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. So funktioniert das CSS-Template
-
document.write()erstellt sowohl das CSS-Template als auch das Element des Katalog-Widgets. -
<template id="product-catalog-widget-styles">enthält die CSS-Regeln für das Widget. -
styles-template-id="product-catalog-widget-styles"verbindet das Widget mit dem CSS-Template. - Der JavaScript-Loader zeigt das Widget an und wendet die Styles aus dem Template an.
- Du kannst die CSS-Regeln ändern, um das gewünschte Aussehen zu erzielen.
Wichtig:
- Ein
<style>-Element allein reicht nicht aus, um das Widget zu gestalten. Das passende Attributstyles-template-idist erforderlich.- Die CSS-Selektoren müssen Elementen entsprechen, die im Widget vorhanden sind.
- Füge nur die CSS-Regeln hinzu, die du tatsächlich brauchst. Altes oder ungenutztes CSS aus früheren Anpassungsversuchen kann zu unerwünschten Änderungen führen.
- Wenn du Hilfe beim individuellen Styling brauchst, wende dich an unser Support-Team.
Verwandte Artikel
- Wie passe ich den Widget Editor Code über CSS an?
- Wie man den Widget Editor benutzt
- Wie integriert man das React Catalog & Product Widget?