terminal42 / contao-rootcontent
Allows creating root-page aware content in Contao
Fund package maintenance!
terminal42
Other
Installs: 4 503
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 7
Forks: 2
Open Issues: 0
Type:contao-bundle
Requires
- php: ^8.1
- contao/core-bundle: ^4.13 || ^5.0
Requires (Dev)
- contao/manager-plugin: ^2.0
- terminal42/contao-build-tools: dev-main
Conflicts
- contao/manager-plugin: <2.0 || >=3.0
README
The extension allows creating root-page aware content in Contao.
Installation
Choose the installation method that matches your workflow!
Installation via Contao Manager
Search for terminal42/contao-rootcontent
in the Contao Manager and add it
to your installation. Apply changes to update the packages.
Manual installation
Add a composer dependency for this bundle. Therefore, change in the project root and run the following:
composer require terminal42/contao-rootcontent
Depending on your environment, the command can differ, i.e. starting with
php composer.phar …
if you do not have composer installed globally.
Then, update the database via the contao:migrate
command or the Contao install tool.
Usage
There are multiple features to create root-page aware content.
Create articles in the root page
The extension allows to create articles in the root page. Here's how it works:
- Edit your theme and add custom content sections. Each theme can have multiple sections with root content.
- Add an article to a root page. Contrary to regular articles, you cannot enter a name but select one of the sections from your theme.
- Create a root-content module in your theme and select the section you want to output.
- Place the new module anywhere in your page layout.
Limit front end modules per root page
For each front end module, there is a new setting to limit it for one or multiple root pages. This way you can create language-aware modules. Simply place all of them in your page layout and only the respective ones will be rendered one at a time.
<body>
css class per root page
Add css classes to the root page and they will be inherited through all pages.