Please upgrade here. These earlier versions are no longer being updated and have security issues.
HackerOne users: Testing against this community violates our program's Terms of Service and will result in your bounty being denied.
Options

I would like to create an Admin theme

xm1xm1 New
edited December 2015 in Vanilla 2.0 - 2.8

Is it possible to change the default admin theme in vanilla? If yes, I need a basic guide on how to create an admin theme. Please.

Comments

  • Options
    hgtonighthgtonight ∞ · New Moderator

    Yes.

    Place a file called admin.css in your theme's design folder and it should be loaded automatically in the dashboard.

    Don't have a custom theme yet? Copy the folder /themes/default and rename it. Then edit the /themes/yourtheme/about.php file. You need to place the folder name (case-sensitive) as the key in the info array. I.e. `$ThemeInfo['yourThemeFolderName']. Everything else in the info array is informational at this point.

    Search first

    Check out the Documentation! We are always looking for new content and pull requests.

    Click on insightful, awesome, and funny reactions to thank community volunteers for their valuable posts.

  • Options

    Thanks @hgtonight
    Can I also override admin views? How?

  • Options
    hgtonighthgtonight ∞ · New Moderator

    Exact same process as a front end view. Find the view file you want to override, copy it in to your theme folder, and change it.

    E.g. to override the applications settings view. Copy /applications/dashboard/views/settings/applications.php to /themes/yourtheme/views/settings/applications.php. Edit the newly copied file and the framework should load that instead.

    Search first

    Check out the Documentation! We are always looking for new content and pull requests.

    Click on insightful, awesome, and funny reactions to thank community volunteers for their valuable posts.

  • Options

    Great! Thanks @hgtonight

  • Options
    hgtonighthgtonight ∞ · New Moderator

    @xm1 Just a word of caution. Many plugins rely on specific classes or markup existing to work properly. Only override views if absolutely necessary and be prepared to do integration work with plugins that don't seem to work.

    Search first

    Check out the Documentation! We are always looking for new content and pull requests.

    Click on insightful, awesome, and funny reactions to thank community volunteers for their valuable posts.

  • Options

    Noted. Thanks agian @hgtonight

  • Options
    LincLinc Detroit Admin

    Other thing to know is: The Dashboard is about to get redone from scratch in 2.3 for spring which is absolutely going to break any existing admin themes. This is an incredibly inopportune moment to do this.

  • Options
    xm1xm1 New
    edited December 2015

    @Linc I'll be ready to rework my admin theme when the time comes.

  • Options

    View override really should be avoided. I spend a lot of time stripping themes of view overrides for clients as the make updating problematic.

    Dashboard is an area few people see so admin themes aren't really something people consider important.

    grep is your friend.

  • Options
    hgtonighthgtonight ∞ · New Moderator

    @x00 said:

    Dashboard is an area few people see so admin themes aren't really something people consider important.

    I would like this to change. At the very least, a simple color change to go along with the frontend theme would make administration a lot less jarring.

    Search first

    Check out the Documentation! We are always looking for new content and pull requests.

    Click on insightful, awesome, and funny reactions to thank community volunteers for their valuable posts.

  • Options

    you could do away with an admin style altogether, only if it gets totally messed up, it is nice having something you can actually use.

    grep is your friend.

  • Options
    vrijvlindervrijvlinder Papillon-Sauvage MVP

    I created several admin themes to match my main theme. Vanilla Grape and Yellow have one. I recommend you use customadmin.css instead of admin.css to name the file and then put it in your theme design folder.

Sign In or Register to comment.