Subversion Repositories Applications.papyrus

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
831 florian 1
Creating your own Phorum template
2
=================================
3
 
4
This documents describes how to create your own template for
5
Phorum. The document is not conclusive, but there should be
6
enough information in here to get you started.
7
 
8
 
9
Here are the steps that you have to take to create your own template:
10
 
11
1) Take the default template directory from {phorum dir}/templates/default
12
   and copy it over to another directory, for example
13
   {phorum dir}/templates/mytemplate.
14
 
15
2) Edit {phorum dir}/templates/mytemplate/info.php. In this file you
16
   have to edit at least the $name variable, e.g. to
17
   $name = "My very own template";
18
 
19
   You can hide the template from the user's template selection box
20
   by setting $template_hide = 1. If you do this, you can only
21
   select this template through the admin interface (this makes
22
   most sense if you set the display-settings to fixed through
23
   the admin interface).
24
 
25
3) Open Phorum's admin page {phorum url}/admin.php and go to
26
   "General Settings". There you'll find the option "Default Template".
27
   Set that option to your own template. You can also set a specific
28
   template for each single forum in the forum's settings.
29
 
30
 
31
That's it. You are now using your own template. From here on you can start
32
tweaking the template files in your {phorum dir}/templates/mytemplate
33
directory. For most installations, the following template files will be
34
most interesting:
35
 
36
- header.tpl     The header which will be added before each page;
37
- footer.tpl     The footer which will be added after each page;
38
- settings.tpl   Here you can change colors and fonts;
39
- css.tpl        This file holds all CSS definitions for Phorum.
40
 
41
For more extended information on changing template files, please
42
visit our Wiki documentation site:
43
 
44
http://phorum.org/cgi-bin/trac.cgi/wiki/TemplatesDocs
45
 
46
 
47
 
48
TODO this should probably go to the wiki, becuase it's quite specific
49
for a getting started HOWTO...
50
 
51
Additional variables in settings.tpl:
52
{define bodies_in_list 1}
53
set this to 1 to have the message-bodies loaded in the list if your
54
template needs them.
55
 
56
{define all_bodies_in_threaded_read 0}
57
set this to 1 to have all the message-bodies also loaded in
58
threaded-read-view if your template needs them