Documentation
Below is full documentation on how to use the various aspects of the Great Big Green Week website.
Click here to access a more concise breakdown of the available tags.
Theme image sizes
Across the site there are images in the featured carousel, as preview images on grid items and blog on posts. The dimensions of an image should be 1500 x 1130px ideally.
You can download PSD template for this here.
Creating, editing and duplicating an event
Below is a video explaining how to add an event to the website:
Below is a video explaining how a user would edit an event that they had created:
If a user wants to duplicate an existing event, without having to readd all the details manually they can do so via the 'Manage your events' section of the user admin dashboard.
This video explains that process in more detail:
Approving draft and modified events
This section explains how to approve draft events and modifications to existing events before putting them live on the website.
In a best case scenario we can use the NationBuilder API to instantly approve draft events and put them live on the website. The following video explains that process:
In scenarios where there might be problem with the NationBuilder API the site will reflect that issue and offer you an alternate way to carry out tasks. In this video I'll explain how to approve a draft event when the API is out of action:
In a best case scenario we can use the NationBuilder API to instantly approve modifications to events and put them live on the website. The following video explains that process:
In scenarios where there might be problem with the NationBuilder API the site will reflect that issue and offer you an alternate way to carry out tasks. In this video I'll explain how to approve modifications to an event when the API is out of action:
Miscellaneous functionality options
If you don't want the social media share links to appear after someone uses an action page. e.g:
You can add the tag 'noshare' to the page where it appears.
If the 'After signing up, show this success message' field is filled and the 'noshare' tag is present, the popup will appear with the message but without the share links.e.g:
Landing page
There are various ways that you can enhance the layout of a basic page so that it feels more like a landing page. These methods are detailed below.
To include content from another basic page on a landing page you need to:
- Create a basic page
- Add some content to it
- Navigate to the basic page you are using as your landing page
- Add a page tag with the structure 'include:[slug of page to include]'. For example, if the page you're including has the slug 'my_include_page' then the tag would be 'include:my_include_page'.
Below is an example of a basic page include:
By default page includes will be ordered on the page according to when they were added to the page. However, you can set the order of page includes by appending '**order:[number to appear on the page]' to your include tag.
So for example if I have to includes on a page:
include:my_sign_up_form, include:about_us_intro
And I want to guarantee that the 'about_us_intro' include appears first on the page, I can append the order to the tags like this:
include:my_sign_up_form**order:2, include:about_us_intro**order:1
You can add featured image to basic page include by adding a slide in the include page's 'Featured content sliders' section found in the page 'Settings'.
As with a header image, if you don't want the featured image to link to another page you can add the same slug as the include page in the 'Page to feature*' field.
If you add more than one slide then they will appear as a carousel wherever the page is included.
You can see an example of a basic page include with an image below:
In certain include instances (basic page with image and forms) you can align the text to the left and the image or form to the right, if required, by doing the following:
- Go to the include basic page (for example if your include page is 'my_include_page' then this the page you need to edit).
- Add the tag 'block align:right'.
- Save the page.
The include block will now appear on the landing page with the text on the right and the image or form on the left. Below is an example showing this:
For any include block you add to a page there are seven possible colour scheme available for use.
By default the include will have a white background. You can change the include colour scheme by doing the following:
- Go to the include basic page (for example if your include page is 'my_include_page' then this the page you need to edit).
- Add a tag with the structure 'colour scheme:[1,2,3,4,5 or 6]'. So if I want to use the 4th available alternative scheme the tag would be 'colour scheme:4'.
- Save the page.
The include block will now appear on the landing page with the specified colour scheme. Below is an image showing the different schemes available.
You can add up to three 'Call to Action' buttons to a basic page include by doing the following:
- Go to the include basic page (for example if your include page is 'my_include_page' then this the page you need to edit).
- Add a tag with the structure 'button [1,2or 3]:[slug or url to link to]'. So if I want to add button 1 to the include linking to a page with the slug 'about_us' the tag would be 'button 1:about_us'.
- Save the page.
By default the button label will read 'Find out more' but you can change the label by appending '**' followed by the desired label to the tag. So for example, if I want my button to read 'About us' then the tag would be 'button 1:about_us**About us'.
Below is an image showing a basic include with all three buttons added:
You can add a YouTube video pop up to a basic page include by doing the following:
- Go to the include basic page (for example if your include page is 'my_include_page' then this the page you need to edit).
- Add a tag with the structure 'video:[url fo YouTube video]'. So if you want the video located at https://youtube.com/my-video to appear in a pop up on click then the tag should be 'video:https://youtube.com/my-video'.
- Save the page.
By default the link label for the video will read 'Watch the video', you can change this by appending '**' followed by the desired label to the tag. So for example, if I want my video link to read 'See last year's highlights' then the tag would be 'video:https://youtube.com/my-video**See last year's highlights'.
Below is an image showing a basic include with a video link added:
If the include has an image you can overlay the pop up click on that instead by adding the tag 'image video click':
Includes are not limited to basic pages, blogs and calendars. Any other page type can be included on a page as well by following the same formula outlined in the 'Basic Page includes' section of this documentation.
So for example, if you had a sign up form with the slug 'my_signup_form' and you wanted it to appear on the page in the third position your tag would be 'include:my_sign_up_form**order:3'.
You could also apply a colour scheme in the same way as described in the 'Changing the colour scheme of an include' section above.
Page header section
This section show you how to add different elements to the header area of a page.
These principles apply to instances where a featured image slider is present and when it is not.
To add a an intro excerpt to the header section of a page do the following:
- Go to the page 'Settings' tab
- Go to the 'SEO' tab
- Add your desired intro in the 'Excerpt' field
- Add the tag 'add intro' to the page
You can see an example of this on the Get Involved page.
Supporter nav buttons are the main Call to Actions that are set here and appear in the footer of the site by default.
They can also be added to the header of a site, be that overlayed on a featured slider, or just underneath the main title, by adding the tag 'add main buttons'.
An example of this can be seen on the site home page.
You can add up to three 'Call to Action' buttons to a the header section of a page by doing the following:
- Go to the page you want to add the buttons to in the dashboard.
- Add a tag with the structure 'header button [1,2or 3]:[slug or url to link to]'. So if I want to add button 1 to the header section with the slug 'about_us' the tag would be 'header button 1:about_us'.
- Save the page.
By default the button label will read 'Find out more' but you can change the label by appending '**' followed by the desired label to the tag. So for example, if I want my button to read 'About us' then the tag would be 'button 1:about_us**About us'.
Below is an image showing a page with all three buttons added:
The footer of the site already show the default sign up form in a condensed form. You can add it to the header section of a page as well by adding the tag 'add_signup' to a page or post.
To change the default sign up form:
- Navigate to the form you want to set as the default.
- Go the to page settings tag.
- Tick the checkbox 'Make this the default sign up form'.
Note: Doing this will change all instances of the header and footer form across the site.
You can see an example of this on the site home page.