Extension configuration

Go to Admin Tools > Settings > Extension Configuration
Choose typo3_environment_indicator

The extension currently provides the following configuration options:

General

general.imageDriver

Type: option
Default: "gd"

Intervention Image supports "GD Library", "Imagick" and "libvips" to process images internally. You may choose one of them according to your PHP configuration. Options are "gd", "imagick" and "vips".

general.defaultConfiguration

Type: boolean
Default: 1

Enable the default configuration for the environment indicators. If you want to configure the environment indicators by yourself, set this to false. See Configuration.

Frontend

frontend.favicon

Type: boolean
Default: 1

Enable the favicon generation in frontend context

frontend.context

Type: boolean
Default: 1

Enable the context frontend hint

frontend.image

Type: boolean
Default: 1

Enable the image generation in frontend context

frontend.pageTitle

Type: boolean
Default: 1

Enable the page title prefix/suffix in frontend context. When the Page Title indicator is active, the final rendered <title> is decorated.

frontend.header

Type: boolean
Default: 1

Enable the environment HTTP response header in frontend context. When the Frontend HTTP Header indicator is active, the configured header is added to frontend responses.

frontend.robots

Type: boolean
Default: 1

Enable the X-Robots-Tag response header in frontend context. This is a kill switch only — the Frontend Robots indicator is never part of the default configuration and has to be registered explicitly, so nothing is sent to crawlers unless you asked for it.

frontend.console

Type: boolean
Default: 1

Enable the environment badge in the browser console for the frontend. When the Console indicator is active, a styled badge is printed to the console on every frontend page load.

Backend

backend.favicon

Type: boolean
Default: 1

Enable the favicon generation in backend context

backend.logo

Type: boolean
Default: 1

Enable the logo generation in backend context

backend.context

Type: boolean
Default: 1

Enable the context item within the backend toolbar

backend.contextProduction

Type: boolean
Default: 1

Enable the backend toolbar item / backend topbar also in production context

backend.theme

Type: boolean
Default: 0

Enable the backend theme modification (TYPO3 v14+ only, experimental). When the Backend theme indicator is active, this colors the entire backend based on the environment. Disabled by default because the underlying TYPO3 backend CSS framework is currently considered internal API.

backend.login

Type: boolean
Default: 1

Enable the environment badge on the backend login screen. When the Backend Login indicator is active, a colored badge is shown on the login screen.

backend.console

Type: boolean
Default: 1

Enable the environment badge in the browser console for the backend. When the Console indicator is active, a styled badge is printed to the console on every backend page load.

backend.pageTitle

Type: boolean
Default: 1

Enable the page title prefix/suffix in backend context. When the Page Title indicator is active, the backend document title is decorated client-side.

CLI

cli.banner

Type: boolean
Default: 0

Enable the CLI banner (opt-in, disabled by default). When the CLI Banner indicator is active, a colored environment banner is printed to stderr before console commands run in an interactive terminal.

Mail

mail.subject

Type: boolean
Default: 1

Enable the mail subject prefix for outgoing mails. When the Mail Subject Prefix indicator is active, the environment prefix is prepended to the subject of every mail sent via the TYPO3 Mailer API.

Instance

The instance settings allow overriding the appearance of all active indicators for a single installation — directly from the backend, without any PHP configuration. They are stored in the extension configuration of the respective installation, so two systems sharing the same code base and application context (e.g. two testing systems) can be distinguished from each other.

Instance settings take precedence over the built-in presets and any programmatically registered configuration. Which indicators are active remains trigger-driven: on a system where no indicator resolves (e.g. production with default configuration), the instance settings have no effect.

instance.label

Type: string
Default: (empty)

Overrides the indicator text of all active indicators for this installation (e.g. "TEST 1"). Replaces the text of the backend toolbar item, dashboard widget and console badge and renders the label onto the favicon and backend logo. Leave empty to use the context defaults.

instance.color

Type: color
Default: (empty)

Overrides the indicator color of all active indicators for this installation (frontend hint, console badge, backend toolbar, topbar, dashboard widget, backend theme and — combined with a label — favicon/logo). Leave empty to use the context defaults.