Introduction
This section describes how to add new content items (pages) to the website, and how to make changes to existing items.
It also describes all of the parts that are used on content items and how to use them.
| Created by: | michael | Date: | 07/15/2020 |
This section describes how to add new content items (pages) to the website, and how to make changes to existing items.
It also describes all of the parts that are used on content items and how to use them.
To add a new page, go to CMS - Content Items. In the 'Select a type to add...' select box (at the bottom of the page), choose which Content Type your new item best fits into. This will determine which parts and page structure is used.
You can then start filling in the data to the relevant fields. Below is a description of the all the different parts which can be used on each Content Type - with information on how to add/edit them.
Each Page/Content item is built up of various parts, all the parts are then combined within the Content Type Template which specifies how they should be arranged/displayed.
This section describes how to make basic changes to pages and content items.
When updating a Content Item, we would recommend opening two windows/tabs - one to display the page in the CMS and one to display the page the user sees on the website. This way you can make a small change in the admin system, then refresh the page on the website to check that the change has worked as you expect.
Parts are used within Pages/Content Items, and depending on the specific Content Type the Item is created from some, all or none of these parts may be used.
This is the title of the page within the admin system.
In most cases, this is not displayed on the front-end of the website, it's only used within the admin system to uniquely identify this content item.
The URL where this content item is accessed (in most cases). This is a text input and requires a simple text input. e.g. "/thanks" "/thank-you", "/our-hotel".
It should be relative, i.e. start with a /.
It should and not include the website domain or language prefix.
It should not include any special characters e.g. %, &, £, etc.
It should not include any spaces.
It should include - between words.
It should be all lower case.
Please be careful when updating a page URL. The old URL will no longer be accessible, and any links pointing to this page (internal or external) will no longer work. Any links within the website will need to be updated manually.
There is typically 1 Page Title per page/content item. In most cases, this closely matches the "Title", but it is written in a way users would expect to see the title on the page.
This is generally the H1 on the page (not the <Title></Title> tag which is set using the SEO Part).
It should be descriptive of the page content, but not too long.
This is a text input and requires no HTML (the Content Type will add the required tags around the text you enter - in most cases <h1></h1> tags).
The Image part is used to display a single image in one particular section of the page. The Image part compromises of four fields:
Image Url - Used to pull the image in from the CMS - Images section. You can paste an image URL directly into this field or use the 'select' button to select an existing image from the CMS OR upload a new image to use from your computer.
Image Width & Height - These fields are used to set width/height constraints to an image. If left empty they will revert to the automatic image height or use the CSS styles applied to this particular image section. Note: Some content items have width/height disabled in the HTML as the image should auto-size with CSS.
Alternate text - This will be applied to the image alt="" in the HTML: used mainly for SEO purposes.
Image Collection parts are used to display multiple images - the format of the image once on the page will depend on how they are set up within the Content Type. This may mean they are displayed in a slideshow, carousel, thumbnails, etc.
Each Image within an ImageCollection has five fields:
Index - This determines the order the images are shown (usually lowest number first).
Title - Title for the image. This may or may not be displayed on the front end of the website depending on the set up. In some places (such as the Homepage) the Title text will be overlayed over the image as a caption.
Caption - Similar to the Title, the caption is only used in some cases and is only used on some ImageCollection parts throughout the website.
Image - Used to pull the image in from the CMS - Images section. You can paste an image URL directly into this field or use the 'select' button to select an existing image from the CMS OR upload a new image to use from your computer.
Link - Similar to the Title/Caption, the link field is only used on some ImageCollection parts throughout the website. This can be an onsite or offsite URL.
To add a new Image to the collection, simply click the 'add new' button and an empty entry will appear.
To remove an image from the collection, click the 'remove' button which appears directly below the image entry you no longer need.
These are used to add page/content item specific text. They are WYSIWYG editors which allow you to add headings, lists, bold/underline/italicize text and many other options.
They are generally used whenever large chunks of text need to be inserted into a page.
The PageHtml part is used to add any custom HTML needed to a page. You can write or paste any HTML here and it will print correctly on the front end of website.
Unlike the regular HTML part, the PageHtml part is edited at the content item level so can be different on each page.
Data/Text fields are used for several different purposes - this could be to:
Each data field will be labeled, to provide information on how it should be used.
The SEO part allows you to change the SEO information for each content item. See below for a brief description of what each field does:
Title - The page meta title. Title tags are displayed on search engine results pages as the clickable headline for the search engine result.
Description - The page meta description. This should be a short description of the content on the page, no more than 160 characters.
Keywords - A list of keywords for the page, seperated by comma.
Canonical URL - A canonical URl is a technical solution for duplicate content. The canonical URL for any PT or translated pages should point back to the original EN URL.
Head Tags are used to inject any additional HTML head tags which may be needed onto the page. A good example of usage for this is adding Open Graph tags, e.g.
<meta property=”og:title” content=”Your eye-catching title here” />
Each tag should be added individually and will be inserted just before closing </head> tag.
This part creates a list of a certain Content Type. An example of usage would be displaying a list of all blog posts with click-through links to read the full story/ view the full content item.
Page Size is where you can specify the maximum number of items to display per page.
The Query section is for JSON filtering of the returned data, this allows for the creation of subsets of content items e.g. to only display items where a certain input is checked.
Sort By is where you can specify a field to filter the data by e.g. by OrderIndex or BlogPostDate.
Sort Order is the order in which the data will be displayed - ascending or descending.
The types to display section is where you can add multiple Content Types to display in the list. Click the 'add new' button then select the Content Type to display.
By default, the list will display the full page template. You can however change this by adding an aspect to the Content Type which essentially creates a cut-down version of the available data.
Each content item you see in a list is based on a specific Content Type, but not all content items are used as pages on the website.
For example, a "Testimonial Item" Content Type may be created to allow multiple 'Testimonial' content items to be created, each testimonial won't have its own full page on the website, but there is still a content item created for each testimonial.
To see all the content items of a certain type, go to CMS - Content Items and use the 'Show all types' filter. Select the type you'd like to see, and only the items of that type will be shown in the list.
Content Items that are not pages, such as testimonials are displayed in lists on other pages within the website, using the Content List part.
All content items are created and edited in the same way.