Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

The design wizard's parts, one by one

Reference of every part the design extension wizard can write - the files each produces, whether it is on by default, and what to change in the result.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/designers/extensions/design-wizard-parts-reference.md

On this page

The design wizard's parts, one by one

This page is a reference for the What goes in it list of the design extension wizard. <name> is the extension name you entered; the design folder has the same name. The facts below are read from the wizard's code (kernel/setup/expdesignextensionwizard.php).

Design parts

PartDefaultWritesNotes
Page layoutondesign/<name>/templates/pagelayout.tplThe frame every page is drawn inside; sets <html lang> from the siteaccess locale
Page partsonpage_head.tpl, page_header.tpl, page_footer.tpl in design/<name>/templates/So each can be overridden on its own
Stylesheetsondesign/<name>/stylesheets/site.css and FrontendCSSFileList[]=site.css in settings/design.ini.append.phpThe generated page_head.tpl prints the list with ezcss_load
Print stylesheetoffdesign/<name>/stylesheets/print.cssLoaded by page_head.tpl with media="print"
JavaScriptondesign/<name>/javascript/site.js and FrontendJavaScriptList[]=site.jsThe generated pagelayout.tpl prints the list with ezscript_load before </body>
Images directoryondesign/<name>/images/.gitkeepWhere ezimage looks
Template overridesonsettings/override.ini.append.php with one rule, and design/<name>/override/templates/full/article.tplThe example rule replaces node/view/full.tpl for the class article

Three edits the generated head and layout need

From Exponential 6.0.15 on, the wizard writes a working title, prints the stylesheets and scripts and writes a plain character set, so a theme it generates needs none of these edits. A theme generated by an older wizard needs three edits by hand, or its pages have a broken title and load no stylesheets or scripts:

  1. The title. page_head.tpl builds <title> with implode_key, which is not a registered template operator. Build it with a loop over the path instead:

    <title>{foreach $module_result.path|reverse as $item}{$item.text|wash}{delimiter} / {/delimiter}{/foreach} - {ezini( 'SiteSettings', 'SiteName' )|wash}</title>
  2. Printing the files. The generated templates call ezcss_require and ezscript_require, which only collect files; nothing prints them. Add {ezcss_load()} at the end of page_head.tpl and {ezscript_load()} just before </body> in pagelayout.tpl (The ezcss and ezscript operators).

  3. The character set. Replace the generated <meta charset=...> line, which builds utf-8 from the locale with extract_left( 0 ) and works only by accident, with a plain <meta charset="utf-8" />.

Check the result: open a page of the siteaccess, view its source, and look for the page title, a <link rel="stylesheet"> for your stylesheet and a <script> element for jQuery.

settings/design.ini marks CSSFileList[] and JavaScriptList[] as deprecated in favor of FrontendCSSFileList[] and FrontendJavaScriptList[]. From 6.0.15 on the wizard writes the newer lists, and the generated page_head.tpl and pagelayout.tpl load both, as the shipped designs do. A theme generated by an older wizard has CSSFileList[]=site.css and JavaScriptList[]=site.js: rename the two lines to FrontendCSSFileList[] and FrontendJavaScriptList[], and make sure the head and the layout load the Frontend lists (Loading stylesheets, Loading JavaScript).

Settings parts

PartDefaultWrites
Siteaccess settingsoffsettings/siteaccess/<siteaccess>/site.ini.append.php with SiteDesign=<name> and AdditionalSiteDesignList[]=<base design>
Template operatorsoffautoloads/<name>operators.php (class <name>Operators, example operator <name>_excerpt), autoloads/eztemplateautoload.php that registers it, and settings/site.ini.append.php with ExtensionAutoloadPath[]=<name>

From 6.0.15 on the template operators part also writes autoloads/eztemplateautoload.php, the file the template engine reads to register operators. A theme generated by an older wizard lacks it, and its operator is never registered: add the file yourself (Template operators in a theme).

Metadata and repository parts

PartDefaultWrites
ezinfo.phponezinfo.php (ezinfo.php)
extension.xmlonextension.xml (extension.xml)
composer.jsononcomposer.json with name = <vendor>/<name with dashes>, type = ezpublish-legacy-extension, license, require.php = >=7.4, extra.ezpublish-legacy-extension-name and extra.installer-name = <name>
README.mdonWhat it is, how to switch it on, what is inside
.gitignoreonKeeps editor leftovers and build output out of the repository
LICENSEonThe text of the license you chose

Raise require.php in composer.json to the PHP versions you really test. From 6.0.15 on the wizard writes extra.ezpublish-legacy-extension-name, the key the installer reads, so the package installs into extension/<name>. A composer.json from an older wizard has only installer-name, which the installer does not read: add "ezpublish-legacy-extension-name": "<name>" to extra (The Composer installer and the folder name).

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x