From the wizard's output to the first commit #

This page is for designers who just generated a theme with the design extension wizard. Follow it once, in order; at the end you have a theme that renders and a clean first commit.

Step by step #

1. Look at the tree:

   find extension/mytheme -type f | sort

   Compare with The design wizard's parts.

2. Check the PHP and XML files:

   php -l extension/mytheme/ezinfo.php
   xmllint --noout extension/mytheme/extension.xml

   Expected: No syntax errors detected and no output from xmllint.

3. Fix composer.json: check that extra has "ezpublish-legacy-extension-name": "mytheme" (written by the wizard from Exponential 6.0.15 on; add it to the output of an older wizard), set the PHP versions you test, add homepage, support and authors (composer.json for a theme). Check: composer validate extension/mytheme/composer.json.

   Make the three edits of the generated head and layout (the title, {ezcss_load()} and {ezscript_load()}, a plain <meta charset="utf-8" />) if the theme was generated by a wizard older than 6.0.15 (Three edits the generated head and layout need).

4. Switch it on for the installation and choose it for one test siteaccess (Activating a theme, The design settings a theme ships).

5. Make it visible:

   php bin/php/ezpgenerateautoloads.php -e
   php bin/php/ezcache.php --clear-all --allow-root-user

6. Open the test siteaccess in a browser. The page uses your pagelayout.tpl; with template debugging on, the path comments name files in extension/mytheme/design/mytheme/.

7. Read the README the wizard wrote and correct anything that is not true for your theme.

8. Commit:

   cd extension/mytheme
   git init -b main
   git add .
   git status --short
   git commit -m "Added: The mytheme theme extension"

   Read git status --short before committing: only the theme's files should be listed.

What usually needs changing next #

• The pagelayout's head: stylesheet and script loading (Loading stylesheets).
• The example override for article (Override basics).
• ezinfo.php and extension.xml: website and copyright.

Related pages #

• Putting a theme under Git
• Checklist: the theme extension is ready
• Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.