When developing websites using Umbraco in multi-environment solution, you can often get confused which environment you are currently looking at.
As a visual aid, this package will add a colour-coded indicator in the CMS back-office - this is applied to both the favicon (in the browser tab/title-bar) and adds a stripe to your avatar (in the top-left navigation).
This package was developed and tested against Umbraco v7+ on the Umbraco Cloud platform.
The package can be installed from either Our Umbraco or NuGet package repositories, or build manually from the source-code:
To install from Our Umbraco, please download the package from:
http://our.umbraco.org/projects/backoffice-extensions/cms-environment-indicator
To install from NuGet, you can run the following command from within Visual Studio:
PM> Install-Package Our.Umbraco.CmsEnvironmentIndicator
If you prefer, you can compile the package yourself, you'll need:
- Visual Studio 2012 (or above)
To clone it locally click the "Clone in Windows" button above or run the following git commands.
git clone https://github.com/leekelleher/umbraco-environment-indicator.git umbraco-environment-indicator
cd umbraco-environment-indicator
.\build.cmd
If you want to modify the default colours, you can do this by editing the /App_Plugins/CmsEnvironmentIndicator/js/cms-environment-indicator.js
script. You'll find a JavaScript array called config
, there you can modify the existing colours and/or add new hostname/colour combinations. The hostnames are defined as Regular Expressions, so don't forget to escape any dots, etc.
For the majority of users this will be a "install and forget" package, but if you want to go further, here's the low down.
Anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing.
Have a question?
- CMS Environment Indicator Forum on Our Umbraco
- Raise an issue on GitHub
Top-most appreciation for contributions and pull-requests:
Copyright © 2014 Umbrella Inc, Our Umbraco and other contributors
Licensed under the MIT License