Themes and Templates

Steer CMS includes a template system for customising the look and feel of the frontend. Themes are managed as any other plugin, and two (steerCMSSimplyBlueTheme and steerCMSGreenerPasturesTheme) are included with default installs from the sandbox.

Typically, a theme plugin will require a minimum off:

• A template directory with at least one layout template.
• A set of web files (images, css etc) copied to the web directory.
• A thumbnail screenshot

With that list, you have everything you need.

Is all that needs to be done, is notify Steer CMS of the template by adding a few configuration parameters to the config/project.yml file.

Looking in you will find a section similar to this:

  #
  # Themes Configuration
  # --------------------
  # ......
  #
  themes:
    enabled: true
    items:
      default: 
        title:        SimplyBlue Base
        description:  Standard theme for frontend
        file:         "steerCMSSimplyBlueTheme::layout"
        thumbnail:    /themes/steerCMSSimplyBlueTheme/images/thumbnail.png
      - title:        GreenerPastures Base
        description:  Steer CMS based theme, don't forget to eat your greens
        file:         "steerCMSGreenerPasturesTheme::layout"
        thumbnail:    /themes/steerCMSGreenerPasturesTheme/images/thumbnail.png

Some definitions:

• title: Presentation title for template selection interface in the administration area.
• description: A short description - not in use yet!
• file: The plugin and template to be used - {PLUGIN_NAME}::{TEMPLATE_FILENAME}
• thumbnail: Image to represent the template - should be located somewhere in {STEERCMS_PROJECT}/web/