2024年1月6日发(作者：)
[经验] Discuz！模板制作教程
本帖最后由 PuBor于 2010-10-1 01:05 编辑
接触Discuz! 有一段时间了，使用的风格都是别人的免费品。一来自己的美工水平实在不行，二来网上很少有比较完整的模板制作教程。因为工作的需要，现特写了一份模板的制作教程。小弟才疏学浅，不对之处还请指正。
模板制作前请将你的界面设计好，并制作成html+CSS的格式。这里我就以大魔王的“蓝色经典”作为样版（知识共享，希望大魔王不要介意，如有侵权，请及时通知我）。效果图如下：
（图1)
在开始前，先了介绍一下discuz!的几个模板文件：
1、 --------------------------------------页面头部
2、 -------------------------------------------------论坛首页
3、 ------------------------------------------------页面底部
4、 viewthread---------------------------------------------查看帖子内容
discuz！论坛的页面通常是几个模板文件共同作用下达到的效果，如图1就是++这三个文件共同作用的效果。
对应的是：
（图2）
对应的是：
（图3）
剩下的就是文件显示的了。
当然你要将首页显示的效果就制作成一个文件模板也是可以的，这里之所以分开，是因为和文件通常还会被其它的模版文件引用。也就是说，其它的页面（比如发贴的页面）的头部、底部与首页的头部、底部完全一样，分开来写就可以达到重复利用，减少劳动的效果。
下面我们就开始制作：
首先，现在我要制作的这套模板叫test，那么我就在templates目录下建立一个test目录。在test目录下再新建一个images文件夹用于存放这套模板的图片，把切好的所有图片保存到这个文件夹中。templates/test文件夹用于存放这套模板的htm文件，在这个目录中新建三个文件、、，打开你设计好的主页html文件，将你想作为头部的那一段代码复制粘贴到文件中，
相应的将作为底部的那一段代码复制粘贴到文件中，其余的代码复制粘贴到文件中。
最后在文件的最顶部和最底部分别加上：{subtemplate header} 和{subtemplate footer}
这两句算是discuz的语言，意思是将和文件包含进来，这样就构成了一个完整的主页面了。
接下来的工作要在论坛后台设置中来完成
（1） 进入论坛点击 “系统设置 ——> 界面——> 模板管理”， 在新增模板后填入模板名称，模板文件所在目录，板权信息然后提交即可！如图4：
（图4）
（2） 在“界面——> 风格管理” 中，在新增界面风格后填入方案名称“test”然后提交即可！
（3） 提交方案名称后，您就可以在界面风格中看到您所定义的新的风格方案。如下图：
（图5）
注意上面用红色圆圈圈起来的那幅模版预览图，你的是不是没有显示出来？这需要将你的首页的效果图做成110x120并命名为，将这图片放到test目录下就可以了。到此，一套新的风格模板方案就添加到模板库里了，但还不是我们需要的最终效果，接下来要对模板文件继续进行
调整，以达到想要的最终效果
（4） 点击 [编辑] 后就可以进入该模板的风格配色方案的编辑页面，按照图6把各个对应参数填入相应位置。
（图6）
填写好后，点击“提交”，更新一下缓存，浏览论坛首页出现下图：
（图7）
呵呵，有内容出来了，可是排版上却变得乱七八糟了，这是因为还没有引入CSS文件。这时将原来设计好的CSS文件放到你模板目录下（templates/test），并将它重命名为“css_”（注意：改后的文件名是css_append，后缀名是htm）。接着打开文件，找到你引入CSS文件的语句，这会因为引入的语句不同而不同，我这里是将这个替换为：
$rsshead
$extrahead
{subtemplate css_script}
这样就可以将你的CSS文件引入了。进入后台更新一下缓存，现在的效果图如下：
（图8）
这样就整齐了许多，这时你是不是发觉少了点东西？没错，图片没有显视出来。下面我们先将背景图（也就是CSS文件中引入的图片）显示出来。打开css_文件，找到所有你引入图片的地方，将路径替换为“{STYLEIMGDIR}”。例如：这里有一句：
#footer{padding:1em 0;background:url(images/footer_) }
将它改为：
#footer{padding:1em 0;background:url({STYLEIMGDIR}/footer_) repeat-x top;}
{STYLEIMGDIR}实际上是discuz的一个变量，当模板被解释时，就会用一个值来替换这个变量，这个变量的值可以在后台设置。进入后台后点击“界面——> 风格管理”出现下图：
（图9）
找到你正在制作的test风格，点击“编辑”按钮，出现下图：
（图10）
看到了吧，当模板被解释时，就会用上面所填的路径来替换这个变量。
好了，现在更新缓存再看一下效果：
（图11）
哈哈，和原来设计的效果图一样了，是否有一种成功的喜悦？虽然，到这里已经迈出了成功的一步，但革命尚未成功，同志仍需努力！现在制作的模版是静态的，也就是说就算你发贴了，里面的内容也不会改变的，甚至你点个连接都会出错的。
下面我们就来让它“动”起来。
一、修改头部文件
1、 打开正在制作的模板文件(以下简称)，以及默认模板templatesdefault 的文件（以下简称“默认”）。
2、 将文件的标题用 $navtitle $bbname $seotitle 来代替。例如：我这里是：“
3、 看里是否有类似“”这样的语句，有就删除。然后，将默认里的以下语句：
Discuz! Board" />
复制粘贴到文件相应的位置（注这些对界面没什么影响，但对SEO优化有帮助）
4、 将默认里的以下语句：
复制粘贴到文件相应的位置（至于这些有什么作用，自己查一下吧）
5、 将头部的logo“动”起来
（图12）
找到显示logo的地方，我这里是：
将“”和“搜球论坛”分别用$indexname和$bbname代替（$indexname 是首页文件名的变量，$bbname是论坛名称变量，其它相同的地方都可以用这两个变量作替换，以增加模版的适应性。）
6、 让登陆状态“动”起来
（图13）
上面是我设计的效果图和相应的代码，这是登陆时的显示状态，当然我还希望没登陆的时候这样显示：
（图14）
在默认文件中找到：
$discuz_userss href="?action=switchstatus">{lang login_invisible_mode} title="{lang login_switch_invisible_mode}">{lang login_normal_mode}
|
$forum}&srchfid=$forum[fid]{/if}">{lang my_posts}
href="{$uchomeurl}/?uid=$discuz_uid" target="_blank">{lang space_short}
target="_blank">{lang space_short}
$_DCOOKIE['pmnum']}--> class="new" title="{lang pm_new}" target="_blank">{lang pm}($_DCOOKIE[pmnum])
|
href="?fid=$fid" target="_blank">{lang modcp}
href="" target="_blank">{lang admincp}
href="?action=logout&formhash={FORMHASH}">{lang logout}
class="noborder">$_DCOOKIE['loginuser']
activation}
href="?action=logout&formhash={FORMHASH}">{lang logout}
login}
用这一段代码替换上面红色黑体部份，并在
用这一段代码替换上面红色黑体部份，这样就实现了菜单的调用。
到此整个头部文件模板就制作好了。
二、制作首页主体部分
同样打开正在制作的模板文件(以下简称)，以及默认模板templatesdefault 的文件（以下简称“默认”）
1、 导航条
（图16）
“搜球论坛”和“首页”分别用“$bbname”和“{lang home}”代替。
2、 版块列表
（图17）
上面只列出了“新手指南”区块的代码，其它区块雷同就不再列出了。
在默认文件中找到下面这段代码：（绿色字体是我添加的注释）
//循环
{lang forum_category_modedby}:
$cat[moderators]
// 如果有分区版主则显示
title="{lang spread}" alt="{lang spread}" />
//分区版块的收缩与展开
$cat[name]
//分区名称
| $forum[icon] //版块图标
| N/A $forum[threads] / $forum[posts] // $forum[threads]主题数，$forum[posts]总发贴数
| //是否为私密版块 {lang private_forum}
//显示最后发贴的信息
$forum['lastpost']['author']
{lang anonymous}
- $forum[lastpost][dateline]
{lang never} //从未发贴
|
|---|---|---|
|
|
//下面是关于广告的一些代码，不是重点，这里就不细究了
上面这段代码便可以罗列出区块和版块，但该如何加入到我们制作的模块中呢？首先将你设计的显示版块列表的那些代码全部清空，然后将上面这段添加到相应的位置。这样就可以将版块列表显示出来了，但很有可能显示的内容是乱七八糟的。这是因为，你加入这段代码的CSS类名和你原来的不一样了，这就需要你在css_文件里重新定义CSS，以达到你想要的效果。当然你可以发现上面这段代码有些地方使用变量来作为CSS类名了，这是为了能够在后台控制显示的样式。为了简单，这里暂不细究，你只要将这些重新命名，在css_文件里定义就行了。
3、 友情链接和在线会员
（图18）
显示这两块的实现代码也不少，这里不再列出来分析了，因为如果你能将上面的版块列表弄明白，这两块也就自然自知怎样处理了。
4、 数据调用
数据调用就不能像之前那样简单地从默认模版那里拷贝、粘贴就可以了。这需要利用后台才行。在开始之前先看一下，我们要实现的效果
（图19）
这里显示的内容是调用了“我的助手”（“我的助手”属于模块脚本，而模块脚本为数据调用模块的一种扩展，适用于懂得书写 PHP 模块脚本”，这里显示了所在的模块脚本。点击“我的助手”后面的“添加”出现下图，数据调用程序的程序员）。登陆后台“工具
（图20）
“模块名称”为必填项，其它的可以不填。点击“预览”按钮，出现下图：
（图21）
将“{eval request('小叶_我的助手');}”这句拷贝下来，并按“提交”按钮；接着用“{eval request('小叶_我的助手');}”这句替换相应的代码。更新一下缓存再浏览主页，这时会发现，显示的内容和格式与想要的结果不一样。这是因为模块脚本也用它自己的模版，像“我的助手”的模块脚本为“include/request/”文件，如果当前模版文件夹中有request_文件，则“我的助手”使用当前的request_文件作为模版，否则使用默认模版文件夹“templates/default/”目录下的request_文件作为模版。所以，如果你要实现你自己想要的形式就要将默认模版文件夹“templates/default/”目录下的request_文件复制到当前模版文件夹中，并作相应的修改才行。如果要图10的效果，可以参考大魔王的“蓝色经典”模版中的request_文件，值得注意的是，这个的CSS样式同样要在css_文件中定义。
下面教大家另一种非模块脚本数据调用，这种调用包括：主题列表、版块列表、主题附件
等等。很多人喜欢在首页将贴中的图片以幻灯片的形式来显示，这属于主题附件调用，下面就以这种调用来演示非模块脚本的数据调用。先看一下，要实现的效果：
（图22）
将你设计的显示图片幻灯片的javascript文件（我这里是photo_）拷贝到当前制作的模版文件夹下。
主题附件”，将下面的代码填到图中所示的地方添加数据调用登陆后台“工具
（注：”这是你设计的显示图片幻灯片的js文件，注意文件的路径要正确。因为我将photo_这个文件放在了“templates/test/”目录下，故src="templates/test/photo_"。可能你设计图片幻灯片显示的javascript程序并不单独放在一个js文件中，而是嵌套在html文档中。这时，你就应该将你html文档中的javascript程序来代替“”。
）
填好后，点击“预览”按钮，预览一下效果。满意后，将“{eval request('小叶_首页幻灯图片');}”这句替换上面红色黑体那部分代码，这样就实现了图片的调用。
下面分析一下其中的原理，“[node]„„[node]”可以将它看作一个循环结构，“{imgfile}”代表的是图片的URL，“{link}”代表的是附件所属帖的链接，“{subject}”代表的是附件所属贴的主题标题，输出的时候除了这些变量会变成相应的值外，其它的都会原样输出，也就是说“{eval request('小叶_首页幻灯图片');}”这个语句在输出的时候代码结构与上面红色黑体部分的代码是一样的。既然“{eval request('小叶_首页幻灯图片');}”这个语句输出的是你在数据调用编辑框中填写的代码，那么上面数据调用编辑框中填写的代码就不是唯一的了。例如，你可以在数据调用编辑框中填写以下代码：
[node]
[/node]
当然这时你就应该用“{eval request('小叶_首页幻灯图片');}”这个语句代替你模版文件中的这段代码：
这种数据调用是比较自由的，只要输出的时候能够与模板文件中的上下文构成一个整体即可。值得注意的是，如果你真的在数据调用编辑框中填写以下代码：
[node]
[/node]
那么点击“预览”按钮的时候并不会看到想要的那种效果，但在浏览主页的时候，显示却是正常的。出现这种情况是因为，预览的时候以下这些代码：
[node]
[/node]
并不构成一个整体，当然看不到想要的效果；但在浏览主页的时候，这些代码却与主页的上下文构成了一个完整的幻灯图片显示。所以为了专业，这里建议大家在填写数据调用代码的时候最好是结构完整的。
风格管理”找到你制作的风格包:到此，如果你能将上面的全部弄明白，那么制作一套模版就不成什么问题了，虽然这里只是演示了首页的模版制作，但其它的页面模版制作是一样的。最后，教大家怎样发布自己制作的模版。我就以现在的test这套来演示，虽然这只是首页的模版，但discuz!发现你的模版文件夹里没有其它相应的模版文件时，就会自动的调用默认模版文件夹“templates/default/”下的文件，所以并不影响使用。登陆后台“界面
（图23）
数据调用”，如下图将你要导出的全部选上点击“导出”会弹出一个保存文件的对话，将这文件保存到你的模版文件目录下（必须是模版文件的根目录）。接着将数据调用的信息导出，“工具
（图24）
导入”将它导入。数据调用点击“导出”保存文件，这个文件不一定要保存到模板的根目录。到此，模版的制作算是完成了，安装的时候，第一个导出的文件只要在模板的test目录就可以了，第二个导出的文件就要在后台“工具
写在最后：
Discuz!的模板制作远不止这些，教大家制作的test模板还不能在后更改样式，要实现这个功能就得修改css样式模板文件（css_），写教程很累人，这个以后有时间再写出来吧。（尊重别人的劳动成果，转载请注明——PuBor）！
发布者：admin，转转请注明出处：http://www.yc00.com/web/1704477902a1353760.html
评论列表（0条）