Introduction

This style guide aims to advise you the best way to create and publish content across your site and select the right styles established by your brand guidelines and the website design.

Default styles Vs Placement styles

When any content is published, they will automatically have a class of 'default' assigned to them. The website is built to allow you to publish content without having to assign specific placement styles where possible, but some do require placement styles either to allow developers more accurate CSS targeting during the build process or to allow greater manipulation and style choices for yourself.

Most placement styles are usually as simple as giving you different colour options for boxed placements or accordions, but there may be some more special cases outlined below.

Right place, right content…

As part of creating a manageable styling eco system that relies on as little effort to the author as possible, some default placements will change their styling depending where on the page they have been placed - For example a menu placement placed in the banner area will look different to one placed in the footer - this is on purpose and by design, but there may be some cases where a placement style is needed to further manipulate or overwrite this behaviour.

Choosing the right style, for the correct TYPE of content

At present, placement styles can be applied to any content in the CMS, however, placement styles are normally (although not always) created with a specific type of content in mind - Applying the wrong placement to the wrong type of content will either do nothing at all or potentially make some unwelcome style changes …

Naming conventions

In order to help navigate your placement styles and understand what style should be applied to the correct piece of content, we have set some standard naming formats to help you (as well as us) keep track of what can be used where - If a style is designated for a piece of Text content, we will add the letters TC (text content) at the start of the style - Menu placements are (MP), Code Droplet (CD), search tools (SRCH), Blogs (BLG) etc…

Example…s

Text content styles

  • TC - ACCORDION RED
  • TC - ACCORDION BLUE

Menu placement styles

  • MP - Menu colour 1
  • MP - Menu colour 2

Microsites

If you have multiple sites in your installation, to avoid applying a style intended for a different microsite, we will PREFIX the style with the intended microsite.

For a website:

  • WEB - MP - Menu colour 1
  • WEB - TC - ACCORDION BLUE

For the Intranet or similar:

  • INT - MP - Menu Colour 1
  • INT - TC - ACCORDION BLUE

If you require any additional help or feedback, after reading the below, please do not hesitate to contact the VerseOne support team on….

Menu placements (default)

DEFAULT MENU - DESCRIPTION LIST (Main Article area)

DEFAULT MENU - DESCRIPTION LIST (Main Article area)

DEFAULT MENU - DESCRIPTION LIST (Main Article area)

Usage: These menu's do not require you to select a placement style  - but they do require the correct menu settings to be applied.

Menu Settings - Description list:  This menu requires the description list setting

description list menu

Location -  This is the most common menu placement on the site and needs to be placed anywhere in the main content area of the site

Default menu style - DESCRIPTION LIST (External URL)

Default menu style - DESCRIPTION LIST (External URL)

DEFAULT MENU (Description list - External URL)

These menu placements do not require any placement styles, but just need to have the correct menu settings applied

How to set up the external link:  When creating a new page, (you can even use the name of an existing page in the site if already taken) you just have to overwrite the url/slug that's autogenerated by the CMS with the full external link https://www.etc..  You could also use this method to link to other pages inside the website by entering the full url of the page)

external menu example

Selecting the right menu setting:

menu placement image 1

 

Default Menu style - DESCRIPTION LIST

Default Menu style - DESCRIPTION LIST

DEFAULT MENU - DESCRIPTION LIST (Banner Row)

Usage:  As before, these menu's do not require you to select a placement style  - but they do require the correct menu settings to be applied.

Menu Settings - Description list:  This menu (as seen on the homepage) has the same settings as the previous menu placement:

Location -  In order for this menu to pick up the styling, (slightly shallower box and blue heading border) - it must be placed in the banner row of whatever page you're on - this is in accordance with the design and is one less placement style to worry about.

menu banner row example

Style guide - DEFAULT MENU PLACEMENT (Standard list)

Style guide - DEFAULT MENU PLACEMENT (Standard list)

DEFAULT MENU PLACEMENT (Standard list)

Usage: This menu does not required a placements style (other than the default applied) - but it requires the menu options template setting to be 'Standard List' as per below. The menu headline also needs to be set to show 'menu's headline'.

standard list menu example

Menu options: This is a manual menu placement and here you can select the pages you wish to appear in the menu

menu options

Text content styles

TC - Emergency banner

TC - Emergency banner

Emergency banner

How to use:

Any text content that is placed as the last item in the 'Header" will automatically receive the yellow banner styling and replace the aqua band in the header.  This has been reserved primarily for this emergecy notice and therefore no additional placement styles are required, it will pickup the default style for this content.

emergency banner instructions

text content setup

 

 

Popup placements

Popup placements

POPUP PLACEMENT (Default)

Usage: Regular H2 text for the heading and then paragraph text for the body text.  The background seagull logo image is automatically applied.

popup image

 

 

Style guide - Border placements

RD - TC - Border placement DO (GREEN)

Usage: Any text content with this placement style applied will pickup this style

do placement

RD - TC - Border placement DON'T (RED)

don't box

RD - TC - Border placement YELLOW

yellow border example

RD - TC - Border placement AQUA

aqua border example

RD - Style guide - Closeable message

RD - Style guide - Closeable message

RD - TC - Cloesable placement (Banner Row)

Usage: This is a regular text content placement that sits above the breadcrumb - the Closeable placement style is what determines the closeable nature of the placement, but its positioning on the page is what gives it the correct font and colour formatting.

important notice

Variations: If you wanted to have this warning message WITHOUT the ability to close the placement, then you do not need to select a placement style, just placing the content in the banner row is enough for the placement to pick up the correct styling

important message in banner

Live stream blog categories

Live stream blog categories

Live stream blog categories

Usage: This blog requires a category of 'live stream' assigned to it in order to pickup the fan icon and aqua border styles

