Bevor Sie anfangen
- Ihr Website-Schlüssel. Sie finden ihn im Reviseberg-Dashboard unter Settings › Visitor toolbar, im Tab Install. In den Schritten unten steht dafür
YOUR-SITE-KEY. - Schalten Sie die Toolbar auf derselben Seite für Ihre Website ein. Solange sie aus ist, lädt das Tag, zeigt aber nichts an.
Der Code
Diese Plattform nimmt eine Adresse statt eines Tags. Der Schlüssel steht darin als ?key=; ersetzen Sie YOUR-SITE-KEY durch Ihren Schlüssel.
https://reviseberg.com/widget/v1.js?key=YOUR-SITE-KEY
Schritte
- Das funktioniert nur bei klassischen Websites. Installieren Sie PnP PowerShell und verbinden Sie sich mit
Connect-PnPOnlinemit der Website. - Registrieren Sie die Toolbar für die ganze Websitesammlung:
Add-PnPJavaScriptLink -Name RevisebergToolbar -Url "…" -Scope Site, mit der Adresse oben und Ihrem Schlüssel stattYOUR-SITE-KEY. - Öffnen Sie eine klassische Seite in einem privaten Fenster und prüfen Sie, ob es funktioniert.
Gut zu wissen
Ein Skript-Link kann kein Attribut tragen, deshalb steht der Schlüssel als ?key= in der Adresse. Die Toolbar liest ihn dort.
Moderne SharePoint-Seiten führen Skript-Links nicht aus. Dafür bräuchte es einen SPFx Application Customizer, den wir noch nicht anbieten.
Entfernen lässt sie sich mit Remove-PnPJavaScriptLink -Identity RevisebergToolbar -Scope Site.
Prüfen, ob es funktioniert
- Öffnen Sie eine Seite Ihrer Website in einem privaten Fenster – nicht im Editor oder in der Vorschau der Plattform, wo die meisten Plugins das Tag absichtlich weglassen.
- Suchen Sie im Seitenquelltext oder im Elemente-Bereich der Entwicklertools nach
widget/v1.js. Es sollte genau ein Tag geben, mit Ihrem Schlüssel. - Die Schaltfläche der Toolbar erscheint, sobald die Toolbar im Dashboard eingeschaltet ist. Auf derselben Seite steht unter „Last seen on your site“, wann das Tag zuletzt auf einer Ihrer Seiten geladen wurde.
- Keine Schaltfläche? In der Browserkonsole steht eine Zeile, die mit „Reviseberg toolbar:“ beginnt und den Grund nennt – etwa einen Schlüssel in der falschen Form oder das Tag doppelt auf der Seite.
- Die Toolbar antwortet nur auf den Adressen, die unter Settings › Visitor toolbar erlaubt sind; die Adresse Ihrer Website ist es immer. Tragen Sie eine Staging-Adresse dort ein, bevor Sie darauf testen.
Weiter
- Wenn Ihre Website eine Content Security Policy sendet, braucht sie für die Toolbar vier Zeilen – sie stehen auf der Installationsseite.
- Alle Plattformen und das Snippet
- Was die Toolbar tut und was nicht