Skip to content

Theme Structure

Important Note:  The contents of this document applies ONLY to version 5.x.x of Simple:Press.  It likely does NOT apply to version 6.x.x (our latest version).

Simple:Press provides a series of standard supplied themes (also know as Core Themes) along with their Child Theme Frameworks. Child Theme Frameworks are not discussed here.

The Standard Supplied Simple:Press Themes (Core Themes) available from Our Theme Library are:

  • Barebones Theme
  • Barebones CSS Desktop
  • Barebones CSS Mobile
  • CSS-Only Theme
  • Default Theme
  • iForum Theme
  • Reboot Theme
  • Stacked Theme
  • Unified Theme

More information regarding the Simple:Press Core themes is contained at the Core Themes Codex page.

Theme Folder Structure

The theme Folder structure begins with a folder named for the theme, i.e. “default”, “reboot”, etc.
Opening the “default” theme folder, for example, shows the next level of folders and files.
At this level there are 3 folders and 2 files:

  • images‘ folder – containing the image files (‘.jpg’, ‘.gif’, ‘.png’) used for icons on the Admin and theme pages. A few examples are:
    • ‘sp_ArrowDown.png’ – an image file containing a down arrow.
    • ‘sp_DeletePost.png’ – an image file containing the icon associated with deleting posts.
    • ‘sp_LogInOut.png’ – an image file containing the icon associated with logging in and loggin out.
  • styles‘ folder – containing sub-folders and ‘.css’/’.php’/’.spcss’ and other files associated with the look or “style” of the theme.
    • images‘ sub-folder – containing the ‘.gif’, ‘.png’, and ‘.jpg’ files associated with the backgrounds and icons associated with the overlays of the theme. A few examples are:
      • ‘berries-n-cream_gradient.gif’ – the file associated with the “berries-n-cream” overlay.
      • ‘onoff.png’ – the file containing the “on/off” icon displayed in the theme overlays.
    • overlays” sub-folder – containing the “.php” files defining the styling of each of the overlays of the theme, if the theme has them. A few examples are:
      • ‘berries-n-cream.php’ – the “berries-n-cream” template color attributes file for the theme.
      • ‘desert-haze.php’ – the “desert-haze” template color attributes file for the theme.
    • font” sub-folder – containing the various files defining the styling in the two (2) Barebones-CSS themes that do not have overlays. A few examples are:
      • ‘Barebones.eot’ – the “Embedded Open Type” font file for the theme. It are supported only by Microsoft Internet Explorer.
      • ‘Barebones.json’ – the “JavaScript Object Notation” font file for the theme. It is an open-standard format that uses human-readable text to transmit data objects consisting of attribute-value pairs.
      • ‘Barebones.svg’ – the “Scalable Vector Graphics” font file for the theme. SVG fonts are currently supported only in Safari and Android Browsers.
      • ‘Barebones.ttf’ – the “True Type Font” font file for the theme. TTF files are currently used by both Apple and Microsoft as a raster font format.
      • ‘Barebones.woff’ – the “Web Open Font Format” font file for the theme. It is the World Wide Web Consortium (W3C) Recommendation. It is essentially OpenType or TrueType with compression and additional metadata.
    • .css‘ and ‘.php‘ styling files – files defining the styling of the theme. A few examples are:
      • ‘default-rtl.css’ – the “.css” file defining the Right-To-Left styling for the SP Default theme.
      • ‘default.php’ – the main styling file for the SP Default theme.
      • ‘reset.css’ – the “.css” file defining the reset styling for the SP Default theme.
  • templates‘ folder – contains the sub-folders and template files that define the various pages of the theme. Some themes display the same information in the same way regardless of the viewing device. Other themes change the content depending on whether the viewing device is a “desktop” device or “mobile” device such as a smart phone or tablet. In some themes the files for a given viewing device are held in sub-folder named ‘desktop‘ and ‘mobile‘.
  • Some examples of template files are:

    • ‘spFoot.php’ – This template is used to display the content at the bottom (footer) of every full forum page in most themes.
    • ‘spForumView.php’ – This template is used to display a Forum and the list of Topics within the Forum in most themes.
    • ‘spGroupView.php’ – This template is used to display the Groups and the Forums within each Group in most themes.
    • ‘spHead.php’ – This template is used for all forum content that is displayed at the top (header) of every full forum page in most themes.

     
    The list of “template’ files within standard supplied Simple:Press themes accompanied by a short description of each file’s purpose is contained at the About Template Files Codex page.

    The general structure of template files and thus the structure of theme pages of standard supplied Simple:Press themes is contained at the Theme Page Structure Codex page. Knowledge of the template file structure is helpful if modifications to pages within a theme are being considered.

    Note: If ANY changes are being considered to template files in the standard supplied Simple:Press themes, it is recommended a Child Theme be developed to contain minor changes. A Custom theme is recommended if more extensive changes are being considered.

  • spTheme.jpg‘ – the file containing the image used to identify the theme when viewed from the Admin menu at Forum > Themes > Available Themes where an “Activate” button can be used to make the theme the “active” one on the website.
  • spTheme.txt‘ – the file containing the text describing the theme. Part of the content of this file is displayed along with ‘spTheme.jpg‘ to describe the theme when viewed from the Admin menu at Forum > Themes > Available Themes.

Changelog

Since Simple:Press initial versions.

Codex page sync’d with version 5.6.5.

Posted in