source: trunk/language/nl_NL/help/extend_for_templates.html @ 2439

Last change on this file since 2439 was 2439, checked in by vdigital, 16 years ago

"Extend for templates" needs translators.

  • Property svn:eol-style set to LF
  • Property svn:keywords set to Author Date Id Revision
File size: 4.4 KB
Line 
1<h2>Extend for templates configuration</h2>
2
3<h3>Goal</h3>
4<p>Define replacement conditions for each template from template-extension
5(template called "replacer").</p>
6
7<p>"original template" from ./template/yoga (or any other than yoga)
8 will be replaced by a "replacer" if the replacer is linked to this "original template"
9 (and optionally, when the requested URL contains an "optional URL keyword").</p>
10
11<p>"Optional URL keywords" are those you can find after the module name in URLs.</p>
12
13<p>Therefore "Optional URL keywords" can be an active "permalink"
14(see permalinks in our documentation for further explanation).</p>
15
16<p>Read: `<a href="#warnings">Warning</a>` usage conditions.</p>
17
18<h3>What are template extensions?</h3>
19
20<p>This configuration tool is powerfull for beginners and advanced users.
21By FTP, in the template-extension folder, the Webmaster can duplicate a lot of
22 the distributed .tpl files ("original template") with a different name
23 ("replacer").
24 
25 "Original templates", current original supported templates are:</p>
26<ul>
27  <li><span class="filename">index.tpl</span></li>
28  <li><span class="filename">mainpage_categories.tpl</span> and/or <span class="filename">thumbnails.tpl</span></li>
29  <li><span class="filename">menubar.tpl</span></li>
30  <li><span class="filename">header.tpl</span> and/or <span class="filename">footer.tpl</span></li>
31  <li><span class="filename">picture_content.tpl</span> and/or <span class="filename">picture.tpl</span></li>
32  <!-- <li><span class="filename">slideshow.tpl</span></li> -->
33  <li><span class="filename">profile.tpl</span> and/or <span class="filename">profile_content.tpl</span></li>
34  <li><span class="filename">tags.tpl</span></li>
35  <li><span class="filename">upload.tpl</span></li>
36  <li><span class="filename">about.tpl</span></li>
37  <li><span class="filename">popuphelp.tpl</span></li>
38  <li><span class="filename">search.tpl</span> and/or <span class="filename">search_rules.tpl</span></li>
39  <li><span class="filename">nbm.tpl</span> and/or <span class="filename">notification.tpl</span></li>
40  <li><span class="filename">identification.tpl</span> and/or <span class="filename">register.tpl</span></li>
41  <li><span class="filename">redirect.tpl</span></li>
42</ul>
43
44<h3>Where can I find "original templates"?</h3>
45
46<p>Distributed original templates are in template/yoga/
47(don't edit them in place for upgrade perspectives). So with "original templates",
48any webmaster can create his "replacers (customized templates)".</p>
49
50<h3>Where should I save "replacers"?</h3>
51
52<p><strong>Replacers (customized templates)</strong> must be placed in the
53template-extension folder (or its subfolders).
54Replacers can have any filename with the .tpl extension. For example: <span
55class="filename">template-extension/my-extension/video.tpl</span>.</p>
56
57
58<h3>How can I activate my "replacers"?</h3>
59<p>An <strong>original template</strong> should be assigned to each
60 <strong>replacer (customized templates)</strong> to activate the related replacements.
61 This is the goal of "Extend for templates" in the Configuration Administration menu.</p>
62
63<p>If you select an <strong>optional URL keyword</strong> then replacements
64will be operate only on pages with this keyword. For example: <span
65  class="pwgScreen">index.php?/<strong>most_visited</strong></span></p>
66 
67<p>Advanced users will use permalinks as <strong>optional URL
68  keyword</strong>. </p>
69<h3>How can I deactivate my "replacers"?</h3>
70<ul>
71<li>Unselect related "Original templates".</li>
72<li>By FTP delete of "replacers".</li>
73</ul>
74<a name="warnings"></a>
75<h3>Warnings</h3>
76<ul>
77
78  <li><strong>Original template</strong> must be the "original" template
79  otherwise you could have unpredictable results!</li>
80
81  <li>On several <strong>replacers (customized templates)</strong> with the
82  same<strong>Original template</strong> and the same <strong>optional URL
83  keyword</strong> only the last replacer is active.</li>
84
85  <li>Unselected <strong>optional URL keyword</strong> will active the replacer
86  on any template usage. As previous point, order can override previous
87  selected replacers.</li>
88
89  <li>Subfolders:
90Subfolders are ignored but they are usefull to change current order.<br />
91distributed-samples: for test purpose are distributed!
92<strong>Don't edit them</strong> create your own ones.
93</li>
94
95  <li>On delete of a replacer the <strong>Original template</strong> is
96  immediately reactivated.</li>
97
98</ul>
Note: See TracBrowser for help on using the repository browser.