Dieser Leitfaden beschreibt das Silktide CMS-Plugin für Umbraco: die Silktide-Funktionen, die es ermöglicht, und wie man es konfiguriert.
Was das Umbraco-Plugin macht
Diese Integration ermöglicht zwei Hauptfunktionen:
Benutzer können bei Bedarf einfach Seitenaktualisierungen vornehmen, indem sie mit einem Klick von der Silktide-Plattform zur Editor-Seite in Ihrer Umbraco-Installation wechseln.
Kürzlich aktualisierte Seiten werden automatisch in Silktide überprüft, wenn sie veröffentlicht werden, sodass Ihre Website-Ergebnisse immer auf dem neuesten Stand sind.
Wie das Umbraco-Plugin funktioniert
Die Integration besteht aus einem Plugin, einem Code-Snippet und einem API-Schlüssel.
Das Silktide-Plugin erfüllt zwei Aufgaben:
Es ermöglicht uns, die entsprechende Editor-Seiten-URL in Umbraco für eine gegebene öffentliche Website-URL zu finden.
Es sendet uns einen Webhook, wenn eine Seite in Umbraco aktualisiert wird.
Ein in Ihre Mastervorlage eingefügtes Code-Snippet fügt jeder Seite ein von Silktide lesbares Meta-Tag hinzu, das unserem System ermöglicht, die Umbraco-Editor-URL zu finden.
Ein API-Schlüssel wird verwendet, um Anrufe an unsere API von Umbraco aus zu authentifizieren.
Konfiguration der Umbraco CMS-Integration
Anforderungen
Sie benötigen einen API-Schlüssel von Silktide, um ein Plugin in Ihre Umbraco-Installation hochladen und eine Kernseitenvorlage bearbeiten zu können.
1. Installieren Sie das Plugin
Die Installation erfolgt über Nuget für V9+.
Gehen Sie zur Nuget-Seite von Silktide und wählen Sie die entsprechende Version aus. Die Versionsnummern beziehen sich direkt auf die Umbraco-Versionen.
Verwenden Sie noch eine ältere Version von Umbraco? Kein Problem. Folgen Sie den unten stehenden Informationen.
Navigieren Sie dann einfach zu Pakete, dann Installieren lokal in Ihrer Umbraco-Installation.
2. Code-Snippet hinzufügen
Navigieren Sie in Ihrem Umbraco-Backend zu Ihren Seitentemplates (idealerweise Ihr Mastertemplate) und fügen Sie das folgende Code-Snippet ein:
<meta name="silktide-cms" content="@Html.Raw(HttpContext.Current.Items["SILKTIDE.CMS"])"
3. Erstellen Sie Ihren API-Schlüssel
Silktide stellt einen API-Schlüssel zur Verfügung, um Anrufe an die API von Umbraco aus zu authentifizieren.
Um einen Schlüssel zu erhalten:
Melden Sie sich bei Silktide an.
Öffnen Sie die Website in Silktide.
Wählen Sie Einstellungen > Integrationen.
Wählen Sie die Schaltfläche Neues CMS.
Wählen Sie im Dropdown-Menü Umbraco und dann die Schaltfläche Hinzufügen.
Ihnen wird dann ein API-Schlüssel angeboten, den Sie kopieren können.
Hinweis: Sie benötigen die entsprechenden Website-Administratorberechtigungen, um einen neuen API-Schlüssel einzurichten.
4. API-Schlüssel-Konfiguration
Öffnen Sie Ihr Umbraco-Backend und wählen Sie Silktide aus dem Einstellungen-Menü. Geben Sie hier den von Silktide bereitgestellten API-Schlüssel ein und wählen Sie „hier zur Verifizierung klicken“.
Wenn dies erfolgreich zurückkehrt, wählen Sie Speichern, damit die Änderungen wirksam werden.
5. Ihre Website erneut testen
Sobald das Plugin, der API-Schlüssel und das Code-Snippet in Umbraco konfiguriert sind, müssen Sie Ihre Website in Silktide erneut testen.
Melden Sie sich bei Silktide an und wählen Sie die Website aus, dann wählen Sie Erneut testen oben rechts und warten Sie, bis die Seite das erneute Testen abgeschlossen hat.
6. Bestätigen Sie, dass die Integration funktioniert
Sobald die Website das erneute Testen abgeschlossen hat, sollten Sie eine CMS-Schaltfläche neben Ihren getesteten Seiten-URLs im Inventar finden:
Wenn alles ordnungsgemäß funktioniert, sollte das Auswählen der „CMS“-Schaltfläche hier oder anderswo auf der Plattform die zugehörige Editor-Seite in Ihrem Umbraco-Admin-Konto öffnen.
7. Bestätigung des funktionierenden Seitenaktualisierungs-Webhooks
Um zu testen, ob der Seitenaktualisierungs-Webhook funktioniert, überprüfen Sie beim nächsten Mal, wenn eine Seite in Umbraco aktualisiert wird, auf ein aktives Testfortschrittsbanner in Silktide oben im Website-Bericht.
Brauchen Sie mehr Hilfe?
Wenn Sie Hilfe bei der Konfiguration dieser CMS-Integration benötigen, wenden Sie sich bitte an support@silktide.com.
Wir haben ChatGPT verwendet, um die englische Version dieses Artikels zu übersetzen. Wenn Sie etwas sehen, das geändert werden sollte, kontaktieren Sie bitte unser Support-Team.