rev |
line source |
erjo@1
|
1 How to create a theme:
|
erjo@1
|
2
|
erjo@1
|
3 Part 1: CSS / Design
|
erjo@1
|
4 ================================================================================
|
erjo@1
|
5 1. Copy this "default" theme folder and rename it to your new theme name.
|
erjo@1
|
6 2. Open the "about.php" file and edit the information to reflect your theme. Be
|
erjo@1
|
7 sure to change the array key like this: $ThemeInfo['YourThemeNameHere'].
|
erjo@1
|
8 3. Create a "design" subfolder and copy /applications/dashboard/design/style.css
|
erjo@1
|
9 and /applications/vanilla/design/vanilla.css into it.
|
erjo@1
|
10 4. Any background images you want to continue using (like the star png images
|
erjo@1
|
11 for bookmarking) should be copied along with their respective stylesheets.
|
erjo@1
|
12 5. Go to your Dashboard, Themes, and apply your new theme.
|
erjo@1
|
13 6. Edit the copied CSS files to look however you wish!
|
erjo@1
|
14
|
erjo@1
|
15 Other things you should know:
|
erjo@1
|
16
|
erjo@1
|
17 + All non-forum pages should be edited in the global "style.css" file.
|
erjo@1
|
18
|
erjo@1
|
19 + If you want to edit the look & feel of the administrative screens, also
|
erjo@1
|
20 copy /applications/dashboard/design/admin.css in step 3. Similarly, you can
|
erjo@1
|
21 copy other CSS files like /applications/vanilla/design/vanillaprofile.css to
|
erjo@1
|
22 customize those pages as well.
|
erjo@1
|
23
|
erjo@1
|
24
|
erjo@1
|
25 Part 2: HTML / Views
|
erjo@1
|
26 ================================================================================
|
erjo@1
|
27 If you want to customize the HTML, you can edit that too.
|
erjo@1
|
28 Our pages are made up of two parts:
|
erjo@1
|
29
|
erjo@1
|
30 1. Master Views - these represent everything that wraps the main content of the
|
erjo@1
|
31 page. If all you want to do is add a menu or banner above Vanilla, this is
|
erjo@1
|
32 all you need to alter. To do so, copy the default master view from
|
erjo@1
|
33 /applications/dashboard/views/default.master.php to
|
erjo@1
|
34 /themes/yourtheme/views/default.master.php and edit it there.
|
erjo@1
|
35
|
erjo@1
|
36 2. Views - these represent all of the content in each page. Every application
|
erjo@1
|
37 has a "views" folder that contains all of the HTML for every page. So, for
|
erjo@1
|
38 example, if you wanted to edit the HTML for the Discussions list, you could
|
erjo@1
|
39 copy the views from /applications/vanilla/views/discussions to
|
erjo@1
|
40 /themes/yourtheme/views/discussions and edit them there.
|
erjo@1
|
41
|
erjo@1
|
42 You can avoid naming conflicts between applications' views and specify which
|
erjo@1
|
43 app a view is for by optionally adding a subfolder with the app's name in
|
erjo@1
|
44 /themes/yourtheme/views/ (e.g.: /themes/yourtheme/views/appname/) and placing
|
erjo@1
|
45 views there rather than directly in the "views" folder. |