Change log

Site Globals

Site Globals, under ‘Settings’, is where you can set up customised data points for your website that will then become globally available throughout the site, wherever Liquid mark-up can be used.

These custom data points will also be available in the Component Manager, for easy insertion into a page or layout.

Typical use-cases for Site Globals might be to store the company name, address, contacts, logo, etc. in one handy location and render that information throughout the site via Liquid. Providing a more maintainable set of data if, say a phone number or email address changes and needs to be updated site-wide.
However, Site Globals can be used for various other purposes, such as controlling style elements like global brand colours, icons and images or even global conditions to change how pages display or which page elements are visible.
The uses for Site Globals are limited only by your imagination.

Site Globals Setup

To start using Site Globals first create a Group by clicking the “Create New Group” button.

You’ll likely want to create Groups to better organise different types of globals. For example; you might have a Group called ‘Company Information’ and another called ‘Design Settings’.

To make a change to a particular Group, click on the “Edit settings” button in that Group’s header bar.
Here you’ll be able to adjust the name of the group and also the Liquid tag syntax that will be used for accessing the Group data.

Once a Group has been set up you can start adding Properties to it (which are the individual data points you’ll be storing here) by clicking the “Add new property” button within that Group’s header bar.

A Property will consist of the following attributes:

Type
Description
Name
The display name for your Property.
Alias
The Liquid reference that can be used to access this Properties value.
Short Alias
The same as Alias above, but just a shortened version to keep your Liquid tags neater.

Both Alias and Short Alias can be used throughout the site to access the Property value.

Type

The data field type used for inputting and storing the Property value.
Field types available are:
DateTime - provides a date/time picker for storing date and time related values.
Media - provides a File Manager interface for selecting or uploading files.
Text (String) - provides a single-line text input field.
Text (Multiline) - provides a multi-line text input field.

You can edit the value of any Property by clicking the pencil icon in the ‘Actions’ column next to the Property item or delete the Property via the trash can icon.

At a glance, the Groups, Properties and their values will be displayed in a list view, along with the Liquid Alias to use for rendering those values.

To use this Site Globals, simply copy the Alias you’d like to use and paste it into a page, template, layout or any other content field that supports Liquid mark-up.
Or generate the Property tag via the Component Manager whenever it’s available (such as when editing page contents or module items).


Related Articles

  • Liquid Objects & Usage
    {{ siteglobals }}
    This liquid object will output any custom configure Site Information data (found in the Admin's main menu under 'Settings' > 'Site Information').
  • Extras
    Image Processor
    Treepl CMS utilises the ImageProcessingModule which allows you to perform image manipulations (such as resizing, cropping, quality/compression, filters, etc.) simply by adding URL query string parameters to your image source paths.
  • Content Modules
    Pages
    Pages allow the creation and management of standard page content and folders. Pages can be arranged within folders, secured from unauthorised access, hidden from either site search or search engines, assigned to templates and given full SEO properties among various other settings.
  • Content Modules
    File Manager
    The File Manager provides browserable and functional access to the site’s file storage. You can...
  • Liquid Components
    countries
    This component renders a form select element of all country names and country codes by default, and can also be used to output country codes/names to a Liquid collection.
  • Content Editing
    Admin Editor (WYSIWYG/Code View)
  • Website Templates
    *Bikes
  • Website Templates
    *Clothing Store
  • Website Templates
    Coffee
  • Website Templates
    *Coworking
  • Website Templates
    Digital Agency
  • Website Templates
    Furniture
  • Website Templates
    *Hair Salon
  • Website Templates
    Max
  • Content Editing
    On-Site Editor (OSE)
    The OSE is an in-context-editor that allows for quick and simple editing and styling of on-page text content directly within the context of the page (while viewing the live website).
  • Content Editing
    On-Site Editor (OSE) PRO
    The On-Site Editor allows admin users to manage designated content from the front-end of the website in a more streamlined and intuitive manner.

External Resources

There are currently no external resources available.

Please let us know if you have any other contributions or know of any helpful resources you'd like to see added here.

Questions?

We are always happy to help with any questions you may have.
Visit the Treepl Forum for community support and to search previously asked questions or send us a message at support@treepl.co and we will consult you as soon as possible.