Handbuch · Website-Integration

Deine Website mit smt-LISTINGS verbinden.

Öffnungszeiten, Bewertungs-Widget und Blog-Funktion Schritt für Schritt einrichten – allgemein, für WordPress und im Detail für Wix. Damit sich deine Daten auf der Website selbst aktuell halten.

  • 3Integrationen: Öffnungszeiten, Bewertungen, Beiträge
  • ~10Minuten pro Integration
  • 7Kapitel, inklusive Wix im Detail
  • 0Programmierkenntnisse nötig
Inhaltsverzeichnis
Teil B · Integration allgemein
1Über dieses Handbuch2Öffnungszeiten verbinden2.1Code in smt-LISTINGS erzeugen2.2Code auf der Website einsetzen3Bewertungs-Widget einbinden4Blog-Funktion per Script einbinden5Blog-Funktion für WordPress einrichten5.1Application Password erstellen5.2Verbindung in der smt-APP einrichten5.3Fehler res_forbidden beheben
Teil C · Wix im Detail
6Öffnungszeiten auf einer Wix-Website6.1Überblick und Voraussetzungen6.2Wix Editor öffnen6.3HTML-Element einfügen6.4Öffnungszeiten-Code einfügen6.5Höhe des Elements anpassen6.6Mobile Ansicht prüfen6.7Website veröffentlichen6.8Häufige Probleme7Bewertungen auf einer Wix-Website7.1Wichtig vorab: die entity_id7.2Variante 1 · Wix Gratisversion7.3Code für die Wix Gratisversion7.4Variante 2 · Kostenpflichtige Wix-Version mit eigener Domain7.5Parameter im Code7.6Häufige Probleme7.7Zusammenfassung

1Über dieses Handbuch

Dieses Handbuch führt Schritt für Schritt durch die Integration von smt-LISTINGS auf einer Website. Es zeigt, wie die Öffnungszeiten, das Bewertungswidget und die Blog-Funktion eingebunden werden.

Durch diese Verknüpfungen synchronisiert das Tool die Daten in Echtzeit mit der Website. Das spart manuellen Aufwand und sorgt dafür, dass Suchmaschinen und KI-Plattformen die Informationen fehlerfrei auslesen können.

·Aufbau

Teil B beschreibt die Einbindung allgemein und gilt für jede Website. Teil C beschreibt die Einbindung auf einer Wix-Website im Detail, mit Beispielcode und Angaben zu Elementgrössen.

!Bitte nicht ändern

Die Adresse api.myls.ch und die Script-IDs im Code sind technische Endpunkte der smt-APP. Sie müssen exakt so stehen bleiben, sonst lädt das Widget nicht. Ersetzt wird ausschliesslich die entity_id.

iDie entity_id ist kundenspezifisch

Jeder Kunde hat eine eigene entity_id. Verwenden Sie deshalb immer den Code, der für den jeweiligen Kunden in der smt-APP generiert wurde. Die Codebeispiele in diesem Handbuch sind Muster und funktionieren nicht ohne Anpassung.

?Support

Bei Fragen während der Einrichtung steht der Support jederzeit unter support@smt-listings.io zur Verfügung.

Teil BIntegration allgemein

2Öffnungszeiten verbinden

Mit smt-LISTINGS gehören manuelle Anpassungen der Öffnungszeiten auf der Website der Vergangenheit an. Sobald das Tool einmalig im Footer der Seite integriert ist, steht die Live-Verbindung: Jede Änderung in der smt-LISTINGS App wird sofort automatisch und überall übernommen.

iWarum die Platzierung im Footer

Suchmaschinen, KI-Plattformen und Navigationsdienste können die Daten dort fehlerfrei als sogenannte «strukturierte Daten» auslesen. Das liefert Systemen wie Google oder ChatGPT die perfekte Vorlage, um das Unternehmen bei Suchanfragen bevorzugt und mit den korrekten Zeiten anzuzeigen.

