source: trunk/CUSTOMISATION @ 930

Last change on this file since 930 was 930, checked in by kake, 15 years ago

Allow Guide admins to control the content of autocreated nodes (#47).

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.2 KB
Line 
1It is not recommended that you amend the supplied templates - they
2contain logic and therefore can have bugs, they may have new features
3added in the future and so on.
4
5From OpenGuides 0.41, some of the supplied templates will optionally
6call out to other template fragments that you can put in a custom template
7path (by default custom-templates/). If custom templates do not exist then
8sensible default wording will be used instead.
9
10The names of all custom templates will be prefixed with custom_.
11
12The custom templates currently supported are:
13
14 - custom_licence.tt
15   Will be included at the top of the page editing form.
16
17 - custom_footer_credits.tt
18   Will be included in a <div id="footer"> at the base of every page.
19   You may wish to take advantage of the supplied TT variables
20     - [% delete_link %]
21       Will supply a link to delete the page, if and only if your
22       wiki.conf has deletion turned on.
23     - [% openguides_version %]
24       Contains the version of OpenGuides that your site is running on.
25
26 - custom_banner.tt
27   Will be included in a <div id="banner"> at the top of every page.
28   You may wish to take advantage of the supplied TT variables
29    - [% site_name %]
30      Contains the value supplied in wiki.conf as the name of the site.
31
32 - custom_node.tt
33   Will be included just below the main wiki content in node.tt.
34
35 - custom_autocreate_content.tt
36   You can control the text that gets put into the content field of any
37   autocreated category/locale nodes by putting it in this template.
38   The following TT variables will be available to the template:
39     - [% index_type %]
40       e.g. "Category" - note that the first letter is capitalised
41     - [% index_value %]
42       e.g. "Vegan-friendly" - capitalisation just as typed in the edit form
43     - [% node_name %]
44       e.g. "Category Vegan-Friendly" - the full, "official" name of the
45       autocreated node
46
47Requests for further custom inserts are welcomed.
48
49If you include your own versions of other (non custom_) templates in
50custom-templates they will override the installed files, and this may
51cause you problems. We would much rather that you let us know what we could
52do to make your customisations possible within custom_ templates.
Note: See TracBrowser for help on using the repository browser.