dorsetdigital/silverstripe-canonical

Adds a simple canonical tag in Silverstripe 4

v1.1 2020-12-08 12:28 UTC

Requires

• silverstripe/cms: ^4.0
• silverstripe/vendor-plugin: ^1.0

BSD-3-Clause

• Tim Burt

• html
• seo
• silverstripe
• canonical

README

Adds a simple rel=canonical tag to Silverstripe 4

Requirements

*Silverstripe 4.x

(For a similar add-on for SS3, please see: lerni/canonical (https://github.com/lerni/canonical)

Installation

• Install the code with composer require dorsetdigital/silverstripe-canonical
• Run a dev/build?flush to update your project

Usage

This module adds a simple canonical tag to your pages to allow for the specification of the default domain.
The canonical tag allows you to signal to search engines like Google which is the authoritative version of the page to help reduce duplicate content issues caused by non-www versions, pages with different protocols, etc.

Once installed, go to the site settings and enter the full canonical domain. This should include the protocol (eg. http:// or https://)

The module tries to be the last extension to be applied, and will try to remove any existing rel="canonical" tags from the head.

At the time of writing, the canonical tags are only added correctly for pages in the SiteTree. Pages generated from custom controllers or from DataObjects may or may not work! When creating the canonical tags, the module will look for a method called CanonicalLink() on the extended object. If you are using DataObjects as pages, adding this method on the relevant controller should allow you to control the canonical URL in these cases.

Additional Credits

• Thanks to @sanderha (https://github.com/sanderha) for the Danish translation
• Thanks to @lerni (https://github.com/lerni) for his enhancements