Unternehmensdaten in smt-LISTINGS mit den hinterlegten Öffnungszeiten
Unternehmensdaten in smt-LISTINGS mit den hinterlegten Öffnungszeiten

2.1Code in smt-LISTINGS erzeugen

  1. In smt-LISTINGS einloggen
  2. Bereich öffnenGehe zu Unternehmensdaten → Öffnungszeiten.
  3. Auf «Einbetten» klicken
  4. Design einstellenWähle aus, ob Wochentage abgekürzt oder zusammengefasst werden sollen.
  5. Schriftfarbe anpassenPasse die Schriftfarbe an das eigene CI an.
  6. Vorschau prüfenIn der Vorschau rechts siehst du, wie es später auf der Website aussieht.
  7. Script-Code kopierenKopiere den generierten Code aus dem Feld Script.
Der Dialog «Öffnungszeiten einbetten» mit Vorschau und Script-Feld
Der Dialog «Öffnungszeiten einbetten» mit Vorschau und Script-Feld

2.2Code auf der Website einsetzen

  1. Seite oder Abschnitt öffnenÖffne die gewünschte Seite oder einen Abschnitt, zum Beispiel «Öffnungszeiten».
  2. Code einfügenFüge den Code in den HTML-Bereich der Seite ein.
  3. Speichern und veröffentlichen
✓Fertig – automatische Synchronisation

Wenn du später deine Öffnungszeiten in smt-LISTINGS anpasst, werden diese automatisch auch auf deiner Website aktualisiert.

→Wix-Website?

Für Wix ist der Ablauf in Kapitel 6 ausführlich beschrieben – inklusive Beispielcode, den nötigen Elementgrössen und der mobilen Darstellung.

3Bewertungs-Widget
einbinden

Mit dem smt-LISTINGS Review-Widget bringst du deine Kundenbewertungen vollautomatisch auf deine Website. Genau wie bei den Öffnungszeiten schaffst du damit eine weitere Verbindung zwischen dem Tool und deiner Website, die Suchmaschinen die Relevanz und Aktualität des Unternehmens signalisiert.

Der Bereich «Bewertungen» in der App
Der Bereich «Bewertungen» in der App
  1. Widget-Einstellungen öffnenKlicke in der App auf das Code-Symbol, um das Widget zu öffnen.
  2. Design anpassenHier kannst du das Design flexibel an den Look deiner Website anpassen, damit es sich nahtlos in den Auftritt einfügt.
  3. Scroll-Verhalten optimierenFür eine optimale Benutzererfahrung empfehlen wir, beim Scroll-Verhalten die Option «bei Scrollen ausblenden» zu wählen. So bleibt die Website übersichtlich, das Widget stört den Lesefluss nicht und blendet sich dezent aus, sobald der Besucher scrollt.
  4. Script kopieren und einbauenKopiere anschliessend das generierte Script und baue es in den Code deiner Website ein, um das Widget live zu schalten.
Die Widget-Einstellungen: Farben, Position und Scroll-Verhalten
Die Widget-Einstellungen: Farben, Position und Scroll-Verhalten
Das Badge live auf einer Website, unten links
Das Badge live auf einer Website, unten links
Das Bewertungs-Badge in der Nahansicht
Das Bewertungs-Badge in der Nahansicht
→Wix-Website?

Für Wix gibt es zwei Varianten – je nachdem, ob die Gratisversion oder eine kostenpflichtige Version mit eigener Domain im Einsatz ist. Beide sind in Kapitel 7 beschrieben.

4Blog-Funktion per Script
einbinden

Mit der Blog-Funktion von smt-LISTINGS kannst du deine Beiträge und Blogartikel vollautomatisch auf deiner Website anzeigen lassen. Jedes Mal, wenn du in der App einen neuen Beitrag veröffentlichst, wird dieser ohne manuellen Aufwand in Echtzeit auf deiner Website eingepflegt.

iFür welche Websites

Diese Variante funktioniert über einen Script-Link und eignet sich für normale Websites. Für WordPress gibt es eine direkte Anbindung – siehe Kapitel 5.

