Nibble

/Config/Dashboard.config

Just posted this on the forum and I thought I could do a quick post about the umbraco dashboard.config file.

When you log in the the umbraco backend or when you enter a section, the right side of the umbrao backend will be empty

image

You can fill up these ‘dashboards’ with tab pages that contain usercontrols.

How do you do this ? You will have to edit the /config/dashboard.config file.

Default the dashboard.config file looks like this:

<?xml version=”1.0″ encoding=”utf-8″ ?> 
<dashBoard>
<!–
    <section>
    <areas>
        <area>default</area>
        <area>content</area>
    </areas>
    <tab caption=”Last Edits”>
        <control>/usercontrols/dashboard/latestEdits.ascx</control>
    </tab>
    <tab caption=”Latest Items”>
        <control>/usercontrols/dashboard/newestItems.ascx</control>
    </tab>
    <tab caption=”Create blog post”>
        <control>/usercontrols/umbracoBlog/dashboardBlogPostCreate.ascx</control>
    </tab>
</section>
–>
</dashBoard>

 

So to add a usercontrol to th content area we should add this:

<?xml version=”1.0″ encoding=”utf-8″ ?> 
<dashBoard>
 
    <section>
    <areas>
        <area>content</area>
    </areas>
 
    <tab caption=”Last Edits”>
        <control>/usercontrols/mycustomusercontrol.ascx</control>
    </tab>
 
</section>
</dashBoard>

4 Comments so far

  1. Darren Ferguson on May 29th, 2008

    Ouch, your XML syntax highlighter is painful!! :)
    I am sure that 2.x used to show me my most recently edited/added docs in the dashboard, but I can’t seem to find it in 3.x.

  2. David Conlisk on January 11th, 2009

    Hi Tim,

    I was just wondering if it’s possible to add permissions to the dashboard.config? For example, if you have a create blog link there that you only want your content managers to see, but not your translators (or whatever)?

    Cheers,

    David

  3. Tim Geyssens on January 11th, 2009

    @David,

    Nope that isn’t possible currently. If the user has access to the section it will see that tabs and controls that are defined for that dashboard section.

  4. Andrew on March 24th, 2011

    Dude, you xml is unreadable.

Leave a Reply