Dieser Leitfaden beschreibt, was das Silktide CMS-Plugin für Sitefinity tut, wie man es herunterlädt und installiert/konfiguriert und wie es in der Praxis verwendet wird. Sie benötigen Administratorzugriff und müssen in der Lage sein, ein Plugin in Ihre Sitefinity-Installation hochzuladen.
Dieses Plugin ermöglicht zwei Hauptfunktionen:
Einfacher Wechsel von der Silktide-Anwendung zur entsprechenden Seite in Ihrer Sitefinity-Installation, um Änderungen vorzunehmen.
Neue oder geänderte Seiten in Ihrer Sitefinity-Installation werden automatisch in Silktide überprüft, wenn sie veröffentlicht werden.
Installation des Plugins
Dateikonfiguration
Verschieben Sie „SilktidePlugin.dll“ in Ihren Projekt-Bin-Ordner.
Beispiel für SilktidePlugin.dll
Verschieben Sie „Global.asax“ in Ihren Projektstammordner.
Beispiel der zu verschiebenden Dateien.
Verschieben Sie den Ordner „SilktideFiles“ in Ihren Projektstammordner.
Beispiel des zu verschiebenden Ordners
Sicherstellen, dass das URL-Schema korrekt ist
Wenn Sie ein anderes URL-Schema für das Admin-Backend als das Standard-Schema verwenden, müssen Sie „SilktideFiles/JSON/silktideConfig.json“ ändern, um sicherzustellen, dass „backofficeurl“ Ihr neues URL-Schema widerspiegelt. Bei den meisten Installationen sollte dies nicht geändert werden müssen.
Beachten Sie, dass „[pageRelativePath]“ innerhalb dieser Datei bleiben muss, da es zur dynamischen Generierung von URLs verwendet wird.
Hinzufügen der Silktide-Konfigurationsseite
Das Sitefinity-Plugin von Silktide erfordert eine Verwaltungsseite, die die Konfiguration unserer API ermöglicht.
1. Erstellen Sie eine neue Seite in Sitefinity
Beispiel des „Seite erstellen“-Buttons
2. Fügen Sie den Seitennamen hinzu und klicken Sie auf den Button „Erstellen und zum Hinzufügen von Inhalten gehen“.
Beispiel der Seitenerstellung
Beispiel des Buttons „Erstellen und zum Hinzufügen von Inhalten gehen“
3. Ziehen Sie „SilktideAPI“ aus den Sidebar-Widgets.
Beispiel des Standorts des „SilktideAPI“-Widgets
Beispiel des Ziehens des „SilktideAPI“-Widgets auf die Seite
4. Veröffentlichen Sie die Seite, um den Vorgang abzuschließen.
Konfiguration des Plugins
Silktide benötigt einen API-Schlüssel zur Authentifizierung und ein Meta-Tag für die Editor-URL, um den Webhook zu versenden und den Seiteninspektor zu aktivieren.
Erhalt Ihres API-Schlüssels
Silktide stellt einen API-Schlüssel zur Verfügung, um API-Aufrufe für CMS-Integrationen zu authentifizieren.
Um Ihren API-Schlüssel zu erhalten:
Melden Sie sich bei Silktide an
Wählen Sie Ihre Website
Klicken Sie oben rechts auf dem Bildschirm auf Einstellungen > Integrationen.
Klicken Sie auf Neues CMS, wählen Sie Ihr CMS und Hinzufügen
API-Schlüssel-Konfiguration in Sitefinity
Gehen Sie in das Sitefinity-Backend und wählen Sie „Silktide“ aus dem Menü. Geben Sie einfach Ihren von Silktide bereitgestellten API-Schlüssel hier ein und klicken Sie auf „hier zur Verifizierung klicken“. Wenn dies erfolgreich zurückkehrt, drücken Sie „Speichern“, damit die Änderungen wirksam werden.
Beispiel der Silktide CMS-Konfigurationsseite
Einrichtung des Silktide CMS-Meta-Tags
Geben Sie im .cshtml-Seitentemplate die folgende Zeile im Header an:
meta name="silktide-cms" content="@SilktidePlugin.Services.SilktideBackofficeUrl.GetEncUrl()"
Dies muss auf jeder Seite vorhanden sein, auf der das Plugin funktionieren soll. Normalerweise wird dies im Master-Template gemacht, das andere Seiten erben.
Erneutes Testen Ihrer Website
Sobald das Plugin in Sitefinity konfiguriert ist, müssen Sie Ihre Website erneut testen, damit Silktide die relevanten Daten lesen kann.
Melden Sie sich bei Silktide an und wählen Sie Ihren Bericht – klicken Sie einfach oben rechts auf Erneut testen und warten Sie, bis die Website erneut getestet wird.
Navigation von Silktide zu Sitefinity
Sobald der Bericht abgeschlossen ist, können Sie Ihre Ergebnisse anzeigen. Wenn alles korrekt konfiguriert wurde, wird beim Anzeigen des Inspektors oben rechts neben den Schaltflächen Seite und HTML eine "CMS"-Schaltfläche angezeigt.
Durch Auswahl der "CMS"-Schaltfläche gelangen Sie sofort zu Ihrer Sitefinity-Installation mit der entsprechenden geladenen Seite.
Bestätigung des funktionierenden Webhooks
Wenn Sie eine Seite in Ihrem CMS veröffentlichen und dann sofort zu Silktide wechseln, sollten Sie ein blaues Fortschrittsbanner oben auf dem Bildschirm sehen, während die aktualisierte Seite getestet wird.
Wenn Sie Schwierigkeiten mit dieser Integration haben, kontaktieren Sie uns bitte über den Live-Chat in Ihrem Silktide-Konto.