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

require and suggest: what a theme depends on

Decide what goes into require and what into suggest in a theme's composer.json - PHP versions, the installer plugin, layouts or site API extensions - with the real choices of sevenx_themes_media and ezwebin, and version…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/designers/extensions/composer-require-and-suggest.md

On this page

require and suggest: what a theme depends on

This page is for designers deciding what their theme's composer.json should pull in.

The rule of thumb

Put it in require whenPut it in suggest when
The theme fails without it (a fatal error, a blank page)The theme works, but a feature is missing without it
It is the installer plugin that places the themeIt is content or data the user may already have
It is the PHP version range you testIt is an alternative the user may prefer

Real choices

  • sevenx_themes_media requires only PHP (^8.0 || ^8.1 || ^8.2 || ^8.3 || ^8.4) and suggests se7enxweb/explayouts (renders the layout structure its templates are written for), se7enxweb/expsite-data-media (the content model and data it renders) and se7enxweb/expsite-api.
  • ezwebin requires se7enxweb/ezpublish-legacy-installer and se7enxweb/expui, and suggests three smaller extensions with a ~5.3 constraint.

Both are reasonable: the media theme leaves the choice of data to the site; ezwebin cannot draw without expui.

Version constraints

ConstraintAllowsUse for
^1.2>=1.2.0 <2.0.0Libraries that follow semantic versioning
~1.2.3>=1.2.3 <1.3.0Packages that only add fixes in the last position
~0.0.4.9>=0.0.4.9 <0.0.5.0 (so 0.0.4.10 is included)Four-position versions where only the last moves
*anythingOnly for the installer plugin, if at all

The tilde floats the last position given, so a series that counts .9, .10, .11 stays inside it (After .9 comes .10).

Step by step

  1. List what your templates and operators call that is not in the kernel.
  2. Sort each into require or suggest with the table above. A suggest entry's text says what it adds.
  3. Write the narrowest PHP range you actually test.
  4. Run composer validate and install the theme into a clean test installation to see that require is enough.
  5. In extension.xml, declare the extensions you override or rely on for the loading order (Declaring dependencies).

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