Below are documentation and tutorials explaining how to add different functionality and layout options to the Best for Britain theme.
The following tags can be applied to any sub page of a landing page.
They can also be used to alter the appearance of include content.

Add order_[order number] to a sub page to change the order it will appear on it’s corresponding landing page (i.e. a sub page with order_1 will appear ahead of sub page with order_2 on the landing page).
If you want to stop a sub page from appearing on it’s corresponding landing page you can add the tag hide_on_parent.
With this tag the sub page will no longer appear on the landing page but it will still be listed in the page’s sub navigation. However, the anchor will now link directly to the page rather than to any sub section of the landing page.
If you want to remove the sub page’s headline from the block as it appears on it’s corresponding landing page you can add the tag no_header.
You can add a button to the introductory section of your landing page which links to the corresponding sub section by adding the tag intro_button.
If the sub page also has the ‘hide on parent’ tag then the button will link directly to the page rather than a landing page sub section.
If the intro_button tag exists on any sub page, the landing page sub navigation will no longer appear.
If the add_main_buttons tag is present on the landing page then this will override the intro_button tag meaning it has no effect.

You can change the colour combinations of your sub page as it appears on the landing page by adding either the tag alt_background or altbackground2.
The specific way this will look depends on the colours chosen in your theme’s colour variables file.

If your landing page sub section is an action page you can add the tag divide_page to changes the layout so that the text sits to the left and the action form sits to the right.
This presupposes that there is some introductory text on the sub page other wise the layout will not change.

If your landing page sub section is an action page you can add the tag divide_page to changes the layout so that the text sits to the left and the action form sits to the right.
If you add the tag align_right the layout is reversed so that text sits to the right and the action form sits to the left.
This presupposes that there is some introductory text on the sub page other wise the layout will not change.

Use theses tags to turn a normal blog page into a orderable grid. This is useful for creating staff pages for example.
Add the tag alt_blog changes the standard blog layout to be more suited to content that is not time based.
For example, you could create a grid of team members.

Add the tag order_[order number] to denote what order the post will appear within the blog grid (e.g. order_1 appears before order_2).
To add an email address to an alternative blog post add the tag . The bracketed area should be replaced by the required email address, e.g. email:dan@thespaceroom.com
A link referencing the email address will be added below the post header and any excerpt on the blog grid page. It will also appear below the title on the blog post page.

To insert a website link to an alternative blog post add the tag website:[web address to be added to post]. The bracketed area should be replaced by the required web address, e.g. website:https://thespaceroom.com
A link referencing the web address will be added below the post header and any excerpt on the blog grid page. It will also appear below the title on the blog post page.

You can link the ‘Find out more’ anchor of your alternative blog post to an external location by adding the tag external_link:[external web address for post to link to]. The bracketed area should be replaced by the required web address, e.g. external_link:https://thespaceroom.com
With this tag in place The ‘Find out more’ link as it appears in the blog grid will open the specified web address in a new window on click.

You can link the ‘Find out more’ anchor of your alternative blog post to an internal location within your site by adding the tag internal_link:[slug of internal page for post to link to]. The bracketed area should be replaced by slug of the internal page you want to link to, e.g. internal_link:my_donate_page
With this tag in place The ‘Find out more’ link as it appears in the blog grid will open the internal web page with the specified slug instead of clicking through to a blog post page.

You can display the children of a basic page in a grid format on a landing page by giving that basic page the tag ‘show_sub_sub_pages‘. So for clarity the structure would be:
The tags below can be applied to those sub sub basic pages to further alter their appearance on their corresponding landing page.

Add order_[order number] to a sub sub page to change the order it will appear in the grid seen on it’s corresponding landing page (i.e. a sub sub page with order_1 will appear ahead of sub page with order_2 in a grid on the landing page).

You can link the ‘Find out more’ anchor of your sub sub page to an external location by adding the tag external_link:[external web address to link to]. The bracketed area should be replaced by the required web address, e.g. external_link:https://thespaceroom.com
With this tag in place The ‘Find out more’ link as it appears in on the sub sub page’s corresponding landing page will open the specified web address in a new window on click.

You can link the ‘Find out more’ anchor of your your sub sub page to an internal location within your site by adding the tag internal_link:[slug of internal page to link to]. The bracketed area should be replaced by slug of the internal page you want to link to, e.g. internal_link:my_internal_resource
With this tag in place The ‘Find out more’ link as it appears in on the sub sub page’s corresponding landing page will open the internal web page with the specified slug.

