How to integrate Silktide with Drupal 8

Looking for Drupal 7? You can view documentation for Drupal 7 here.

This guide details what the Silktide CMS plugin for Drupal 8 & 9 does, how to download and install/configure it, and how it is used in practice. You will need Administrator access and be able to upload a plugin to your Drupal installation.

This plugin enables two main features:

Easily switch from the Silktide application to the appropriate page in your Drupal installation to make changes.
New or changed pages in your Drupal installation will be automatically checked in Silktide when published.

Downloading/Installing the plugin

This guide should be read in conjunction with the Installing Drupal modules guide on the Drupal site.

Using Composer

If you maintain your Drupal site using composer, just add composer require 'drupal/silktide:^8.0' to your composer.json file and perform ‘composer update’.

If you’re integrating with Drupal 9, update with composer require 'drupal/silktide:^9.0'.

Automated module import with URL

Go to the module’s project page at https://www.drupal.org/project/silktide/ and copy the URL for the version of the module you want to use. In your Drupal site, log in as Admin, and go to ‘Extend’. Click the ‘Install new module’ and paste in the URL of the .tar.gz file.

If you do not see the ‘Install new module’ at the top of the ‘Extend’ screen, please ensure you have followed the Drupal guide to Enable the Drupal core module ‘Update Manager’

Manual install

Alternatively, download the tar.gz file from https://www.drupal.org/project/silktide/ and extract it to [db8-root]/modules/ (where [db-8] is the root of your Drupal 8 website)

Activating the Plugin

After installing the plugin, either click the ‘Enable newly added modules’ button shown or go to the ‘Extend’ page in the Drupal control panel. Tick the box next to ‘Silktide’ and then click either ‘Install’ or ‘Enable’.

Configuring the Plugin

In your Silktide account, open any website report, then go to the Settings >Integrations and copy the API key displayed.

In your Drupal menu, go to Configuration and select Silktide under the Web Services listing.

In the API Key field of the ‘Silktide Configuration’ page, paste the key you copied in step 1.

Click Save Configuration.

You will need to retest your site in Silktide for these changes to take effect.

Authentication

Silktide provides an API key to authenticate calls to the API for CMS integrations.

To obtain your API key:

Login to Silktide
Choose your website
In the top right of the screen, Click Settings > Integrations.
Click New CMS, then select your CMS and Add

Retesting your site

Once the plugin has been configured in Drupal, you will then need to retest your site so Silktide will read the relevant data.