Clean Up Your Umbraco Dashboards
There was recently some controversy regarding Umbraco HQ’s decision to insert an advertisement into the dashboard that displays when you log in to Umbraco:
I don’t have a strong opinion on this, but I figured a few of you might want to avoid having this advertisement displayed to your clients. In fact, this seems to be the recommended approach:
Training can be valuable, but it’s probably not necessary in this case, as all you need to do is make a simple change to a single file. If you look in your Umbraco installation, you’ll find a file in ~/Config/Dashboard.config, which will contain some XML that looks like this:
This is the configuration that dictates which dashboards you see in which sections of Umbraco. For example, it is configured in my case to show the “Get Started” dashboard in the content section (note that there are other “Get Started” dashboards in other sections too):
Comment Out the Config
In order to get rid of that section, I simply commented out the relevant portion of my Dashboard.config, as shown in green in this screenshot:
When I refresh the back office, I now see this:
Much better. Now when I log in, not only do I see a nice clean interface, but the back office loads faster so I don’t have to wait as long after log in to get to work. Of course, this means your clients will also see a nice clean interface when they log in.
Add a Custom Dashboard
If you want to go a step further, you can create your own dashboard. First, create a file at ~/App_Plugins/CustomDashboard/welcome.html (you’ll have to create the “CustomDashboard” folder too, which can be named anything you like) that contains this HTML (or any HTML, really):
Next, add the highlighted text from below to your Dashboard.config (right after the section you commented out):
I find it’s easiest to simply copy an existing <tab> element and edit as necessary. If you refresh the back office, you should see your new dashboard:
Now you’ll never have to worry about an update to Umbraco’s built-in dashboards creating an uncomfortable situation for you ever again. You might even consider adding a bit of custom documentation to this dashboard tailored to your client, in which case they’ll appreciate you even more.
Comment with Caution
One final gotcha worth mentioning is that you should be careful not to comment out things you may need, such as the redirect URL management dashboard. Of course, if you don’t need the redirect dashboard, then feel free to comment it out too.