This part of the 4.x documentation is for eZ Publish 4.0, only reference section is common for all eZ Publish 4.x versions as well as eZ Publish 5.x "LegacyStack", please select the version you are using for the most up to date documentation! |
This section explains the concept of designs and how eZ Publish handles different designs. As mentioned in the beginning of this chapter, design is all about the way actual content is marked up and visually presented. When talking about a design, we're talking about the things that make up a web interface: HTML, style sheets, images that are not a part of the content, etc. All files that are related to appearance reside in the "design" directory. An eZ Publish installation is capable of handling a virtually unlimited number of designs. Each design has its own dedicated sub-directory within the main design directory. The name of a sub-directory also functions as the actual name of a design. A typical eZ Publish design consists of the following components:
Among other things, a siteaccess dictates which design that should be used. By making use of different siteaccesses, it is possible to combine different content and designs. A typical eZ publish site consists of two siteaccesses: a public interface for visitors and a restricted interface for administrators. Both siteaccesses use the same content (database and var directory) but they use different designs. In particular, the administration siteaccess would most likely use the built in administration design. The public siteaccess would use a custom design.
An eZ Publish distribution comes with at least two default designs:
The "admin" directory contains all design related files that make up the built in administration interface. The "standard" directory contains a set of standard/default design related files such as the default/standard templates, images, etc. The contents of these directories should not be tampered with. Instead, custom designs should be used (if/when necessary). A custom design can be added by creating a new subdirectory within the main "/design" directory.
All files that belong to a specific design are located inside the directory of that design. The name of the directory also functions as the name for the design itself. An eZ Publish design directory typically contains the following sub-directories:
Subdirectory | Description |
---|---|
fonts |
Font files used by the "texttoimage" template operator which is capable of visualizing text using truetype fonts. |
images |
Non-content specific images (banners, logos, graphical layout elements, etc.). |
override |
Custom templates that will be used by instead of the default/standard templates. These files will be triggered by template override rules that are specified in a configuration override for "override.ini". Please refer to "The template override system" section of the "Templates" chapter for more information about this feature. |
stylesheets |
CSS files. |
templates |
Main template(s) (for example the pagelayout, header, footer, etc.) and custom templates that will be used instead of the standard/default templates. |