DOCUMENTATION

Theme Documentation

Page templates and Style Guide:

Images:

Featured content sliders/Full width headers

All featured content sliders/full width headers at the top of issue pages must have an aspect ratio of 10:3 to ensure they are consistent. These should be professional, high-quality, high-resolution images and should be uploaded at 2500px wide x 750px high to cater for high-dpi and Retina displays.

Full width header images should only be used on issue and general content pages – not blog/news pages. This is to differentiate campaign and general content from more formal editorial-style content in the blog/news sections.

Thumbnail images

Thumbnail images must have an aspect ratio of 3:2. This is the aspect ratio of a standard digital camera image. These images should be uploaded at 1500px wide x 1000px high to cater for high-dpi and Retina displays. Photographic images should be saved as JPG and optimised for web. Images with mostly text or solid colours should be saved as PNG and optimised for web. This will help reduce file sizes. Images can be optimised by using the ‘Save for web’ function in Photoshop or tinypng.com. Upload this image under the relevant page under Settings>Social Media. This is also the sharing image for social media.

Website Page Tags:

Website page tags allow you to tag blog pages within the site with specific issues (e.g., climate change, transport, renewables etc.). Please note that website page tags are separate from the broadcaster, campaign and issue tags applied by the state office. Website page tags can be anything you like and are for internal use on this website. These allow content that covers the same topics to be grouped together and fed to the end user. This also allows you to show 'Related News' under an issue page. See the custom admin tag ‘Admin show tagged page [TAG]’ below.

Edit, create or remove any, you can also see more information of where a certain tag is being used by clicking under Name to see a list of pages in the backend or under Slug to see a front-end Tags Show page.

Custom admin tags:

Admin Featured Action
- You can use this tag to feature a page in the homepage action slider section. Each page type has customised CTA button text.
Admin Featured Post
- Adding this tag to a blog/news post will pin it to the top of the News landing page at /news and feature its thumbnail image.
Admin Hide News
- Adding this tag to a page will hide the ‘Latest news’ section at the bottom of the page.
Admin Hide Issues
- Adding this tag to a page will hide the ‘More Policies’ section at the bottom of the page.
Admin Show Sidebar Slug:[PAGESLUG]
- Adding this tag to a basic page will show the green ‘TAKE ACTION’ box on the right of the page. I.E. "Admin Show Sidebar Slug:protect_bike_lanes" will show the green ‘TAKE ACTION’ signup form with the signup page "protect_bike_lanes".
Admin Show How Can I Help
- Adding this tag to a page will show the subpages of the ‘How Can I Help’ page as square links.
Admin Hide Headline
- Adding this tag to a basic page will hide the headline
Admin Show Issue Section
- Adding this tag to a page will show a panel with the six latest issues pages share image, headline and link.
Admin Show Issue Subpages
- Adding this tag to a page will show all of the published subpages in a similar layout to the issues page (headline & image).
Admin Show Latest News Section
- Adding this tag to a page will show the latest six blogposts from the site.
Admin Show Related Pages
- Adding this tag to a page will show a row with six sibling pages image, headline and button. Sibling pages are ones that have the same parent page.
Admin Show Community
- Adding this tag to a page will show the Instagram Feed from Juicer
Admin Show Subpages
- Adding this tag to a page will show all of the published subpages (image, headline, 32 words of the content and button).
Admin Show Tagged Page [TAG]
- Adding this tag to a page will show the latest pages that have the tag [TAG]. I.E. "Admin Show Tagged Page Bikes" will show a stream of all pages that have the tag "Bikes" under the heading ‘Related News’.
Admin Show Content Action:[PAGESLUG]
- Adding this tag to a basic page will show an action within the content of a basic page. I.E. "Admin Show Content Action:bike_safety_report" will show a small form with the signup form from the page "bike_safety_report". You can select where the form appears by adding a line break within the content of the page.

General Page Types:

| The pages available with design in this theme are: Basic | Signup | Donation | Blog | Blog Post | Calendar | Event | Petition.
| Create new pages navigating to Website > New page, choose the type of page and give it a name, the slug will be created automatically and is part of the url of each page.
| You will find fields for: Name, Headline, Slug and Tags (separated with commas) in every page, also the option to upload Featured content slider images, Sharing or Thumbnail images.
| The Sharing or Thumbnail images can be uploaded under Settings > Social media in every page, subpage, post or event. In some cases this image will appear as the thumbnail for example in Blog or Calendar pages; the Blog Post or Event pages need thumbnail images to show in the Blog and Calendar respectively and in the sections showing Latest News or Events.
| Create subpages under the Subpages tab in every page, then New subpage.

Homepage:

The Homepage is connected to the main Signup page.

Basic Pages:

Add a Featured content slider image or images under Settings > Featured content sliders where a "Headline" can be set up too, no matter if it is a "custom" Basic Type page with a tag to give a different design. Use the symbol "|" to separate a headline from a short paragraph if required as explained under "General" above. Otherwise, use the site's Header image for a sitewide header section.
Edit the "Headline" under Setting.
Edit the introductory text under Content. Add youtube videos by pasting the complete url and NationBuilder will embed them automatically. Add images uploading them to the Files tab section first, then the image can be selected in the WYSIWYG (What You See Is What You Get) editor.

Signup Page

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
Change the "Headline" under Settings.
Change the main content text under Signup settings > Intro.
Edit the "autoresponse" under Signup settings > Autoresponse.
More settings for signup pages under Signup settings > Basics.

Volunteer Page

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
Change the "Headline" under Settings.
Change the main content text under Volunteer settings > Basics.
Edit the "autoresponse" under Volunteer settings > Autoresponse.
More settings for volunteer signup pages under Volunteer settings > Basics or Volunteer settings > Roles.

Feedback Page

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
Change the "Headline" under Settings.
Change the main content text under Feedback settings > Intro.
Edit the “autoresponse” under Feedback settings > Autoresponse.
More settings for feedback pages under Feedback settings > Basics.

Donation Page

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
Change the "Headline" under Settings.
Change the main content text under Donation settings > Intro.
To edit the "autoresponse" navigate into Donation settings > autoresponse.
More settings under Donation settings > Basics.

Petition Pages

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
Change the "Headline" under Settings.
The main Content text below the title is found under Petition settings > Content > Intro text.
The autoresponse can be edited under Petition settings > Autoresponse.
More petition settings under Petition settings > Basics.

Blog Page

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
Each blog post is found under the Blog page > Posts & subpages. Create a New post (or edit an existing one), add a "Headline" and a "slug", make it "published" and then click the "Create blog post" button.
Filter buttons classifies the posts using tags.

Blog Post Pages

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
Change the "Headline" under Settings.
Add main text under Content. Before the flip text will appear in the Blog page, After the flip additional text will just show after reaching the blog post page itself with the full text.
Upload the thumbnail image that will be shown in the Blog page under Settings > Social media for each blog post.
Add text content, youtube videos or images similar to the Basic type pages (images must be uploaded in the "Files" tab section before adding them within the WYSIWYG editor.)
Add a tag to classify each post.

Calendar Page (Events)

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
This page shows the latest published events created under Events & subpages.
Create new events under Events & subpages, add a "headline" and a "slug", make it "published" and then click the "Create page" button.

Event Pages

Add Featured content slider images under Settings > Featured content sliders just like in the Basic Type Pages. Add a headline using the Featured content slider's "Headline / Action text". Otherwise, use the site's Header image for a sitewide header section.
Change the "Headline" under Settings.
Change the main content text under Event settings > Intro; edit Location, Advanced settings and more.
Some more options for events are found under the "Event settings".