Der Bereich «Beiträge» in smt-LISTINGS
Der Bereich «Beiträge» in smt-LISTINGS
  1. Bereich «Beiträge» öffnenIn deinem smt-LISTINGS Account auf Beiträge klicken.
  2. Zahnrad-Symbol öffnenOben rechts auf das Zahnrad-Symbol klicken.
  3. «Skript generieren» auswählen
  4. Script-Code kopieren
  5. Unterseite erstellenAuf der Website eine neue Unterseite erstellen, zum Beispiel «News» oder «Aktuell».
  6. Script-Code einfügenDen Code auf dieser Seite einfügen.
  7. Neuen Post erstellen und Website auswählenDie News-Beiträge werden nun automatisch angezeigt.
Beim Erstellen eines Beitrags «Website» als Kanal mit auswählen
Beim Erstellen eines Beitrags «Website» als Kanal mit auswählen
→Beispiel

So haben wir das bei uns selbst umgesetzt: smt-listings.io/news

5Blog-Funktion für
WordPress einrichten

Auch bei WordPress werden Beiträge, die du in der App veröffentlichst, in Echtzeit auf deiner Website eingepflegt. Die Verbindung wird hier nicht über ein Script, sondern direkt über die WordPress-Benutzerverwaltung hergestellt.

Application Passwords im WordPress-Dashboard
Application Passwords im WordPress-Dashboard

5.1Application Password erstellen

  1. Als Admin anmeldenMelde dich mit einem Admin-Benutzer im WordPress-Dashboard an.
  2. Benutzereinstellungen öffnen
  3. Zu «Application Passwords» scrollenScrolle nach unten zum Punkt Application Passwords.
  4. Passwort erzeugenGib einen Namen für die Verbindung ein, zum Beispiel «Posting», und klicke auf Add New Password.
  5. Passwort sichernDas generierte Passwort wird angezeigt – kopiere und sichere es, da es später nicht mehr einsehbar ist.
«Account hinzufügen» – WordPress auswählen
«Account hinzufügen» – WordPress auswählen

5.2Verbindung in der smt-APP einrichten

  1. Kategorie anlegenIm WordPress-Dashboard eine Kategorie «Aktuelles» erstellen.
  2. Website-Posting öffnenÖffne die smt-APP und gehe zur Einrichtung des Website-Postings.
  3. Zugangsdaten eintragenVerwende den Benutzernamen und das Application Password, das du zuvor für diesen Benutzer erstellt hast.
  4. Website-URL eingebenGib die Website-URL ein, um die Verbindung vollständig herzustellen.
  5. Kategorie wählenDanach die Kategorie «Aktuelles» wählen.
→Beispiel

So haben wir das bei einem Kunden umgesetzt: scherrer-motos.ch/news

Zugangsdaten und Website-URL in der smt-APP eintragen
Zugangsdaten und Website-URL in der smt-APP eintragen
Standardkategorie «Aktuelles» auswählen
Standardkategorie «Aktuelles» auswählen

5.3Fehler res_forbidden beheben

Tritt beim Verbinden die Fehlermeldung res_forbidden auf, füge die folgende Zeile zur Datei .htaccess hinzu, direkt nach RewriteEngine On.

!Zuerst sichern

Sichere den Inhalt der .htaccess-Datei, bevor du Änderungen machst.

RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
Teil CWix im Detail

6Öffnungszeiten auf einer
Wix-Website

6.1Überblick und Voraussetzungen

Mit dem smt-LISTINGS Öffnungszeiten-Widget zeigen Sie Ihre aktuellen Öffnungszeiten auf Ihrer Wix-Website an. Die Zeiten werden automatisch über die smt-APP geladen und auf Ihrer Website dargestellt.

Voraussetzungen

  • Zugriff auf den Wix Editor Ihrer Website
  • Den persönlichen smt-LISTINGS Öffnungszeiten-Code
  • Eine veröffentlichte Wix-Website
iGut zu wissen

