Modern.gov provide meeting and committee management, democratic services, and report and calendar tools to local authorities.
So that their products and websites can lift the styles and navigation surround of our sites, they request that a standard page is made available, containing tags into which they can inject their content. They call this concept a "Reverse CMS". The HTML of the page is taken by Modern.gov and used on their site.
Where to Create the Article
We recommend creating your Modern.gov article in a hidden area of your site and excluding it from your site search. It's also a good idea to add a robots "noindex" meta tag to the article (see the Additional Properties section of Metadata Properties, Unfurling and Structured Data Markup) so the page isn't indexed by search engine crawlers.
The article must be accessible by Modern.gov, so cannot be secured.
Page Title and Content
An article using the Modern.gov Reverse CMS template is not designed to be viewed by users of your site. The elements that appear on the page are instead used by the Modern.gov products. Rather than standard page content, the template outputs a series of tags. The template also provides key navigational items, like the top level menu, a header, page utilities and page footer.
Content Tags
The following tags are output onto the page.
Tag | Description |
---|---|
{pagetitle} | This tag is inserted into the <title> tag of the page and may be used instead of the page heading (this behaviour is controlled in the article extras) |
{breadcrumb} | This tag acts as the placeholder for the Modern.gov breadcrumb |
{sidenav} | This tag acts as the placeholder for the Modern.gov navigation |
{content} | This tag acts as the placeholder for the main content of the page |
{settings} | This tag lets you customise some of the Modern.gov elements. See below |
Customisation
The article extras provide a range of customisation settings for the template.
Clear Side Column
The {sidenav} token is output in a side column (which one depends on the theme your site is using). If this option is checked, any other content in the column (eg related links or media items) will be hidden. Recommended setting: Checked.
Override Breadcrumb
If checked the {breadcrumb} tag is output. Recommended setting: Checked.
Override Article Heading
Check this box to output the {pagetitle} tag in place of the actual article heading.
Show Theme Article Heading
This option controls whether or not the iCM article heading (or tag) is output. Check the box to output the heading/tag. If it's not checked, neither the heading or the tag are output.
According to the Modern.gov documentation this article heading should normally be hidden as the content injected by them includes a heading.
Hide Modern.gov Article Heading
Check this box to attempt to hide the heading that's output by Modern.gov in their content block. This would allow you to use the article heading (or tag) set in iCM instead.
Hide {meta} Tag
Check this box to hide the {meta} tag, which is not needed by all Modern.gov integrations.
Theme Settings
These settings allow further customisation, depending on the theme your site is using.
Asset Settings
Pick your website theme or "default" from the list to load relevant pre-configured settings. Pick "Custom" to enter settings described below.
Assets
Enter the names of the asset and asset areas that should be overridden by the template. This allows the template to work with custom themes that don't have standard assets.
Modern.gov Settings
As well as the tags visible on the page, the template also outputs a {settings} tag in the page source that can be read by Modern.gov.
Add parameters described by Modern.gov in the format (parameter-name: value). Each parameter should be placed on a new line, for example:
(breadcrumb-parent-start:<div class="breadcrumb__nav"><div class="container"><ol class="breadcrumb">)
(breadcrumb-parent-end:</ol></div></div>)
(breadcrumb-before-item:<li class="breadcrumb__crumb">)
(breadcrumb-after-item:</li>)
(breadcrumb-divider:)
Subsite CORS Settings
So that resources can be shared with Modern.gov, the URLs of any origins (ie the Modern.gov site) and files that can be shared should be added to the subsite configuration. This will generally be the paths to CSS, JavaScript and fonts used by the theme.
Choose between:
- Default - Allows reversecms.moderngov.co.uk as an origin
- Wildcard - Enter URLs and file paths including * as wildcards
- Regex - Enter a regular expression