Installationsanleitung · Code-Feld

Besucher-Toolbar in klassische SharePoint-Websites

So binden Sie die Besucher-Toolbar in eine klassische SharePoint-Website ein. Mit der Toolbar passen Besucher an, wie Ihre Seiten für sie selbst aussehen und sich lesen lassen. Sie behebt nichts an Ihrer Website, ändert nichts daran, ob sie WCAG oder BFSG erfüllt, und unsere Scans sehen sie nie.

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

  1. Das funktioniert nur bei klassischen Websites. Installieren Sie PnP PowerShell und verbinden Sie sich mit Connect-PnPOnline mit der Website.
  2. Registrieren Sie die Toolbar für die ganze Websitesammlung: Add-PnPJavaScriptLink -Name RevisebergToolbar -Url "…" -Scope Site, mit der Adresse oben und Ihrem Schlüssel statt YOUR-SITE-KEY.
  3. Ö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