Denne guide beskriver Silktide CMS-plugin til Umbraco: de Silktide-funktioner, det muliggør, og hvordan man konfigurerer det.
Hvad Umbraco-pluginet gør
Denne integration muliggør to hovedfunktioner:
Brugere kan nemt foretage sideopdateringer, hvor det er nødvendigt, med et enkelt klik fra Silktide-platformen til redigeringssiden i din Umbraco-installation.
Nyligt opdaterede sider vil automatisk blive kontrolleret i Silktide, når de offentliggøres, så dine webstedsresultater altid er opdaterede.
Hvordan Umbraco-pluginet fungerer
Integrationen består af et plugin, en kodebit og en API-nøgle.
Silktide-pluginet gør to ting:
Gør det muligt for os at finde den tilsvarende redigeringsside-URL i Umbraco for en given offentlig webside-URL.
Sender os en webhook, når en side opdateres i Umbraco.
En kodebit indsat i din master-skabelon tilføjer en Silktide-læselig meta-tag til hver side, der gør det muligt for vores system at finde Umbraco-redigerings-URL'en.
En API-nøgle bruges til at godkende opkald til vores API fra Umbraco.
Konfiguration af Umbraco CMS-integration
Krav
Du skal bruge en API-nøgle fra Silktide, kunne uploade et plugin til din Umbraco-installation og redigere en kerne-sideskabelon.
1. Installer pluginet
Installation håndteres via Nuget for V9+.
Gå til Silktides Nuget-side og vælg den passende version. Versionsnumrene relaterer direkte til Umbraco-versioner.
Bruger du stadig en ældre version af Umbraco? Intet problem. Følg informationen nedenfor.
Naviger derefter til Pakker, derefter Installer lokalt inde i din Umbraco-installation.
2. Tilføj kodebit
I din Umbraco-backend, naviger til dine sideskabeloner (ideelt set din master-skabelon) og inkluder følgende kodebit:
<meta name="silktide-cms" content="@Html.Raw(HttpContext.Current.Items["SILKTIDE.CMS"])"
3. Opret din API-nøgle
Silktide leverer en API-nøgle til at godkende opkald til API'en fra Umbraco.
For at få en nøgle:
Log ind på Silktide.
Åbn websiden i Silktide.
Vælg Indstillinger > Integrationer.
Vælg knappen Ny CMS.
Fra dropdown-menuen vælg Umbraco og vælg derefter knappen Tilføj.
Du vil derefter blive tilbudt en API-nøgle, som du kan kopiere.
Bemærk: du skal have de relevante webstedsadministratorrettigheder for at oprette en ny API-nøgle.
4. API-nøglekonfiguration
Åbn din Umbraco-backend og vælg Silktide fra Indstillinger-menuen. Indtast API-nøglen leveret af Silktide her og vælg “klik her for verifikation”.
Hvis dette returneres succesfuldt, vælg Gem for at ændringerne træder i kraft.
5. Retest dit websted
Når pluginet, API-nøglen og kodebiten er konfigureret i Umbraco, skal du derefter reteste dit websted inde i Silktide.
Log ind på Silktide og vælg websiden, vælg derefter Retest øverst til højre og vent på, at webstedet er færdig med at reteste.
6. Bekræft integrationen fungerer
Når websiden er færdig med at reteste, bør du finde en CMS-knap ved siden af dine testede side-URL'er inde i Inventar:
Hvis alt fungerer korrekt, bør valg af ‘CMS’-knappen her eller andre steder på platformen åbne den tilknyttede redigeringsside inde i din Umbraco-admin-konto.
7. Bekræftelse af fungerende sideopdaterings-webhook
For at teste, at sideopdaterings-webhooken fungerer, skal du tjekke for en aktiv testfremgangsbanner inde i Silktide øverst i webstedsrapporten næste gang en side opdateres i Umbraco.
Brug for mere hjælp?
Hvis du har brug for hjælp til at konfigurere denne CMS-integration, bedes du kontakte support@silktide.com.