PageAdmin 标签教程

什么是 PageAdmin 标签？

PageAdmin 标签是一种在网页模板中插入特定代码的机制，这些代码在网站生成页面时，会被 PageAdmin 系统解析并替换为实际的内容（如文章列表、产品图片、友情链接等）。

pageadmin标签教程
（图片来源网络，侵删）

核心思想： 将网页的静态结构和动态内容分离开。

  • 模板: 网站的“骨架”，由 HTML 和 PageAdmin 标签构成,它定义了页面的布局和样式。
  • 骨架中的“关节”，告诉系统“这里应该填入什么内容”。
  • 存储在 PageAdmin 后台数据库中的实际信息（文章、产品等）。

通过这种方式，您只需要修改后台的内容，所有使用了相应标签的页面都会自动更新，无需再手动编辑 HTML 文件。

标签的基本语法

PageAdmin 的标签语法非常直观，通常由两部分组成：标签头 和 标签尾。

{标签名 属性1='值1' 属性2='值2' ...}
    ...标签内容（通常是子标签）...
{/标签名}
  • {标签名 ...}: 这是标签的开始，也称为“标签头”，在这里定义标签的类型和它的各种参数（属性）。
  • {/标签名}: 这是标签的结束，也称为“标签尾”,它告诉系统标签的作用到此为止。

示例：

pageadmin标签教程
（图片来源网络，侵删）
{list type='article' cid='1' order='id desc' num='10'}
    <h3><a href="[field:link/]">[field:title/]</a></h3>
    <p>[field:desc/]</p>
{/list}

这个例子会调用一个文章列表标签，从分类 ID 为 1 的分类中，按 ID 降序（最新的在前）获取 10 篇文章,并循环显示它们的标题和简介。

核心标签详解

PageAdmin 的标签系统非常强大,我们分模块来介绍最常用的一些标签。

列表标签

用于获取并循环显示一组内容，如文章、产品、下载等，这是最核心、最常用的标签。

基本语法：

{list type='内容模型名称' cid='分类ID' 属性1='值1' ...}
    <a href="[field:link/]">[field:title/]</a>
{/list}

常用属性：

  • type: （必填） 指定内容模型的名称。
    • 'article': 文章
    • 'product': 产品
    • 'download': 下载
    • 'picture': 图片
  • cid: （必填） 指定分类的 ID，你可以在后台“内容管理” -> “分类管理”中找到每个分类的 ID。
  • num: 获取的记录数量。num='5' 表示获取 5 条。
  • order: 排序方式。
    • order='id desc': 按 ID 降序（最新的在前）
    • order='id asc': 按 ID 升序（最旧的在前）
    • order='hits desc': 按点击量降序（最热门的在前）
  • where: 自定义查询条件。where='isrecommend=1' 只获取推荐的内容。
  • page: （非常重要） 是否启用分页，设置为 page='1' 或 page='true' 后，系统会自动在 {/list} 之后生成分页导航代码。

[field:...] 字段标签 (在 list 循环内部使用)

在 {list} 和 {/list} 之间，使用 [field:字段名/] 来获取当前循环项的具体信息。

  • [field:id/]: 内容的 ID。
  • [field:title/]: 内容的标题。
  • [field:link/]: 内容的详情页链接。
  • [field:desc/]: 内容的简介。
  • [field:thumb/]: 内容的缩略图路径。
  • [field:hits/]: 内容的点击量。
  • [field:author/]: 内容的作者。
  • [field:inputtime/]: 内容的发布时间。

示例：显示最新的 5 篇文章

<div class="news-list">
    <h2>最新资讯</h2>
    {list type='article' cid='1' num='5' order='id desc'}
        <div class="news-item">
            <a href="[field:link/]">
                <img src="[field:thumb/]" alt="[field:title/]">
                <h3>[field:title/]</h3>
            </a>
            <p class="date">发布时间：[field:inputtime/]</p>
        </div>
    {/list}
</div>

标签

用于获取某一个特定内容的详细信息，通常用于“联系我们”、“公司简介”等单页。

基本语法：

{content type='内容模型名称' cid='分类ID' id='内容ID'}
    <h2>[field:title/]</h2>
    [field:content/]
{/content}

常用属性：

  • type: 内容模型名称（同列表标签）。
  • cid: 分类 ID。
  • id: （必填） 指定要获取的的 ID（不是分类 ID）。

示例：显示公司简介

假设“公司简介”这篇文章的分类 ID 是 2，文章本身的 ID 是 10。

<div class="company-intro">
    {content type='article' cid='2' id='10'}
        [field:content/]
    {/content}
</div>

分类标签

用于获取并显示分类信息,常用于制作网站导航栏。

基本语法：

{category type='内容模型名称' pid='父分类ID' ...}
    <a href="[field:link/]">[field:name/]</a>
{/category}

常用属性：

  • type: 内容模型名称,指定要获取哪个模型下的分类。
  • pid: 父分类 ID，如果为空或 0,则获取顶级分类。
  • num: 获取的分类数量。

