bbPress 主题制作
->
安装
安装主题非常简单.
- 首先保证你的 bbPress 根目录有一个名为 my-templates 的文件夹。
- 将你要使用的主题,以一个新文件夹的形式上传到 my-templates 目录。
- 安装完毕。
激活主题更简单,到后台主题管理页启用即可。然后刷新你的论坛。
设计
一个完整有效的主题,有以下三部分组成:
样式表
一个主题必须需要一个样式表文件,文件名为 style.css。在样式表的前端你需要输入一些该主题的信息(下例),bbPress 会根据这些信息识别它们为不同的主题。
/*
Theme Name: 你的主题名称。
Theme URI: 你主题的介绍页面。
Description: 简要描述你的主题。如“3栏黑色”等。
Version: 主题版本号。仅限数字和小数点。
Author: 主题作者名称。
Author URI: 主题作者的网站链接。
Ported By: 主题移植者名称,谁将该主题由其他程序移植到 bbPress。
Porter URI: 移植者网站链接。
*/
预览图
你应该包含一张 300×225 像素的预览图, 图片文件名为 screenshot.png
模板文件
然后,bbPress 将检查你主题中的这些模板文件,如果检测不到,bbPress 将使用默认模板 Kakumei。
- front-page.php
论坛首页. - forum.php
版块页面. - edit-post.php
编辑日志页面. - edit-form.php
调用函数为 edit_form() - favorites.php
某用户的收藏夹页面. - header.php
调用函数为 bb_get_header(). - footer.php
调用函数为 bb_get_footer(). - login.php
登录页面 ( /bb-login.php) - login-form.php
用户未登录时调用函数为 login_form() - logged-in.php
用户已登录时调用函数为 login_form() - password-reset.php
重置密码页面. - post-form.php
调用函数为 post_form(). - post.php
调用函数为 bb_post_template() - profile.php
用户档案页面. - profile-edit.php
用户档案编辑页面.. - profile-base.php
用户档案页面(增加了某插件应用时)。 - register.php
注册页面 - register-success.php
注册成功页面 - search.php
搜索结果页 - search-form.php
调用函数为 search_form(). - stats.php
论坛统计页面 - topic.php
话题浏览页 - topic-tags.php
调用函数为 topic_tags(). - tag-form.php
调用函数为 tags_form(). - topic-tags.php
调用函数为 topic_tags(). - tags.php
Tags 标签云 浏览页面 - tag-single.php
浏览某个 Tag - view.php
当已登录用户在某个浏览页面(比如“没有回复的话题”等)。
就这些,挺多的了。不过请记住,如果你的主题缺少其中任意一个模板,如果你没有添加,那么 bbPress 将会使用默认的 Kakumei 模板里的。
我们正努力使这些模板文件变得更加整洁。在未来的版本里,其中一些模板文件可能会被移除或者整合到其他模板文件中。
注意
最后,作为一个主题设计者,你需要注意下面这些事情。
- bbPress 为 CSS 类预先定义了一些函数。查看一下默认主题里 alt_class(), post_del_class() 和 topic_class() 的用法。
- 话题页面的 AJAX 脚本的运行依赖于 默认主题的 header 文件中的 javascript 文件(bbLogs注:抱歉这句我实在看不懂……高手请留言,谢谢)。
- 贴子列表必须包含 thread 函数
- 每个贴子必须包含 post-{$post_id} 函数
- 贴子表格应该有 postform 函数,提交按钮的函数是 postformsub
- 当前用户的 tags 列表应该包含 yourtaglist 函数, 其他用户的 tags 列表应该包含 otherstaglist 函数
- 单个 tag 应该包含 tag-{$tag_id}_{$user_id} 函数
- tag 提交表格应包含 tagform 函数,提交按钮的函数是 tagformsub
- 话题的信息应该包含 topicmeta 函数,话题被收藏的状态应该包含 favorites-toggle 函数
所有这些确实是挺恼人的,我们希望这些默认主题 Kakumei 里已经包括了足够的标识,你可以据此定制你自己的 CSS。如果你有关于标识(调用函数)的更好的建议,请联系我们。













