Exponential / Download / Themes

Themes (Design Extensions)

Themes give an Exponential website its look. Exponential 6.0.15 ships ready-made designs, led by the modern, responsive media design with light and dark modes and pages built with Exponential Layouts. This page shows the themes that ship, how to see them live, where to find more, how to install one with Composer, how to make your own on top of an existing design, and where to get help.

On this page

Section What you find there
What a theme is A design inside an extension, and why that matters
The themes that ship Media, Simple, Starter and the classic designs, with their packages
See them live The public demo, with screenshots
Where to find more themes Exponential Projects, the Extensions directory, GitHub
Install a theme with Composer Require, activate, choose the design, clear the caches
Make your own theme The design cascade, overrides and the design extension wizard
Share your theme Publish it for others and show your work
Get help and support Documentation, community, and paid design work from 7x

What a theme is

In Exponential a theme is a design: a folder of templates, stylesheets, images, fonts and scripts. A theme is shipped inside an extension, which can also bring the settings, image sizes, override rules, translations and content classes the design needs. That makes a theme a Composer package like any other extension: one command installs it, and it can be switched on for the whole installation or for one site only.

Themes do not copy each other. Each siteaccess lists its designs in order, and Exponential takes every template from the first design that has it. A new theme can therefore change only the templates it cares about and leave everything else to the design below it.

The themes that ship with Exponential

Theme Composer package In one line Read more
7x Themes: Media (design media) se7enxweb/sevenx-themes-media The modern media-site look of a new 6.0.15 multisite installation: about 440 templates, block templates for the layouts editor, self-hosted fonts, packed CSS and JavaScript, light, dark and darker modes Repository, Tour
7x Simple (design simple) se7enxweb/sevenx_themes_simple The light, responsive public design of the simpler site packages, built on the ezwebin classes, with a responsive header and menus Repository, Tour
CJW Starter (designs starter, standard) se7enxweb/cjw_themes_jumper A starter look drawn with layouts, with its own image sizes Repository, Tour
Website Interface (design ezwebin) se7enxweb/ezwebin The classic website design and its content classes, still the base that Media and Simple build on Repository, As a base
Demo and Flow (designs ezdemo, ezflow) se7enxweb/ezdemo, se7enxweb/ezflow The classic demo website design, and the classic page builder with its zones and blocks ezdemo, ezflow

The administration has designs of its own as well: admin4, the current administration with design tokens, shared components and dark mode; admin4l, an administration page assembled from layouts; the editor portal; and Exponential Admin UI (exp_adminui), a second look for the whole administration. The full map, with the siteaccesses that use each design, is The themes that ship with Exponential.

See them live

The public demo runs the media design on a complete magazine site, "Fit & Healthy", with articles, recipes, videos and a tour. A second siteaccess of the same installation, Bold Agency, shows the same design on a business site with different content. Use the contrast button in the header to switch between light and dark.

The front page of the Fit and Healthy demo in the media design: featured articles on a full-width band, the main menu and the light and dark switch in the header.

A section page in the media design: a large heading band and recipe cards with cooking time and calories, all built from the site's content classes.

The Bold Agency siteaccess of the demo installation: the same media design with other content, a full-width hero image and two calls to action.

Where to find more themes

Where What you find
Exponential Projects The community's project forge, with design extensions among its project types (Design Extension), a news page and a search: try theme. Each project has its downloads, forum, gallery and Git source.
Exponential Extensions directory Maintained extensions with a Design category and a composer require line, ready to copy
github.com/se7enxweb The source of every 7x theme and of the classic designs, with issues and releases
Share Exponential: Setup and design forum Designs shared by the community, and the place to ask about templates and styling

Many designs on Exponential Projects were written for older releases. They are good sources of ideas and templates; check the versions they were written for before you install one, and see Exponential Software (Extensions) for all the places to look.

Install a theme with Composer

A theme installs like any extension. Run the commands in the root of your installation.

  1. Require the package. It lands in extension/<name>.
  2. Activate the extension under Setup > Extensions in the administration (Activate, Review changes, Apply changes), or with the console. Use ActiveExtensions[] for the whole installation, ActiveAccessExtensions[] for one siteaccess.
  3. Choose the design for a siteaccess: SiteDesign and AdditionalSiteDesignList[] in [DesignSettings] of its site.ini.
  4. Refresh the class maps and clear the caches, then reload PHP-FPM or Exponential Velocity.
composer require se7enxweb/sevenx-themes-media
./console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' sevenx_themes_media global --dry-run --allow-root-user
./console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' sevenx_themes_media global --allow-root-user
php bin/php/ezpgenerateautoloads.php -e
php bin/php/ezcache.php --clear-all --allow-root-user

The first exp:ini command shows the change without writing it; the second writes it to settings/override/site.ini.append.php and keeps a backup. A site package installs and activates its theme for you, so a new installation with the multisite package opens in the media design right away. Step by step: Activating a theme and Themes are extensions.

Make your own theme

Build on a design, do not copy it

The design cascade decides which file wins. For every design of a siteaccess, in order (SiteDesign, then AdditionalSiteDesignList[], then standard), Exponential looks in each theme extension first and in the kernel after, and takes the first match. So your theme starts with one template or one stylesheet and grows from there, while the design below it keeps covering everything else, and an update of that design reaches your site without a merge.

Siteaccess Design chain on the demo installation
site media, ezwebin, standard, base
bold media, simple, ezwebin, standard, base

Read The design cascade for the exact order, a worked example and the caches involved.

Override one template for one kind of content

An override rule replaces a template under conditions: for one content class, one section, one node or one parent. This rule shows articles with your own full view template:

[mytheme_full_article]
Source=node/view/full.tpl
MatchFile=full/article.tpl
Subdir=templates
Match[class_identifier]=article
Priority=10

More: Override basics and the tutorial Override a full view. In the administration, the Template Editor of the Design tab lists every template of a siteaccess with the overrides that replace it, and opens each one in the template editor.

The Template Editor of the administration (Design tab): every template of a siteaccess, with the overrides that replace it. Click a template to see its overrides or to create a new one.

Start with the wizard

The design extension wizard under Setup > RAD writes a complete theme extension for you: the folder layout, the settings that register the design, a pagelayout to start from, composer.json, ezinfo.php and extension.xml. It shows every file before writing it, and can create the extension in extension/ or hand it to you as a zip file.

The design extension wizard (Setup > RAD): name the extension and the design, choose what to fall back to, read the preview of every file, then create it or download it as a zip file.

Where to go next:

Share your theme

A theme others can install shows your skills better than any portfolio. Put it in a GitHub repository with a composer.json, submit it to Packagist, list it on Exponential Projects and post screenshots on the Share Exponential forums. The documentation has the whole path, including licenses for code, images and fonts: Distributing a theme, composer.json for a theme and Listing a theme on projects.exponential.earth.

Themes are one kind of extension. See also Modules for new pages and features, and Plugins and extension points for datatypes, template operators and events.

Get help and support

Step Where When
1. Read the documentation doc.exponential.earth: the designers' guide, the template language, every shipped theme. The same help is built into the administration. First, always
2. Ask the community The Setup and design forum of Share Exponential, the Telegram support chat, and the forum of each project on Exponential Projects A design question the documentation does not answer
3. Paid design work from 7x Exponential support and the Exponential Support and Development Network: new website designs, custom solutions, performance optimization and long-term maintenance When you want a new design built for you
Page Views: 4201