[field:...] 字段标签 (在 category 循环内部使用)

  • [field:id/]: 分类 ID。
  • [field:name/]: 分类名称。
  • [field:link/]: 分类下的列表页链接。
  • [field:pid/]: 父分类 ID。

示例：制作主导航栏（假设所有导航都是顶级分类）

<div class="main-nav">
    <ul>
        {category type='article' pid='0'}
            <li><a href="[field:link/]">[field:name/]</a></li>
        {/category}
    </ul>
</div>

友情链接标签

用于获取后台设置的友情链接。

基本语法：

{flink type='文字' num='10'}
    <a href="[field:url/]" target="_blank">[field:name/]</a>
{/flink}

常用属性：

  • type: 链接类型。'文字' 或 '图片'。
  • num: 显示的链接数量。

[field:...] 字段标签

  • [field:name/]: 链接名称。
  • [field:url/]: 链接地址。
  • [field:logo/]: 链接图片地址（当 type='图片' 时使用）。

其他常用标签

  • {global}: 获取网站的全局配置信息。

    • {global:site_name/}: 网站名称
    • {global:site_url/}: 网站首页地址
    • {global:site_icp/}: 网站备案号

  • {nav}: 获取主导航，比 category 标签更简单,通常用于首页。

    • {nav num='10'}<a href="[field:link/]">[field:name/]</a>{/nav}

  • {ad}: 调用广告位。

    • {ad id='1'/}: 调用 ID 为 1 的广告位内容。

实战演练：制作一个首页

假设我们的网站首页需要包含以下部分：

  1. 顶部导航栏
  2. 轮播图
  3. 公司简介
  4. 产品展示
  5. 最新资讯
  6. 底部版权和友情链接

步骤 1：创建模板文件

在 PageAdmin 后台的“模板管理”中，创建一个新的首页模板，index.html。

步骤 2：编写模板代码

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">{global:site_name/}</title>
    <!-- 引入CSS文件 -->
    <link rel="stylesheet" href="/static/css/style.css">
</head>
<body>
    <!-- 1. 顶部导航栏 -->
    <div class="header">
        <div class="main-nav">
            <ul>
                {nav num='10'}
                    <li><a href="[field:link/]">[field:name/]</a></li>
                {/nav}
            </ul>
        </div>
    </div>
    <!-- 2. 轮播图 (假设后台有专门的轮播图模块) -->
    <div class="banner">
        {ad id='1'/} 
        <!-- 假设ID为1的广告位是轮播图 -->
    </div>
    <!-- 3. 公司简介 -->
    <div class="section company-intro">
        <h2>公司简介</h2>
        {content type='article' cid='2' id='10'}
            [field:content/]
        {/content}
    </div>
    <!-- 4. 产品展示 -->
    <div class="section product-show">
        <h2>产品中心</h2>
        <div class="product-list">
            {list type='product' cid='3' num='6' order='id desc'}
                <div class="product-item">
                    <a href="[field:link/]">
                        <img src="[field:thumb/]" alt="[field:title/]">
                        <h3>[field:title/]</h3>
                    </a>
                </div>
            {/list}
        </div>
    </div>
    <!-- 5. 最新资讯 -->
    <div class="section news-list">
        <h2>最新资讯</h2>
        <ul>
            {list type='article' cid='1' num='8' order='id desc'}
                <li>
                    <a href="[field:link/]">[field:title/]</a>
                    <span class="date">[field:inputtime/]</span>
                </li>
            {/list}
        </ul>
    </div>
    <!-- 6. 底部 -->
    <footer>
        <div class="footer-content">
            <p>版权所有 &copy; {global:now year/} {global:site_name/} | {global:site_icp/}</p>
            <div class="friend-links">
                <span>友情链接：</span>
                {flink type='文字' num='10'}
                    <a href="[field:url/]" target="_blank">[field:name/]</a>
                {/flink}
            </div>
        </div>
    </footer>
</body>
</html>

步骤 3：后台配置

  1. 在后台“内容管理”中，确保你已经创建了文章、产品等内容,并填入了相应数据。
  2. 在“广告管理”中，创建一个 ID 为 1 的广告位,并上传轮播图代码。
  3. 在“友情链接”中,添加一些链接。
  4. 在“页面管理”中，选择你刚刚创建的 index.html 模板,并生成首页。

完成以上步骤后,你的首页就是一个完全由标签驱动的动态页面了！

总结与进阶

  • 核心思想： 理解“模板 + 标签 + 内容”的分离模式。
  • 常用标签： 熟练掌握 {list}, {content}, {category} 这三大核心标签及其属性和子标签 [field:...]。
  • 官方文档： PageAdmin 的官方文档是更权威、更全面的参考资料，当你遇到具体问题时,一定要查阅官方文档。
  • 调试技巧： 如果标签不显示内容，首先检查：
    1. type 和 cid/id 是否正确？
    2. 是否真的存在？
    3. 后台是否已生成页面？
    4. 查看页面源代码,看标签是否被正确解析。

通过学习和实践 PageAdmin 标签，你将能够高效地管理和维护网站，实现内容的动态更新,大大提升开发效率。