Das Widget funktioniert auch mit der kostenlosen Wix-Version.

!Bitte nicht ändern

Die Adresse api.myls.ch und die Script-IDs im Code sind technische Endpunkte der smt-APP. Sie müssen exakt so stehen bleiben, sonst lädt das Widget nicht. Ersetzt wird ausschliesslich die entity_id.

6.2Wix Editor öffnen

  1. Bei Wix anmelden.
  2. Die Website im Wix Editor öffnen.
  3. Auf die Seite wechseln, auf der die Öffnungszeiten erscheinen sollen — zum Beispiel Kontakt, Startseite oder Über uns.

6.3HTML-Element einfügen

  1. Links im Wix Editor auf Elemente hinzufügen oder das Plus-Symbol (+) klicken.
  2. Embed Code oder Einbetten wählen.
  3. Embed HTML oder HTML einbetten wählen.
  4. Das HTML-Element an der gewünschten Stelle platzieren.
!Wichtig

Bitte Embed HTML / HTML-Code verwenden — nicht Website-Adresse einbetten.

6.4Öffnungszeiten-Code einfügen

  1. Auf das HTML-Element klicken und Code eingeben oder Enter Code wählen.
  2. Den persönlichen smt-LISTINGS Öffnungszeiten-Code einfügen.
  3. Auf Aktualisieren, Übernehmen oder Apply klicken.
!Beispielcode

Der untenstehende Code ist ein Muster. Das Script muss durch den individuellen Code ersetzt werden, den Sie aus der smt-APP erhalten haben. Besonders der Wert entity_id ist kundenspezifisch.

<style> html, body { margin:0; padding:0; overflow:hidden; } #smt-business-hours-wrapper { width:100%; min-height:350px; overflow:hidden; } </style> <div id="smt-business-hours-wrapper"> <script type="text/javascript" id="business-hours-script" src="https://api.myls.ch/js/business-hours.js?entity_id=MzYx&locale=de&text_color=000000&mode=standard&day_name=full"> </script> </div>

6.5Höhe des Elements anpassen

Damit keine Scrollleiste angezeigt wird, muss das HTML-Element in Wix genügend hoch sein.

Desktop
ca. 350 px
Mobile
ca. 400–450 px
!Wichtig

Es reicht nicht, nur den Code anzupassen. Das Wix-Element selbst muss ebenfalls genügend hoch eingestellt sein.

6.6Mobile Ansicht prüfen

  1. Im Wix Editor in die Mobile Ansicht wechseln.
  2. Auf das eingefügte HTML-Element klicken.
  3. Das Element bei Bedarf nach unten grösser ziehen.
  4. Prüfen, ob die Öffnungszeiten ohne Scrollleiste sichtbar sind.

Falls die Darstellung auf dem Smartphone nicht optimal ist, kann das Element in der mobilen Ansicht separat angepasst werden.

6.7Website veröffentlichen

  1. Oben rechts auf Veröffentlichen klicken.
  2. Die veröffentlichte Website in einem neuen Browserfenster öffnen.
  3. Die Darstellung auf Desktop und Smartphone prüfen.

6.8Häufige Probleme

Die Öffnungszeiten werden nicht angezeigt

  • Wurde der Code als HTML-Code eingefügt?
  • Wurde nicht versehentlich «Website-Adresse einbetten» verwendet?
  • Wurde die Website nach dem Einfügen veröffentlicht?
  • Ist die Website online erreichbar?
  • Wurde der Code vollständig kopiert?
  • Wurde das Beispielscript durch den persönlichen smt-LISTINGS Code ersetzt?

Es erscheint eine Scrollleiste

Erhöhen Sie die Höhe des HTML-Elements im Wix Editor. Empfehlung: Desktop mindestens 350 px, Mobile mindestens 400–450 px.

Die Öffnungszeiten sind abgeschnitten

Das HTML-Element ist wahrscheinlich zu niedrig. Ziehen Sie es im Wix Editor etwas nach unten grösser und veröffentlichen Sie die Website erneut.