live stream cateogry image

RD - TC/Table - Contact block/ Blank table

RD - TC/Table - Contact block/ Blank table

RD - TC/Table - Contact block/ Blank table

Usage - Create a table and use one table cell for each contact area.  The placement style will override the default table styling - the CSS will take care of table padding and cell alignment too.

contact table example

RD - TC - Numbered step accordion

RD - TC - Numbered step accordion

RD - TC - Numbered step accordion

Usage:

1. Each of the step headings need to be h3 titles.  

2. Any content that fits between the H3 titles will form the accordion content, until the next H3 title is added - So, just make sure you do not use another H3 title inside the accordion, as this will then trigger a new accordion step to be created.

numbered accordion

Apply the placement style:

numbered accordion guide

Then the Javascript should take care of the rest.

Stye guide - Safe exit button

Stye guide - Safe exit button

RD - TC - Safe exit

Usage: This required the exit site image to be linked to a safe google landing page.

As this is a fixed placement it can be placed anywhere, although I would suggest it's best placed on the bottom row to minimise disruption to other placements on the page.

safe exit

 

Related links placement

Related links placement

Related links placement

1. Head to the page or external link you would like to be part of a related list placement

2. Now add a Category to the page, using the category type of 'Related Link'.  This page already has a related link category of Test page link attached - but we will add a new one - pages can be related to multiple categories.

style guide image

 

3. If the category hasn't already been created you can create a new one here

 style guide image

4. When creating the category, select what 'Type' of Category it should be - in this case we want a new category of related links

style guide image

5. Let's create a new related link category for the "About us" page (as an example)

style guide image

6. We now have 2 related links categories assigned to the 'Editor Styles' page

style guide image

7. Now to create the related link placement on the page you want it to show - This requires us to create a new Content List

style guide image

8. Create a new list here

style guide image

9. Give the list a name - All related link placements will just output a title of 'Related Links' so you can put in Brackets what the page is for. 

- Then filter by category

- Type of content list - 'Page List'.

style guide image

Sliding Anchor Links

Sliding Anchor Links

Sliding Anchor links need to be set up as follows:

1. Create the Anchor:

choose the anchor

 2. Name the Anchor - The Anchor name must not contain any spaces.

name the anchor

3. Choose the linking text

choose linking text

4. Join the link to the Anchor

join the anchor

5. Give the link a class of "sliding-link" in the advanced tab. 

sliding link image

Style guide - CK editor styles

WYSWIG / CK editor HTML styles

Usage: Until the CK editor is updated and you can use the WYSWG dropdown editor to apply a class to certain blocks of text content - this is a temporary way to achieve styling that cannot be targetted with usual placement styles..

Warning text

warning text

Result:

warning text results

Text blocks

style guide img

Result:

style guide image

Document List

style guide image

style guide image

RD - Custom pages and navigation

RD - TC - Custom section nav

RD - TC - Custom section nav

RD - TC - Custom Page navigation

Usage: This menu placement needs to be created manually using a standard ordered list using a regular text content.

An example of this working can be found here:

https://www.arun.gov.uk/section-navigation

1: Create the menu placement -  Doing this as a piece of text content gives you more options for descriptive link names not bound to page titles.

creating the ordered list

2. Ideally this should be placed on the top row of the article area, try not to place this in the top row as this will cause issues with the breadcrumb on mobile.

2. Apply the placement styles

custom section nav

 

 

RD - TC - Custom pagination

RD - TC - Custom pagination

RD - TC - Custom pagination

Usage: 

1. Create an Unordered list for the previous and back buttons - This only needs to be a list of 2 items. NB - You do not need to write the words PREV or BACK, just the name of the link.

add the custom pager links

2. Add a url to page you want

add the url

3. Now add a class to the link of either 'previous-page' or 'next-page' to the links:

style guide next link

style guide prev link

 

4. Add a placement style to the placement

custom pagination

 

Style guide - inline hidden accordions

Style guide - inline hidden accordions

Hidden / Inline accordion 

1: In order to apply this you need to go in to the source view mode and apply the class of "accordion-text".

style guide accordion inline

2: To end the accordion, you need to insert an h5 tag - in this example I have called it accordion end, but you could call it anything you want.  The presence of an H5 triggers the content that follows to reset.

style guide end accordion

3. In the event you want to have some 'pre text' in the same line as the accordion, there is one addtional div that needs adding before the accordion button

style guide image

4. In the example above, the "have a" and "and a" need to go inside their own custom divs - The rest of the accordion needs to be treated as above.

style guide image

 

RD - Custom report tree

RD - Custom report tree

RD - MP - Custom report tree

1. Create the menu tree using pages in the CMS - Contact a service is the Top page where the inital menu is placed

Style guide image

2. All the pages in the First column of the menu are all immediate children of "contact a service' page.

Style guide image

IMPORTANT - The pages in the first column are not pages intended to be directly visited by the customer, so DO NOT place content directly on these pages, they are purely there to provide the menu branches.  These pages need to be hidden from the site global search.

3. The pages in the second column is where the page content will be placed.

Style guide image

4 - PAGE STYLES

On the first page 'Contact a service' and all the pages in the 2nd Column (not the first column), we need to apply a page style of "RD - Contact a service":

Style guide image

 

5. Place the first instance of the mega-menu on the top page - 'Contact a service' page.

style guide image

style guide image

6. Place the MENU and CONTENT on the 2nd column page - The menu placement needs to be in its own row.  The content needs to be in the row directly after the menu placement.  If you want multiple pieces of content to appear in the 3rd column (where the content sits) this is possible by allowing the content to to share the same row.

style guide image

7. Content sharing the same row

style guide image

8. Make sure the menu placement of RD - MP - Custom report tree is selected