编辑“Gallery:外观主题:参考:Smarty”

==Smarty==
[http://smarty.php.net Smarty]是一个PHP模板系统，被Gallery2用来收集显示给用户的页面。模板允许Gallery2的高度自定义--通过将其web页面的设计与Gallery允许所需的代码分离开。通过使用某种特殊的markup语言以及标准的HTML，就可自定义外观主题，从而以多种方式显示核心Gallery项目。

===资料及教程===
有关Smarty系统的完整资料请见[http://smarty.php.net http://smarty.php.net]。在网站上还有Smarty速成资料，而通过搜索引擎你可以找到很多Smarty的相关教程。  

===使用Smarty模板===
Smarty模板混合有HTML和Smarty markup语言。这允许它们显示动态的内容。例如，如果你希望在Gallery页面上向某用户显示欢迎消息的话，你可以在页面模板中使用如下的代码：

<pre><p>Hello, <b>{$user.userName}</b></p></pre>

而对于普通HTML文件，要达到相同的效果的话就需要在PHP代码上花很大功夫，而且所得结果的自定制性会比较差，也就是不如独立的模板系统。理解以下的Smarty概念及标记的话，在编写Gallery2的外观主题模板时能帮上不少忙：

*使用HTML和Smarty markup编写Smarty模板
*使用<code>{$variableName}</code>语法的变量访问
*使用<code>{if}...{else}...{/if}</code>的条件语句
*使用<code>{foreach}...{/foreach}</code>的数组访问
*使用<code>{object->method}</code>的对象访问

===模板debugging和变量的探索===
如果开启了Gallery2的debugging，每次渲染某模板时，Smarty都会产生debug输出。该输出出现在一个单独的窗口中并显示所有用在相应页面中的变量--当模板不按所预期的运行时这就非常有价值了。同样这帮助查看所有传送到模板的变量，尤其是当你需要访问外观主题或用户信息时这就更有用了。

要打开Gallery2的debugging，你需要编辑Gallery根目录下的''config.php''文件。这里有一个关于Gallery2 debugging模式的解释：

<pre>$gallery->setDebug(false);</pre>

要开启debugging模式，修改该行：

<pre>$gallery->setDebug('buffered');</pre>

保存''config.php''并将其复制到Gallery根目录下。现在当你查看任何Gallery页面时，就会在页面底部看到Gallery debug输出，而smarty debug输出应当出现在某个单独的他出窗口中。如果没有弹出窗口的话，请确保你允许Gallery站点弹出窗口。

===使数据在模板中可用===
信息的某些项目被Gallery作为标准用于某模板。然而某些项目必须被外观主题请求了才能够由模本进行访问。这往往是通过''theme.inc''的各种<code>showXXX</code>函数中的''loadCommonTemplateData''函数呼叫完成的。有关可用选项的讨论，请参看GalleryTheme.class的源代码，可在Gallery的''/modules/core/classes/'目录中找到。

[[Category:Gallery 2:Development]]