Layout Options

HTML Template

A Joomla! template basically understand different view-types. For example the index.php, component.php and error.php. Joomla! loads the corresponding file depending on case. By default Joomla! does load the index.php of the template. For popups in most cases the the parameter "tmpl=component" will be added on the URL, which is called the component.php.

In JYAML you can load for each view-type a special HTML-Template. These template files you can find in the directory /html/ of the template (e.g. /html/index/ or /html/component/). In the /html/index/ directory are already included several examples. So you can select for each Template-Style a different HTML-Template.

Following are brief descriptions of the contained 'index' templates for the productive usage:

  • default.php:
    Basic layout. Mostly used as a basis.
  • fullheight.php:
    The minimum height layout is adjusted independently of the content on the height of the viewport. I.e. the footer is always at the bottom, if the content is to short.
  • fullpage.php:
    Alternative to default.php. Here is used an another nesting order. For example to bring the background of the header and footer to the full width of the viewport, but keep the contents width.

Static Layout

By default JYAML is set to automatically detect whether the columns .ym-col1 and .yml-col2 must be displayed. This depends on whether a module is assigned to the appropriate module position. However, you can assign a static layout. If this is the case, the automatic detection of the columns is disabled. You can also disable/hide all columns (.ym-col1, .ym-col2 and ym-col3), when you don't need the main columns.

Column Ordering

You can set the optical column order for any number of columns. More detailed information at this topic, see the documentation for YAML "Column Ordering".

Count Empty Modules

If this option is set to "No" only modules are counted with content. And if is set to "Yes", also published modules with empty content are counted.

This function affects the automatic column detection and the function 'countModules' within the template files.

This option is also available in each module.
This is useful when Count Empty Modules is set to No, but a single module has no real content (e.g. pure Javascript) and therefore can not be counted.


[since JYAML 4.5.0]:
When enabled, the CSS screen.responsive.css will be loaded. This file includes standard CSS3 Media Queries and definitions for Responsive YAML templates. Of course, these must be adjusted specifically on your layout.


In JYAML a skin is just a additional CSS-File that is loaded in last position. So theoretically you can make any changes with a skin without adjust an existing CSS file.

You can add a skin-file if you create a file in the directory /css/ with the name skin.myownskin.css (myownskin is a placeholder for any name you want). After create the skin-file you can select it in the template configuration. As a starting example, you can take the already included skin.example.css.

Skins are especially useful, if you will deliver a customer template or a ready-designed template for example with several color schemes.

Logo Image and Slogan Text

Here you can easily select a logo image and define a slogan text.


[since JYAML 4.5.0]:
Here you can select a default Header-Image.

Additionally, the header image can be overwriten per menu item, category and articles and will be prioritized/inherited in that order.

Favicon Image

Here you can select a alternative Favicon image. If no image selected, the favicon.ico from the template root-directory will be used by Joomla!. You must upload the Favicon image before with the Joomla! Media Manager or with FTP in the /images/ directory. The image must have the file extension ".ico".