Path
ez.no / ezpublish / documentation / incoming / design / siteaccess configuration
Siteaccess configuration
These documentation pages are no longer maintained. Please visit the new documentation site.
The different designs to be used for a siteaccess must be defined within the "[DesignSettings]" block in the siteaccess' "site.ini.append" file. The following settings can be used:
- SiteDesign
- AdditionalSiteDesignList
- StandardDesign
The "SiteDesign" setting is used to specify the main design for the siteaccess. The "AdditionalSiteDesignList" setting can be used to specify a collection of additional site designs. The "StandardDesign" setting is used to specify the standard design. Even though it is possible to change the standard fallback design, it is not a good idea to do so. The standard design should always be "standard". If there is a need for a custom standard/fallback design, it should be specified using the "AdditionalSiteDesignList" setting.
Keep in mind that the "site.ini.append" file that belongs to a siteaccess is simply appended to the main/default "site.ini" file. The default "site.ini" file already contains a "SiteDesign" and a "StandardDesign" setting. This means that if the "site.ini.append" file doesn't contain a design setting, the default settings will be used.
Example
The following configuration example shows how to specify the following design settings for a siteaccess:
- "my_design" as the main design
- "fallback_one" as the first additional design
- "fallback_two" as the second additional design
- "standard" as the standard fallback design
[DesignSettings] SiteDesign=my_design AdditionalSiteDesignList[]=fallback_one AdditionalSiteDesignList[]=fallback_two StandardDesign=standard
In this particular case, if eZ publish is unable to find the requested file within the main design (my_design), it will automatically fallback to the additional designs. At first, the system will look for the requested file within the "fallback_one" design directory. If the requested file is not found, the system will look in the "fallback_two" design directory. If the file still hasn't been found, the system will attempt to locate it within the "standard" design directory.
Comments