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.

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.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 and dashboard widget 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, backend toolbar, topbar, dashboard widget, backend theme and — combined with a label — favicon/logo). Leave empty to use the context defaults.