Quickstart

Vanilla Forums Cloud Customers, check out our Ultimate Vanilla Forums Theme Guide.

With Vanilla, you have full control over both the CSS and the actual HTML of every page in every application. The easiest thing for most designers is to just alter the CSS, so we’ll start there:

Part 1: CSS & Design

  1. Copy the /themes/default folder and rename it to your theme name so it sits in the root theme folder like this: /themes/your_theme_name.
  2. Create an about.php file and edit the information to reflect your theme’s information.
  3. If you’ve got Vanilla Cloud, make sure to also set your theme’s visibility. If not, skip this step.
  4. Create a custom.css file in the “design” folder of your custom theme.
  5. Go to your Dashboard > Themes, and apply your new theme. If you don’t see it, delete the theme-index.php in the cache folder.
  6. Edit the custom.css file to your heart’s content!

Learn more by reading our docs on Theming with CSS

Other things you should know:

  • If you want to edit the look & feel of the administrative screens, you can accomplish it by creating an admincustom.css file in your design folder.

Part 2: Themehooks (optional)

Themes have the ability to tap into Vanilla’s event firing system and override functions using a special themehooks file. To use hooks, create a file named class.themehooks.php in your theme’s root directory (/themes/your_theme_name/class.themehooks.php) and edit it there.

This is a very powerful feature. Learn more about it by reading the Theming Hooks docs.

Part 3: HTML & Views (optional)

If you don’t like the way we’ve structured our HTML, you can edit that too. Our pages are made up of two parts:

  1. Master Views: These represent everything that wraps the main content of every page. If all you want to do is add a menu or banner above Vanilla, this is the only file you will need to alter. To do so, copy the default master view from /applications/dashboard/views/default.master.tpl to /themes/your_theme_name/views/default.master.tpl and edit it there. This master view is built on the Smarty template engine. Familiarize yourself with this special master view by reading on docs on Theming Views. Also check out our docs on Theming with Smarty.

  2. Views: These represent all of the content in each page. Every application has a “views” folder that contains all of the html for every page. So, for example, if you wanted to edit the html for the discussion list, you could copy the views from /applications/vanilla/views/discussions to /themes/your_theme_name/views/discussions and edit them there. There are some overriding and editing views. Be sure to check out our docs on Theming Views to learn more.

Other things you should know:

  • The administrative screens have their own master view. If you want to change their master view, copy the /applications/dashboard/views/admin.master.php file to /themes/your_theme_name/views/admin.master.php.
  • You can add a custom thumbnail by adding a png called “screenshot.png” in your theme root. 220px wide and 165px high is a good size.

Cloud Hosting

We believe that online communities should be intuitive, engaging and true to your brand. Vanilla allows you to create a customized community that rewards positive participation, automatically curates content and lets members drive moderation.

Learn More …