These tags allow you to display content from another section of the site on another page or post. They can be applied to any basic or blog post page.
The includes will be displayed below any content on the page or post in question.
Add the tag include:[slug of content to be added] to a basic page or post. The bracketed area should be replaced by the required web address, e.g. include:my_signup_form. Whatever slug is added to the include tag is displayed in a ‘landing page friendly’ style below any other content.

Add _order:[order number] after the slug portion of an include tag to specify where it should appear in relation to any other includes (i.e. an include tag containing _order:1 will appear ahead of an include tag containing _order:2).
An include tag with an order designation would look like this include:_[slug of page to be added]_order:[order number on page].
e.g. include:my_signup_form_order:1 would appear before include:my_donate_form_order:2 on the page or post.
You can add an include to a page that displays latest content from a chosen blog or blogs in a grid format by adding the tag include:[slug of blog to be added]. So, for example to display the four latest posts from a blog with the slug updates you would add the tag include:updates. The blog include tag can be further modified with the following optional parameters:
Combine two or more blogs
Combine latest content from different blogs by adding further blog slugs proceeded by a +. For example to pull in content from two blogs with the slugs updates and news the tag would be include:updates+news
Define the include order on the page
Define the order that include should appear in the page by appending _order:[order number on page] to the tag. For example to place the blog grid in the fifth position on the page our tag would be include:updates+news_order:5
Define how many posts to display
By default our blog include tag will display the 4 latest posts. To define the number of posts shown on the page you can append _limit:[number of posts to display] to the tag. For example to display the 8 latest blog posts from our two requested blogs combined our tag would be include:updates+news_order:5_limit:8
Paginate the blog grid
You can add pagination to the blog grid by appending _paginate:[number of posts on each page]. So for example, we’ve already defined that we want to display the 8 latest posts in our grid, if we want to paginate our grid after the first 4 posts our tag would be include:updates+news_order:5_limit:8_paginate:4
Define which topics to display
It may be the case that you only want to display posts that are tagged under a certain topic or topics. To define the topic you want to display in your blog grid you can append _topic:[topic name to display]. For example if you only want to display posts in the topic of Corruption and Government Failings our tag would be include:updates+news_order:5_limit:8_paginate:4_topic:Corruption and Government Failings. If you wanted to also add the topic of Rights and Freedoms you would add a further topic append like this: include:updates+news_order:5_limit:8_paginate:4_topic:Corruption and Government Failings_topic:Rights and Freedoms
Note that, aside from defining a blog slug to include, all other parameters are optional and can be sued independently of each other.
You can add the Scandalous Spending Tracker to a landing page as an included section by adding the tag include:sst to any basic page.
You can choose the order that the block appears on the page by adding _order[position on the page] to the tag. So, for example if you want it to be the third block on the page the tag would be include:ssl_order:3.
If you want to edit the different variables of the tracker (e.g. money wasted, titles copy, images etc) you can edit this file.
You can add the ‘To Do List’ to a landing page as an included section by adding the tag include:to_do_list to any basic page.
You can choose the order that the block appears on the page by adding _order[position on the page] to the tag. So, for example if you want it to be the third block on the page the tag would be include:to_do_list_order:3.
You can add a disclaimer to all action forms using the methods described below. The disclaimer will sit alongside the submit button.

To add a general disclaimer to all forms:
That text will then be pulled through for all forms on the site unless a specific disclaimer is set (see following guide).
If you need to add a specific disclaimer to a form that differs from the generic one you can use the following method:
The text from the sub page will then be used in the slot next to the submit button, in place of any generic disclaimer.
Action pages can be used to create a dynamic landing page which both prompts sharing and encourages further actions from someone landing on it.
It’s most useful when used as the redirect page after someone completes an action on the website. For example, after signing a petition they would be redirected to an action page, encouraging them to share the previously signed petition and showing them other content they may be interested in.
An action page dynamically takes note of the the user’s previous url, so any share links will reference the content of that page.
You can add include tags to an Action page to pull in content from other parts of the site which will sit under the title ‘You may also like’ below the share links.
The format of an include tag is include_[page_slug].

Get our research, campaigns, and analysis in your inbox. No spin, no noise — just the evidence-led case for a better Britain.