This guide details the Silktide CMS plugin for Umbraco: the Silktide features it enables and how to configure it.
What the Umbraco plugin does
This integration enables two main features:
Users can easily make page updates where necessary with a one-click switch from the Silktide platform to the editor page in your Umbraco installation.
Recently updated pages will be automatically checked in Silktide when published, so that your website results are always up-to-date.
How the Umbraco plugin works
The integration is made up of a plugin, code snippet and API key.
The Silktide plugin does two things:
Allows us to find the corresponding editor page URL in Umbraco for a given public website URL.
Sends us a webhook when a page is updated in Umbraco.
A code snippet inserted in your master template adds a Silktide-readable meta tag to each page that enables our system to find the Umbraco editor URL.
An API key is used to authenticate calls to our API from Umbraco.
Configuring the Umbraco CMS integration
Requirements
You will need an API key from Silktide, to be able to upload a plugin to your Umbraco installation, and to edit a core page template.
1. Install the plugin
Installation is handled via Nuget for V9+.
Head to Silktide's Nuget page and select the appropriate version. The version numbers directly relate to Umbraco versions.
Still using a legacy version of Umbraco? No problem. Follow the information below.
Then simple navigate to Packages, then Install local inside your Umbraco installation.
2. Add code snippet
In your Umbraco backend, navigate to your page templates (ideally your master template) and include the following snippet of code:
<meta name="silktide-cms" content="@Html.Raw(HttpContext.Current.Items["SILKTIDE.CMS"])"
3. Create your API key
Silktide provides an API key to authenticate calls to the API from Umbraco.
To obtain a key:
Login to Silktide.
Open the website in Silktide.
Select Settings > Integrations.
Select the New CMS button.
From the dropdown menu select Umbraco and then select the Add button.
You will then be offered an API key that you can copy.
Note: you will need the appropriate website administrator permissions to set up a new API key.
4. API key configuration
Open your Umbraco backend and select Silktide from the Settings menu. Enter the API key provided by Silktide here and select “click here for verification”.
If this returns successfully, select Save for the changes to take effect.
5. Retesting your site
Once the plugin, API key and code snippet have been configured in Umbraco, you will then need to retest your website inside Silktide.
Login to Silktide and select the website, then select Retest in the top right and wait for the site to finish retesting.
6. Confirm integration is working
Once the website has finished retesting, you should find a CMS button beside your tested page URLs inside the Inventory:
If everything is working properly, selecting the ‘CMS’ button here or elsewhere on the platform should open the associated editor page inside your Umbraco admin account.
7. Confirmation of working page update webhook
To test that the page update webhook is working, check for an active testing progress banner inside Silktide at the top of the website report the next time a page is updated in Umbraco.
Need more help?
If you require any assistance configuring this CMS integration, please reach out to support@silktide.com.