PHPCMS V9 是一款非常经典和强大的 PHP 开源内容管理系统,虽然现在市面上有更多现代化的 CMS,但其灵活的模板引擎和模块化思想仍然被很多老牌网站和开发者使用,掌握其模板制作,对于维护或二次开发 PHPCMS V9 网站至关重要。

(图片来源网络,侵删)
核心概念:PHPCMS V9 模板系统是如何工作的?
在开始之前,必须理解 PHPCMS V9 模板的基本工作原理:
- 模板文件:这些是纯 HTML 文件,但其中嵌入了 PHPCMS 的特定标签,它们位于
templates/目录下。 - 模板引擎:PHPCMS 使用自己的模板引擎来解析这些模板文件,当用户访问一个页面时,PHP 代码会读取对应的模板文件,将模板标签替换为从数据库中获取的实际数据,最终生成一个完整的 HTML 页面发送给浏览器。
- 这是模板的核心,标签就像是占位符,
{siteurl}会被替换为网站地址,{content ...}会被替换为调用出的文章列表。
第一部分:模板制作基础教程
这个部分将带您从零开始,一步步创建一个简单的模板。
步骤 1:环境准备
- 安装 PHPCMS V9:您需要先在本地服务器(如 XAMPP, WAMP, phpStudy)上完整安装一套 PHPCMS V9。
- 找到模板目录:进入 PHPCMS 的安装目录,找到
templates/文件夹,这是存放所有模板的地方。 - 创建新模板文件夹:为了不修改默认的
default模板,建议在templates/目录下创建一个属于您自己的文件夹,my_template。
步骤 2:认识模板文件结构
一个完整的 PHPCMS V9 站点模板通常包含以下核心文件:
index.html:网站首页模板。category.html:列表页/栏目页模板,用于显示某个栏目下的文章列表。show.html页/文章详情页模板,用于显示单篇文章的详细内容。- ``:其他页面模板,如搜索页、表单页等。
config.php:模板配置文件,用于定义模板名称、作者、版本等信息,以及页面布局等。style/:存放 CSS 文件的文件夹。images/:存放图片、背景图等静态资源的文件夹。js/:存放 JavaScript 文件的文件夹。
步骤 3:创建首页模板
-
在
templates/my_template/目录下创建index.html文件。
(图片来源网络,侵删) -
用一个标准的 HTML5 结构作为基础:
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>{if isset($SEO['title']) && !empty($SEO['title'])}{$SEO['title']}{/if}-{$SEO['site_title']}</title> <meta name="keywords" content="{if isset($SEO['keyword']) && !empty($SEO['keyword'])}{$SEO['keyword']}{/if}"> <meta name="description" content="{if isset($SEO['description']) && !empty($SEO['description'])}{$SEO['description']}{/if}"> <link rel="stylesheet" type="text/css" href="{CSS_PATH}style.css" /> </head> <body> <div class="header"> <!-- 这里放网站头部 --> <h1><a href="{siteurl}">我的PHPCMS网站</a></h1> </div> <div class="main"> <!-- 这里放主要内容 --> <h2>首页最新文章</h2> {pc:get sql="SELECT * FROM v9_news WHERE status=1 ORDER BY id DESC" num="10" return="data"} <ul> {loop $data $r} <li><a href="{$r['url']}">{$r['title']}</a></li> {/loop} </ul> {/pc} </div> <div class="footer"> <!-- 这里放网站底部 --> <p>Copyright © {date('Y', $timestamp)} 我的PHPCMS网站</p> </div> </body> </html> -
解析模板标签:
{siteurl}:网站根目录地址。{if isset($SEO['title']) ...}{/if}:SEO 标签,用于动态设置页面标题、关键词和描述。{CSS_PATH}:CSS 文件路径,会自动指向templates/my_template/style/。{pc:get ...}:最核心的标签,用于从数据库中获取数据。sql="...":SQL 查询语句。v9_news是文章的默认数据表(news是模型名)。num="10":获取 10 条数据。return="data":将查询结果存入$data变量。
{loop $data $r}:循环标签,遍历$data中的每一条数据,并将当前数据存入$r变量。{$r['url']}:文章的 URL 地址,PHPCMS 会自动处理。{$r['title']}:文章的标题。{date('Y', $timestamp)}:日期标签,$timestamp是当前时间戳。
步骤 4:创建列表页模板
-
在
templates/my_template/目录下创建category.html。 -
其结构与
index.html类似,但内容调用标签会不同。
(图片来源网络,侵删)<!-- category.html --> <!DOCTYPE html> <html lang="zh-CN"> <head> <title>{if isset($SEO['title']) && !empty($SEO['title'])}{$SEO['title']}{else}栏目列表-{$SEO['site_title']}{/if}</title> <!-- 其他 head 内容 --> </head> <body> <div class="header"> <!-- 头部 --> </div> <div class="main"> <h2>{$CATEGORY['catname']}</h2> <!-- 显示当前栏目名称 --> {pc:content action="lists" catid="$catid" num="10" order="id DESC" page="$page"} <ul> {loop $data $r} <li><a href="{$r['url']}">{$r['title']} - {date('Y-m-d', $r['inputtime'])}</a></li> {/loop} </ul> <!-- 分页 --> <div class="page">{$pages}</div> {/pc} </div> <div class="footer"> <!-- 底部 --> </div> </body> </html> -
解析新标签:
{pc:content action="lists" ...}列表标签,专门用于调用栏目内容。action="lists":表示调用列表。catid="$catid":表示调用当前栏目 ID 的内容。$catid是系统自动传递的变量。page="$page":开启分页功能。
{$CATEGORY['catname']}:调用当前栏目的名称。{$pages}:分页代码,PHPCMS 会自动生成分页链接。
步骤 5:创建内容页模板
-
在
templates/my_template/目录下创建show.html。 -
这个模板非常简单,主要用来显示单篇文章。
<!-- show.html --> <!DOCTYPE html> <html lang="zh-CN"> <head> <title>{$title} - {$SEO['site_title']}</title> <!-- 其他 head 内容 --> </head> <body> <div class="header"> <!-- 头部 --> </div> <div class="main"> <h1>{$title}</h1> <div class="info">发布时间:{date('Y-m-d H:i:s', $inputtime)} 作者:{$author}</div> <div class="content"> {$content} </div> </div> <div class="footer"> <!-- 底部 --> </div> </body> </html> -
解析新标签:
{$title}。{$inputtime}:文章发布时间。{$author}:文章作者。{$content}:文章正文内容(包含 HTML 标签)。
步骤 6:后台设置
- 登录 PHPCMS 后台。
- 进入 ” -> “内容模型管理”,确保你使用的模型(如“新闻”)存在。
- 进入 ” -> “栏目管理”。
- 新建一个栏目,公司新闻”。
- 在“模板选择”部分,选择你刚刚创建的
my_template模板。 - 为该栏目指定列表页模板(
category.html页模板(show.html)。
- 进入 “系统” -> “站点管理”。
- 选择你的站点,在“默认模板”中选择
my_template。
- 选择你的站点,在“默认模板”中选择
- 进入 “系统” -> “模板管理” -> “更新模板缓存”,这一步至关重要,让 PHPCMS 识别你的新模板。
你的 PHPCMS 网站就已经应用上你自己制作的模板了,你可以添加一些文章,然后访问首页、列表页和内容页查看效果。
第二部分:视频教程资源推荐
文字教程可能不够直观,视频教程能更好地展示操作过程,以下是一些推荐的资源:
Bilibili (B站) - 首选推荐
B站是学习技术的宝库,有很多 PHPCMS V9 的免费教程。
- 搜索关键词:
PHPCMS V9 模板制作教程、PHPCMS V9 视频教程、PHPCMS V9 从入门到精通 - 推荐频道/UP主:
- 搜索结果:直接在 B站 搜索,你会找到很多系列教程,搜索
PHPCMS V9 模板制作,会出现很多播放量较高的视频。 - 特点:这些视频通常比较老,但 PHPCMS V9 的核心原理变化不大,所以依然非常有价值,你可以跟着视频一步步操作,理解模板的整个流程。
- 注意:由于是老教程,可能 PHPCMS 的界面略有不同,但核心逻辑(标签、模板文件位置、后台设置)是完全一致的。
- 搜索结果:直接在 B站 搜索,你会找到很多系列教程,搜索
优酷、腾讯视频
与 B站 类似,这些平台也有不少 PHPCMS V9 的教程视频。
- 搜索关键词:同上。
- 特点可能更加零散,但可以找到一些特定问题的解答视频。
专业视频教学网站(部分可能收费)
一些付费的 IT 教学平台也可能有相关课程,但通常需要付费。
- 平台举例:慕课网、51CTO学院、CSDN学院等。
- 搜索:在这些平台搜索
PHPCMS V9。 - 特点:课程可能更系统、更深入,并且可能包含最新的更新,但需要花费一定的费用。
第三部分:官方文档与社区
遇到问题,最好的参考资料永远是官方文档和社区。
-
官方文档:
- PHPCMS V9 的官方文档是学习和查阅标签语法的权威资料。
- 地址:你可以在 PHPCMS 的官网或通过搜索引擎找到
PHPCMS V9 开发手册或标签手册。 - :手册中会有详细的 标签列表 和 函数说明,这是你进阶必备的工具。
-
官方论坛/社区:
- 官方论坛是解决问题的最佳场所。
- 地址:同样可以通过搜索找到 PHPCMS 的官方论坛。
- 如何使用:遇到具体问题(比如某个标签不生效、SQL 语句怎么写),可以先在论坛搜索,如果没有,再发帖求助,发帖时,请清晰地描述你的问题、你的代码和你的环境。
总结与学习路径
- 入门:先跟着文字教程或视频教程,完整地走一遍“创建模板文件夹 -> 编写首页/列表页/内容页 -> 后台绑定”的全过程,目标是理解“模板文件”和“后台设置”是如何关联起来的。
- 进阶:熟悉基本标签后,开始查阅官方标签手册,尝试调用更复杂的数据,推荐文章”、“热门文章”、“相关文章”等,学习如何使用
if、else等条件标签来控制模板的显示逻辑。 - 精通:学习模板的继承和布局(通过
config.php定义页面框架,其他页面继承它),以及如何自定义标签和函数,实现更复杂的功能。
PHPCMS V9 的模板制作虽然有其固定的模式,但非常灵活,多练习、多查阅资料,你很快就能掌握它,祝你学习顺利!
