Different frontend and backend domains

Introduction

Most Drupal-websites use the same domain for both frontend and backend (content editing), but in some use cases is the frontend using separate domain. E.g. when using Drupal 8 / 9 fully decoupled or when there is a requirement for a separate edit / backend domain. In these cases will the Siteimprove.ai CMS plugin, when used on the backend domain, not know about the frontend domain and therefore show that a specific page is unknown by Siteimprove.ai. 

This is where the support for different frontend and backend domains comes in useful. The domain support in the Drupal 8 / 9 version of the module is using plugins to give developers the flexibility to implement their own domain handling.

Domain configuration

Frontend domain configuration

1. Navigate to the Siteimprove.ai Plugin settings page; /admin/config/system/siteimprove
2. In the Frontend domain field group select a domain plugin in Siteimprove.ai Domain Plugins.
3. If the selected plugin require configuration, will the available settings be displayed below.
4. Click on Save Configuration button.

Notice: The Domain Access plugin is configured in the domain entity settings in Domain Access.

Domain plugins included

Default domain (default)

The Default domain plugin, which is the default plugin, is for all standard use cases where frontend and backend domains are the same. No configuration available in this plugin.

Single frontend domain

Configuration of the Single frontend domain plugin.

The Single frontend domain plugin is the use cases where you just need a separate frontend domain. 

1. Choose the plugin Single frontend domain in the Siteimprove.ai Domain Plugins field.
2. Input your domain without protocol, path/folders, trailing slash etc. in the field Single frontend domain.
3. Click Save configuration to save your changes.

Domain Access support

The Domain Access support plugin, which is available in the Siteimprove.ai Domain Access submodule, automatically use the configured domains in Domain Access as frontend domain. This plugin does therefore not have any configuration. 

Notice: The Domain Access support plugin depends on the Domain Access module.

Create your own domain plugin

If the included domain plugins does not match your use case or requirements, then can you implement your own plugin using the SiteimproveDomain plugin annotation. For inspiration see the existing plugins.