Download the PHP package samsoncms/template without Composer

SamsonCMS generic template module

This module is responsible for rendering base HTML template, its styles, icons and images.

All template styles is created with LESS, every entity has it .

This module should define HTML structure of SamsonCMS, its building blocks and entities which should be used in all other SamsonCMS modules and applications.

This template is basic and included in a SamsonCMS bootstrap, but can be easily changed by custom or modified once, the only limitation that must be met is template structure and its events, as all SamsonCMS ecosystem is based on this structure and entities.

Template is using Font-Awesome for all icons.

Events

All structure blocks have Events(http://github.com/samsonphp/event), and all their filling and rendering should be done via this events.

Template structure

This base SamsonCMS template structure can be defined as next:

• Menu section
• Sub-menu section
• Container section

Template menu structure

Index view is located , menu item view is located

• • • Added if item is active
      • or (for .active element as it cannot be clicked)
      • For icons (do not use it if no icon is needed)
      • For item text (do not use it if no text is needed)

Template sub-menu structure

Index view is located , menu item view is located

• • • For showing/hiding sub-menu
    • You can use any inner item structure

Menu events

Menu created event -

This event fires before generic menu rendering process has started. Before menu started default template menu item would be automatically added:

• Main page item
• Go to site item So in your event you will already receive not an empty menu , this gives you ability to remove this default items or change them.

For rendering sub-menu section you need to fill in your event handler.

Menu rendered event -

This event fires when all menu inner items has been rendered into main container.

Menu event handler example

This is a modified old approach menu & sub-menu render integrated via new menu events

Template container structure

All elements inside container must be inside

Template container form structure

• Should be used for all forms
  • • Form row
    • • Form input field
      • Used instead of standard placeholder

Container events

Main page created event -

This event fires before main page rendering process has started.

Main page rendered event -

This event fires when main page has been rendered into main container.