phpArticle 2.0 模板使用说明
本说明制作于: 2003-04-17

  • 每一套风格都会配套一套变量与一套模板.
  • 如 default 风格,默认是配套 default 变量套系和 default 模板套系.

变量

变量或数组 --- 以美元符号 $ 开头的字符串,模板中的变量均有其意义,输出时会被有意义的内容所替换.

变量可以由模板转换成,或由程序从变量套系中即出数据并动太动态生成,稍后会说明如何生成.

常用的变量或数组
以下变量由模板转换而成,不同的变量对应着不同的模板.修改相应的模板即可以得到你需要的界面

变量 模板 应用的面页 说明备注
$header header 全部(除打印页面) 为页眉,页眉中主要是放一些常用的链接,LOGO,你也可以修改 header 模板,以迎合你自己网站的风格.
$footer footer 全部 为页脚,放版权信息等,你也可以放上你需要的常用链接.
$headinclude headinclude 全部 该模板是放一些CSS层叠样式表,及一些放在<head>与</head>之间的代码.如:javascript脚本.
$style / 全部 该变量为数组,主要是替换页面的颜色,颜色包括表格的背景色,字体颜色等,表格宽度,还有<body>标记等,该变量由程序动态生成.来源于后台的变量套系统.

 

由变量套系中动态生成变量.
变量套系中的变量将会动态的生成数组 $style[] .
具体如下:
进行以下操作: 进入后台->变量管理->编辑变量
再点选其中一个变量套系,将看到变量套系里的变量列表.
点击查看该图


如 body 变量,点击对应的"编辑"链接,将进入变量编辑页面,如图:



在上图可以看到变量 body 与它将会被替换为 <body> , 代表的意义就是 会生成一个变量 $style[body] 而该变量在模板中将会被替换为 <body> . 其它的也是一样.该变量在所有模板中都会有效 . 只要在模板中放和 $style[body] 都会在输出时自动替换为 <body> . 而其它的变量也是一样.还有一点要注意,就是每个变量都是对应一套变量套系.而模板也是对应着一套模板套系.而变量套系跟模板套系都会对应着风格. 即是 该变量要对应着相应的模板套系中的模板才会起到它的作用.关系如下图

提示: 你可以添加自定义变量,如变量名为 abc 将生成变量 $style[abc] ,把 $style[abc] 放到模板中将可以替换 abc 变量中的实际内容.
例:

变量 替换为
logo <img src="http://www.21ds.net/images/logo.gif">

添加这样的变量,内容如上表. 将生成 $style[logo] 变量,如果把该变量放到 header 模板中,将会在每个页面的页眉中显示




模板

页面一般由三个主要模板组成.header,headinclude,footer 具体每个模板的用途上面已经说明了.
所以我们要定义文章系统的界面一般只要修改这三个模板就可以.


风格管理->编辑风格->选择要修改的风格

将可以看到上面的风格修改页面.这里可以修改 head,headinclude,footer 这几个模板及常用的变量设置,即页面大小,表格宽度,颜色等的设置.具体修改就要看你的发挥了.


常见问题

  1. 怎么才知道每个页面使用了哪些模板?
  2. 文章系统快速搜索的代码应该如何写?
  3. 如果在不同的分类使用不同的风格?


怎么才知道我需要修改哪些页面?
步骤如下:
系统设置->基本设置->模板设置->是否显示模板注释?

把这项设置为"是".

再返回文章系统的首页,刷新一次.再按右键查看源文件.如图:



在源代码中你将可以看到类似下面的注释:

<!-- BEGIN TEMPLATE: home -->
.
.
.
<!-- BEGIN TEMPLATE: headinclude -->
.
.
.
<!-- END TEMPLATE: headinclude -->
.
.
.
<!-- BEGIN TEMPLATE: footer -->
.
.
.
<!-- END TEMPLATE: footer -->

.
.
.
<!-- END TEMPLATE: home -->

中间的 "." 为省略的部分.从上面可以看到有六个注释,这里只是举例,当然不一定是这个数目.可以看出每个注释都代表着它的意义.
第一个<!-- BEGIN TEMPLATE: home -->对应着最后一个<!-- END TEMPLATE: home -->

注释是成对出现的.意义是这样的

<!-- 开始模板/结束模板 模板名 -->
<!-- BEGIN TEMPLATE: home -->
<!-- END TEMPLATE: home -->

从这个表应该可以看出这些注释标记的意义了吧.
这个页面是由 home 模板和 headinclude ,footer 等模板组成.从源代码可以知道这个页面由哪些模板组成,而这里显示的结构是 home 模板中包含着 headinclude,footer 等模板.即是模板中可以嵌套模板.即然知道了页面由哪些模板组成及模板的结构,相信剩下修改面页的工作就不会难到你了.你可以方便的使用后台的模板搜索功能找到要修改的模板.这里你只要注意模板的结构就可以修改了.如果修改错了,可以在编辑模板点击查看默认模板来看未修改前的代码,也可以点恢复链接把模板恢复为默认的.


文章系统快速搜索的代码如下:

<form method="post" action="$phparticleurl/search.php">
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<input type="text" name="keyword" size="30" maxlength="20">
<select name="type">
<option value="all" selected>搜索整篇文章</option>
<option value="title">只搜索标题</option>
</select>
<input type="hidden" name="ordertype" value="date">
<input type="hidden" name="action" value="result">
<input type="submit" value="提交">
</td>
</tr>
</table>
</form>

你可以任意的把上面的代码放到任一个模板中.如果不是放到模板中,请先把上面的 $phparticleurl 替换成有效的路径.路径指向 文章系统的 search.php



如何在不同的分类使用不同的风格?

文章系统支持多个风格的同时使用.使用方法如下.

进入台后,把自带的风格设置为默认.再新建一个风格,连原来自带的默认风格,共两个风格.当然还可以添加更多的风格.
你现在可以修改新建的风格.再设置不同的分类使用不同的风格.这样每个分类就拥有不同的界面了.而其它页面将会使用刚才你设置为默认的那风格的界面.

例:
现在我们的文章系统共有三个分类,分类命名为分类一,分类二,分类三.不必理会这些分类是根分类还是哪个分类的子分类.因为风格的设置是不会继承到子分类的.刚才所添加的分类都是使用默认风格的,因为你只有一个风格.现在再新建一个风格,命名为 style2 而原来的默认风格命为 default ,现在我们设置分类二的属性.如下图





设置分类二的风格为 style2 ,剩下就是修改这个风格.进入风格列表找到 style2 这个风格, 如下图:



点击 style2 的编辑链接进入编辑面页.




在这里你可以随意定义你的 style2 的界面.而定义出的效果将会应用到使用这个风格的分类中,如果你把这个风格设置为默认,还会应用到其它面页中.

如果你觉得这些还不够定义你的界面,那你还可以修改这个风格所配套的模板及变量,具体可以点击属性链接进入属性面页.



在属性设置面页中你可以看到这个风格所配套的变量套系与模板套系,在这里也可以修改风格所配套的变量套系与模板套系.只要你修改这个风格所配套的变量套系中的变量与模板套中的模板,就可以定义更多的界面.具体要修改哪些模板,刚才已经说过了,请看:"怎么才知道每个页面使用了哪些模板?".


如果你觉得哪里有说得不够的或看不懂的,或有什么建议的.请到技术支持论坛中发问.
论坛地址: http://www.21ds.net/forum