Environment Info

پهد

How do I describe my environments?

Define the constant ENVIRONMENT_INFO_SETTINGS in wp-config.php, with one entry per environment:

define( 'ENVIRONMENT_INFO_SETTINGS', [
    [ 'path' => '/var/www/staging', 'title' => 'Staging', 'background' => '#b45309', 'color' => 'white' ],
    [ 'hostname' => 'web-prod-1', 'title' => 'Production', 'background' => '#b91c1c', 'color' => 'white' ],
] );

Each entry needs a title and is recognised either by hostname, compared with the server’s host name, or by path, which matches when it appears anywhere in the plugin’s directory path. background and color take any CSS colour.

The admin bar says “Unknown Server”

Exactly one entry has to match. With none, or with more than one, the label reads “Unknown Server”; more than one match is also written to the error log. Tools > Environment Info lists every entry, marks the active one and shows the current host name and path, so you can see why nothing matched.

Who sees the label?

Every logged-in user who sees the admin bar. The overview under Tools > Environment Info requires the manage_options capability.