aboutsummaryrefslogtreecommitdiffstats
path: root/language/en_UK/help/extend_for_templates.html
diff options
context:
space:
mode:
authorvdigital <vdigital@piwigo.org>2008-07-14 21:42:40 +0000
committervdigital <vdigital@piwigo.org>2008-07-14 21:42:40 +0000
commitdf29ffbde72e88635f454d5d6d84c5a7209460f3 (patch)
tree0a35be2731fe75fe86e11adad6f0147f180956d8 /language/en_UK/help/extend_for_templates.html
parentb7709eae0dcb81df9eb668407b64f2cde38ba1f0 (diff)
Feature template-extension based on 2006 chrisaga's idea.
chrisaga wrote: "If you want to make some template customization without building a brand new template, you should use ..." git-svn-id: http://piwigo.org/svn/trunk@2434 68402e56-0260-453c-a942-63ccdbb3a9ee
Diffstat (limited to 'language/en_UK/help/extend_for_templates.html')
-rw-r--r--language/en_UK/help/extend_for_templates.html98
1 files changed, 98 insertions, 0 deletions
diff --git a/language/en_UK/help/extend_for_templates.html b/language/en_UK/help/extend_for_templates.html
new file mode 100644
index 000000000..8e2c7ac6b
--- /dev/null
+++ b/language/en_UK/help/extend_for_templates.html
@@ -0,0 +1,98 @@
+<h2>Extend for templates configuration</h2>
+
+<h3>Goal</h3>
+<p>Define replacement conditions for each template from template-extension
+(template called "replacer").</p>
+
+<p>"original template" from ./template/yoga (or any other than yoga)
+ will be replaced by a "replacer" if the replacer is linked to this "original template"
+ (and optionally, when the requested URL contains an "optional URL keyword").</p>
+
+<p>"Optional URL keywords" are those you can find after the module name in URLs.</p>
+
+<p>Therefore "Optional URL keywords" can be an active "permalink"
+(see permalinks in our documentation for further explanation).</p>
+
+<p>Read: `<a href="#warnings">Warning</a>` usage conditions.</p>
+
+<h3>What are template extensions?</h3>
+
+<p>This configuration tool is powerfull for beginners and advanced users.
+By FTP, in the template-extension folder, the Webmaster can duplicate a lot of
+ the distributed .tpl files ("original template") with a different name
+ ("replacer").
+
+ "Original templates", current original supported templates are:</p>
+<ul>
+ <li><span class="filename">index.tpl</span></li>
+ <li><span class="filename">mainpage_categories.tpl</span> and/or <span class="filename">thumbnails.tpl</span></li>
+ <li><span class="filename">menubar.tpl</span></li>
+ <li><span class="filename">header.tpl</span> and/or <span class="filename">footer.tpl</span></li>
+ <li><span class="filename">picture_content.tpl</span> and/or <span class="filename">picture.tpl</span></li>
+ <!-- <li><span class="filename">slideshow.tpl</span></li> -->
+ <li><span class="filename">profile.tpl</span> and/or <span class="filename">profile_content.tpl</span></li>
+ <li><span class="filename">tags.tpl</span></li>
+ <li><span class="filename">upload.tpl</span></li>
+ <li><span class="filename">about.tpl</span></li>
+ <li><span class="filename">popuphelp.tpl</span></li>
+ <li><span class="filename">search.tpl</span> and/or <span class="filename">search_rules.tpl</span></li>
+ <li><span class="filename">nbm.tpl</span> and/or <span class="filename">notification.tpl</span></li>
+ <li><span class="filename">identification.tpl</span> and/or <span class="filename">register.tpl</span></li>
+ <li><span class="filename">redirect.tpl</span></li>
+</ul>
+
+<h3>Where can I find "original templates"?</h3>
+
+<p>Distributed original templates are in template/yoga/
+(don't edit them in place for upgrade perspectives). So with "original templates",
+any webmaster can create his "replacers (customized templates)".</p>
+
+<h3>Where should I save "replacers"?</h3>
+
+<p><strong>Replacers (customized templates)</strong> must be placed in the
+template-extension folder (or its subfolders).
+Replacers can have any filename with the .tpl extension. For example: <span
+class="filename">template-extension/my-extension/video.tpl</span>.</p>
+
+
+<h3>How can I activate my "replacers"?</h3>
+<p>An <strong>original template</strong> should be assigned to each
+ <strong>replacer (customized templates)</strong> to activate the related replacements.
+ This is the goal of "Extend for templates" in the Configuration Administration menu.</p>
+
+<p>If you select an <strong>optional URL keyword</strong> then replacements
+will be operate only on pages with this keyword. For example: <span
+ class="pwgScreen">index.php?/<strong>most_visited</strong></span></p>
+
+<p>Advanced users will use permalinks as <strong>optional URL
+ keyword</strong>. </p>
+<h3>How can I deactivate my "replacers"?</h3>
+<ul>
+<li>Unselect related "Original templates".</li>
+<li>By FTP delete of "replacers".</li>
+</ul>
+<a name="warnings"></a>
+<h3>Warnings</h3>
+<ul>
+
+ <li><strong>Original template</strong> must be the "original" template
+ otherwise you could have unpredictable results!</li>
+
+ <li>On several <strong>replacers (customized templates)</strong> with the
+ same<strong>Original template</strong> and the same <strong>optional URL
+ keyword</strong> only the last replacer is active.</li>
+
+ <li>Unselected <strong>optional URL keyword</strong> will active the replacer
+ on any template usage. As previous point, order can override previous
+ selected replacers.</li>
+
+ <li>Subfolders:
+Subfolders are ignored but they are usefull to change current order.<br />
+distributed-samples: for test purpose are distributed!
+<strong>Don't edit them</strong> create your own ones.
+</li>
+
+ <li>On delete of a replacer the <strong>Original template</strong> is
+ immediately reactivated.</li>
+
+</ul> \ No newline at end of file