konradmichalik/typo3-environment-indicator

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

3.0.0 2025-12-12 14:34 UTC

Requires

• php: ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• ext-filter: *
• intervention/image: ^3.7
• konradmichalik/php-ico-file-loader: ^0.2
• meyfa/php-svg: ^0.16
• psr/http-message: ^1.0 || ^2.0
• psr/http-server-handler: ^1.0
• psr/http-server-middleware: ^1.0
• symfony/expression-language: ^7.0 || ^8.0
• typo3/cms-backend: ^13.4 || ^14.0
• typo3/cms-core: ^13.4 || ^14.0
• typo3/cms-dashboard: ^13.4 || ^14.0
• typo3/cms-fluid: ^13.4 || ^14.0
• typo3fluid/fluid: ^4.2 || ^5.0

Requires (Dev)

• eliashaeussler/version-bumper: ^3.0
• helhum/typo3-console: ^7.0 || ^8.1
• phpunit/phpcov: ^10.0 || ^11.0
• phpunit/phpunit: ^11.0 || ^12.0
• typo3/cms-base-distribution: ^13.4 || ^14.0
• typo3/cms-lowlevel: ^13.4 || ^14.0

Suggests

• ext-gd: Required for image processing and rendering of SVG icons.
• ext-imagick: Required for image processing and rendering of SVG icons with Imagick support.
• intervention/image-driver-vips: Required for image processing and rendering of SVG icons with VIPS support.

GPL-2.0-or-later

• Konrad Michalik

README

TYPO3 extension typo3_environment_indicator

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

Note

Has it ever happened to you that you changed data on a test system and then realized: oh no, that's the live system. Well, to prevent that from happening (again), I created this extension.

✨ Features

Preview	Feature	Frontend	Backend
	Frontend hint Adds an informative hint to the frontend showing the website title and the current application context.	✔️
	Backend toolbar item Adds an informative item with the current application context to the backend toolbar.		✔️
	Backend topbar Colorize the backend header topbar regarding the application context.		✔️
	Modified favicon Modify the favicon for frontend and backend based on the original favicon, the current application context and your configuration.	✔️	✔️
	Modified backend logo Modify the backend logo based on the original logo, the current application context and your configuration.		✔️
	Dashboard widget Render a dashboard widget according to the environment.		✔️
	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.

🔥 Installation

Requirements

Version	TYPO3	PHP
3.x	13.4 - 14.x	8.2 - 8.5
2.x	11.5 - 13.4	8.1 - 8.4

Composer

Use the following composer command to install the extension:

composer require konradmichalik/typo3-environment-indicator

TER

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.

🧑‍💻 Contributing

Please have a look at CONTRIBUTING.md.

💎 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).