为了您更好的理解模块和页面的关系,您可以首先浏览下以下文档:
SupSite页面文件与模块关系说明
如何利用SupeSite创建模块的高级功能?
SS5.5/XS3.0默认模板各页面调用内容说明
如果您创建出了一个模块,官方提供的模块风格不适用您的站点,需要重新设计模块风格的时候,就面临一个问题,如何使用ss模块调用出来的内容。
下面我们以一个很简单的例子来简要演示下:
如下图,我们需要对下图的日志页面黄色部分进行改造
根据
SupSite页面文件与模块关系说明,我们很清楚的知道,这个地方调用的是最新发布的18条日志。模板中显示的是最新日志的标题和作者。涉及的相关页面是:
templates/default/index.html.php
现在,我们为了了解新发布的帖子查看情况,我们需要为其增加一个参数:查看数。
那么应该怎么做呢?
我想,大多数站长可能不清楚查看数到底是用什么变量来显示的。我们这样操作:
首先,我们打开templates/default/index.html.php,定位黄色部门的模块代码:
见下图
图中黄色部门就是该段调用内容的模块代码
对照 数据库字典(在程序文件的根目录均有当前版本的数据库字典提供)
zidian.zip (19.19 KB)
,我们可以看到spaceblog表中 字段[viewnum]表示的是查看数,这就是我们需要的。
接着,
对于模块里面取出的数值,我们用$value[字段名]的方式进行调用。
因此$value[viewnum]就是查看数了。
接下来我们需要的是如何修改模板文件了
引用:
<!--最新发布的日志-->
<!--{block name="spaceblog" parameter="order/i.dateline DESC/limit/0,18/showspacename/1/subjectlen/40/subjectdot/1/cachetime/14800/cachename/coolblog/tpl/data"}-->
<div id="focus">
<ul class="msgtitlelist">
<!--{if !empty($_SBLOCK['coolblog'])}-->
<!--{loop $_SBLOCK['coolblog'] $value}-->
<li><cite><a href="#uid/$value[uid]#">$value[username]</a> </cite><a href="$value[url]" title="$value[subjectall]" target="_blank">$value[subject]</a></li>
<!--{/loop}-->
<!--{/if}-->
</ul>
</div>
</div>
</div>
我们在
$value[subject]</a>后增加查看数,即$value[subject]</a>(热度:$value[viewnum])
保存。然后刷新看看。可以看到,我们要的效果已经出来了,每个标题后边显示了相应帖子的查看数信息,当然如果您需要修改得更漂亮些,还需要了解html知识。
触类旁通。
***********************************************************************************************************************
附录:
ss/xs模板语法和dz的模板语法一致,只要是运用到下面的几个语句:
a.<!--{ ... }-->
逻辑元素包围符,该符号用于包含条件和循环元素
1.条件判断
引用:
<!--{if expr1}-->
statement1
<!--{elseif expr2}-->
statement2
<!--{else}-->
statement3
<!--{/if}-->
这是一个典型的条件模板,当条件 expr1 为真时,显示模板 statement1 内容,否则当 expr2 为真时,显示模板 statement2 内容,否则显示模板 statement3 的内容。如同其他语言中的条件控制一样,其中 <!--{elseif expr}--> 和 <!--{else} --> 是非必须的。
2.不带下标变量的数组循环
引用:
<!--{loop $array $value}-->
statement
<!--{/loop}-->
相当于 PHP 的数组循环语句:
引用:
foreach($array as $value) {
statement
}
3.带下标变量的数组循环
引用:
<!--{loop $array $key $value}-->
statement
<!--{/loop}-->
相当于 PHP 的数组循环语句:
引用:
foreach($array as $key => $value) {
statement
}
逻辑元素包围符在 { } 外面包含了 html 的注释符号 <!-- -->,除了为了和信息元素相区别外,也方便了使用 Dreamweaver 和 Frontpage 之类工具编辑模板的用户。因逻辑元素会被识别为 html 的注释而不被显示,对于绝大多数用户,逻辑元素中的内容是完全不需要修改的,甚至修改错一个字符就可能引起错误信息和整个系统无法运行。因此通常您在修改模板的时候,不要修改模板的逻辑信息,更不要将逻辑信息内部元素(如 <!--{else}--> 等)的前后位置作以修改,否则可能会导致错误。如果您的模板被不慎修改损坏,请立即用原标准默认模板覆盖,即可恢复。
对于高手而言,实际上外部的 <!-- --> 是可以省略不写的,可以用于某些元素在模板中的定位,但强烈建议普通用户不要轻易尝试。
b.{ ... }
信息元素包围符
1.{template name}
模板嵌入符,为了避免模板的冗长,可以使用本符号来将 name 模板的内容嵌入本模板中(实际上为引用)。
2.{eval statement}
运行 PHP 语句体 statement。推荐只在特别必须的时候才使用该结构,因为它会破坏模板的结构和可读性。如 {eval echo 'template!';} 实现的功能为 echo 'template';