README

Nice coloured labels to help distinguish your CraftCMS environments ...so you don't forget where you are.

by Tom Davies and Michael Rog

TL;DR.

The Environment Label plugin adds a nice coloured banner to your CraftCMS control panel so you'll never forget what environment you're using.

The colors and text of the environment label are configurable via the plugin config file using config files.

Installation

Drop the environmentlabel directory into craft/plugins, visit the Settings page of the CP, and click to Install the Environment Variable plugin.

Config

You can configure the colour and text of the environment label using the plugin config file.

Just add an environmentlabel.php file to your craft/config directory, and copy in the default plugin config:

<?php

return array(

	'showLabel' => true,
	'label' => CRAFT_ENVIRONMENT,
	'prefix' => null,
	'suffix' => null,
	'labelColor' => '#cc5643',
	'textColor' => '#ffffff',

);

By default, the environment label will pull in the value of Craft's CRAFT_ENVIRONMENT constant, which is set to the current hostname unless you override it.

(In other words, out of the box, you get a red banner with white text that alerts you to the current hostname.)

The plugin config can use Craft's Multi-Environment Config syntax, which allows you to tweak the appearance and text of the environment label for each installation.

For example, your environmentlabel.php config file might use environment variables set by the server:

<?php

return array(

	'*' => array(
		'label' => getenv('CRAFT_ENV_LABEL'),
		'suffix' => " // NO LIVE CONTENT",
	),

	'myProductionDomain.com' => array(
		'showLabel' => false,
	),

	'.dev' => array(
		'labelColor' => '#337799',
	)

);

(We highly recommend using dotenv to store and deploy environment variables on your server. It'll change your life.)

Template globals

Environment Label also makes its data available via a Twig template global variable:

{{ environmentLabel.label }}
{{ environmentLabel.prefix }}
{{ environmentLabel.suffix }}
{{ environmentLabel.fullText }}
{{ environmentLabel.labelColor }}
{{ environmentLabel.textColor }}

JavaScript globals

Environment Label makes its label and full text available as JS globals on each authenticated CP page:

window.CRAFT_ENVIRONMENT
window.CRAFT_ENVIRONMENT_LABEL

What are the system requirements?

Craft 2.5+ and PHP 5.4+

I found a bug.

Please open a GitHub Issue, submit a PR to the dev branch, or just email Tom.

Contributors:

• Plugin development: Michael Rog / @michaelrog
• Plugin development: Tom Davies / @metadaptive
• Icon: NAS, via The Noun Project