Die Darstellung ist auf dem Smartphone anders

Wix verwaltet die mobile Darstellung teilweise separat. Wechseln Sie in den Mobile Editor und passen Sie dort Position und Höhe des HTML-Elements an.

7Bewertungen auf einer
Wix-Website

7.1Wichtig vorab: die entity_id

Der Einbindungscode enthält eine kundenspezifische entity_id. Diese muss je nach Kunde ersetzt werden. Beispiel: entity_id=TVRVeU9Eaz0%3D

Verwenden Sie deshalb immer den Bewertungs-Code, der für den jeweiligen Kunden in der smt-APP generiert wurde.

7.2Variante 1 · Wix Gratisversion

Funktioniert ebenso in den kostenpflichtigen Versionen. Bei der Gratisversion von Wix wird das Widget am zuverlässigsten über das HTML-Code-Fenster eingefügt. Dabei wird nur das Bewertungs-Badge mit den Bewertungen angezeigt.

iHinweis

In dieser Variante wird der Klick auf das Badge blockiert. Dadurch öffnet sich beim Anklicken kein Google-Fenster und es entstehen keine iFrame-Probleme innerhalb von Wix.

  1. Wix Editor öffnen.
  2. Die gewünschte Seite öffnen, auf der das Bewertungs-Badge angezeigt werden soll.
  3. Links auf Hinzufügen klicken.
  4. Einbetten / Embed auswählen.
  5. HTML einbetten oder Embed HTML auswählen.
  6. Das HTML-Element an der gewünschten Stelle platzieren.
  7. Auf Code eingeben klicken.
  8. Den Code aus Kapitel 7.3 einfügen.
  9. Auf Desktop und Mobile prüfen.
  10. Die Website veröffentlichen.

7.3Code für die Wix Gratisversion

<!DOCTYPE html> <html> <head> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <style> html, body { margin:0 !important; padding:0 !important; width:100% !important; max-width:100% !important; overflow-x:hidden !important; box-sizing:border-box; } *, *::before, *::after { box-sizing:border-box; } .smt-review-wrapper { width:100%; max-width:420px; margin:0 auto; position:relative; font-family:Arial, sans-serif; overflow:hidden; } .smt-review-box { width:100%; max-width:100%; min-height:180px; position:relative; overflow:hidden; pointer-events:none; } .smt-click-blocker { position:absolute; inset:0; z-index:999999; background:transparent; cursor:default; } @media (max-width:480px) { .smt-review-wrapper { width:100%; max-width:100%; margin:0; padding:0; overflow:hidden; } .smt-review-box { width:100%; max-width:100%; min-height:160px; overflow:hidden; } } </style> </head> <body> <div class="smt-review-wrapper"> <div class="smt-review-box"> <script type="text/javascript" id="embed-reviews-script" src="https://api.myls.ch/js/embed-reviews-script.js?entity_id=TVRVeU9Eaz0%3D&background_color=%23eee8e8&text_color=%23333333&border_color=%23c3c1c1&is_rounded=false&position=left"> </script> </div> <div class="smt-click-blocker" aria-hidden="true"></div> </div> </body> </html>

Hinweis zur mobilen Darstellung

Das HTML-Element in Wix sollte in der mobilen Ansicht auf die volle verfügbare Breite gezogen werden. Wenn rechts oder links ein Scrollbalken entsteht, sollte die Breite des HTML-Elements reduziert oder neu auf die Seitenbreite angepasst werden.

Desktop
ca. 420 px breit · 180–220 px hoch
Mobile
volle Breite · ca. 160–190 px hoch

7.4Variante 2 · Kostenpflichtige
Wix-Version mit eigener Domain

Bei einer kostenpflichtigen Wix-Website mit verbundener Domain kann der Code alternativ über den Bereich Custom Code im Wix-Dashboard eingefügt werden. Das ist vor allem dann sinnvoll, wenn das Bewertungs-Badge seitenweit oder auf ausgewählten Seiten automatisch geladen werden soll.

!Wichtig

