konradmichalik/typo3-environment-indicator

TYPO3 extension with several features to show an environment indicator in the TYPO3 frontend and backend.

2.0.0 2025-04-09 14:03 UTC

README

Extension icon

TYPO3 extension typo3_environment_indicator

Latest Stable Version Supported TYPO3 versions License

This extension provides several features to show an environment indicator in the TYPO3 frontend and backend.

Preview Feature Frontend Backend
Frontend Hint Preview Frontend hint

Adds an informative hint to the frontend showing the website title and the current application context.
✔️
Backend Toolbar Item Preview Backend toolbar item

Adds an informative item with the current application context to the backend toolbar.
✔️
Backend Topbar Preview Backend topbar

Colorize the backend header topbar regarding the application context.
✔️
Favicon Preview Modified favicon

Modify the favicon for frontend and backend based on the original favicon, the current application context and your configuration.
✔️ ✔️
Backend Logo Preview Modified backend logo

Modify the backend logo based on the original logo, the current application context and your configuration.
✔️
Dashboard Widget Preview Dashboard widget

Render a dashboard widget according to the environment.
✔️
Frontend Image Preview Modified frontend image

Modify frontend image based on the original image, the current application context and your configuration.
✔️

Note

These environment indicators are mainly for development purposes (e.g. distinguishing between different test systems) and will not show in production environments.

Requirements

  • TYPO3 >= 11.5 & PHP 8.1+

Installation

Composer

Packagist Packagist Downloads

Use the following composer command to install the extension:

composer require konradmichalik/typo3-environment-indicator

TER

TER version TER downloads

Download the zip file from TYPO3 extension repository (TER).

Documentation

Please have a look at the official extension documentation.

Migration from version 1.x to 2.x

Since version 2.x, the extension is using the new Handler::addIndicator method to add the environment indicator configuration instead of the old ConfigurationUtility::configByContext method.

Development

Use the following ddev command to easily install all supported TYPO3 versions for locale development.

ddev install all

Use the context command to easily change the application context in all supported TYPO3 versions.

Credits

This project is partly inspired by the laravel-favicon package.

License

This project is licensed under GNU General Public License 2.0 (or later).