Die Original-Einbindung funktioniert nur dann zuverlässig, wenn Wix das externe Script auf der Live-Website korrekt ausführt. Da Wix Drittanbieter-Code nicht vollständig kontrolliert, sollte die Einbindung nach dem Veröffentlichen immer auf Desktop und Smartphone getestet werden.

  1. Wix Dashboard öffnen.
  2. Zu Einstellungen wechseln.
  3. Custom Code oder Benutzerdefinierter Code öffnen.
  4. Auf + Add Custom Code klicken.
  5. Den smt-LISTINGS Script-Code einfügen.
  6. Einen Namen vergeben, zum Beispiel «smt-LISTINGS Google-Bewertungen».
  7. Auswählen, ob der Code auf allen oder nur auf bestimmten Seiten geladen werden soll.
  8. Als Position wird Body – end empfohlen.
  9. Speichern und Website veröffentlichen.
  10. Die Live-Website auf Desktop und Smartphone prüfen.

Original-Code für die kostenpflichtige Wix-Version

<script type="text/javascript" id="embed-reviews-script" src="https://api.myls.ch/js/embed-reviews-script.js?entity_id=TVRVeU9Eaz0%3D&background_color=%23eee8e8&text_color=%23333333&border_color=%23c3c1c1&is_rounded=false&position=left"></script>

Auch hier muss die entity_id pro Kunde ersetzt werden.

7.5Parameter im Code

ParameterBedeutung
entity_idKundenspezifische ID aus der smt-APP. Muss je nach Kunde ersetzt werden.
background_colorHintergrundfarbe des Bewertungs-Badges.
text_colorTextfarbe im Bewertungs-Badge.
border_colorRahmenfarbe des Bewertungs-Badges.
is_roundedAbgerundete Ecken. Möglich sind true oder false.
positionPosition des Badges, zum Beispiel left.

7.6Häufige Probleme

Das Widget wird auf Mobile abgeschnitten

Prüfen Sie im Wix Mobile Editor Breite und Höhe des HTML-Elements. Das Element sollte nicht breiter sein als der sichtbare Seitenbereich.

Es entsteht ein seitlicher Scrollbalken auf dem Smartphone

Meistens ist das HTML-Element zu breit eingestellt oder ragt leicht über den sichtbaren Bereich hinaus. Verwenden Sie den Code aus Variante 1 und stellen Sie das Element in Wix Mobile auf die volle verfügbare Breite.

Beim Klick öffnet sich Google nicht korrekt

Google-Seiten können innerhalb eines Wix-iFrames blockiert werden. Deshalb wird bei der Gratisvariante der Klick bewusst deaktiviert. Soll ein Link zu den Google-Bewertungen verwendet werden, fügen Sie ihn besser als separaten Wix-Button ausserhalb des HTML-Elements ein.

Das Widget erscheint nach dem Einfügen nicht sofort

Veröffentlichen Sie die Website und prüfen Sie die Live-Version. Manche Scripts werden im Wix Editor oder in der Vorschau nicht identisch dargestellt wie auf der veröffentlichten Website.

7.7Zusammenfassung

✓Das Wichtigste in Kürze
  • Bei der Wix Gratisversion wird das Bewertungs-Badge über ein HTML-Code-Fenster eingefügt.
  • In dieser Variante wird nur das Badge sichtbar angezeigt.
  • Der Klick auf das Badge wird blockiert, damit keine Google-iFrame-Fehler entstehen.
  • Bei kostenpflichtigen Websites mit verbundener Domain kann die Original-Einbindung über Custom Code getestet werden.
  • Die entity_id muss immer pro Kunde ersetzt werden.
  • Nach dem Einfügen die Darstellung immer auf Desktop und Smartphone prüfen.

Du kommst nicht weiter?

Wir helfen bei der Einrichtung.

Schreib uns mit einem Screenshot der Stelle, an der du stehst – am schnellsten geht es so. Kapitel 5 kannst du auch direkt an deinen Entwickler weiterleiten.