如何利用AnQiCMS模板标签在前端页面动态地展示内容数据？
📅
👁️ 69
轻松驾驭AnQiCMS模板标签：让网站内容鲜活起来！
在今天的数字世界里，一个能动态展示内容的网站远比静态页面更能吸引访客、提升用户体验。安企CMS（AnQiCMS）为我们提供了一套强大而直观的模板标签系统，无需编写复杂的代码，就能将后台数据灵活地呈现在网站前端。这就像拥有了一系列魔法咒语，轻点几下，网站内容便能鲜活起来。
AnQiCMS的模板标签设计借鉴了Django模板引擎的语法，熟悉这种模式的开发者会感到亲切，即使是初次接触的用户也能快速上手。它主要通过两种形式的标签来操作：
{% ... %}：这类标签用于控制逻辑流，比如条件判断（if）、循环遍历（for）、调用特定的内容块或功能标签。{{ ... }}：这类标签则用于直接输出数据，如文章标题、网站名称、图片链接等。
掌握了这两种标签，您就能在AnQiCMS的前端模板中实现数据的动态展示和页面的灵活布局。
开启动态内容展示：从全局信息到导航菜单
首先，我们通常会从网站的全局信息入手。AnQiCMS提供了一系列便捷的标签，让您轻松调用系统层面的配置：
- 网站基本信息：使用
{% system ... %}标签，您可以轻松获取网站名称、Logo、备案号、版权信息等全局设置。比如，要显示网站名称，只需在模板中写入{{ system("SiteName") }}。在页脚展示备案号和版权信息，也不过是{{ system("SiteIcp") }}和{{ system("SiteCopyright")|safe }}这样的简洁语句（请注意，版权内容可能包含HTML，使用|safe过滤器可以确保它被正确解析）。 - 联系方式：通过
{% contact ... %}标签，后台设置的联系人、电话、地址、邮箱、微信等信息都能动态显示在页面的任何位置。例如，显示联系电话是{{ contact("Cellphone") }}。 - SEO优化信息：
{% tdk ... %}标签则专注于页面的SEO元素，包括Title、Keywords、Description。这些标签能根据当前页面类型（首页、文章详情页、分类页等）自动获取相应内容，确保每个页面的SEO设置都是最优的。例如，在<head>标签中设置页面标题：<title>{{ tdk("Title", siteName=true) }}</title>，这里的siteName=true会自动将网站名称追加到标题末尾，符合SEO**实践。
除了这些全局信息，网站的导航菜单也是动态展示内容的关键。通过 {% navList navs %} 标签，您可以获取并循环遍历后台配置的导航项。这使得更新菜单变得异常简单，无需修改模板文件，只需在后台调整即可。多级导航也能通过标签的 NavList 属性轻松实现嵌套显示。
核心内容呈现：文章、产品与自定义字段
网站的核心价值往往体现在其发布的文章、产品或其他类型的内容上。AnQiCMS在这方面提供了极其灵活和强大的标签：
- 内容列表展示：
{% archiveList archives with ... %}是显示文章或产品列表的利器。您可以通过各种参数精确控制要显示的内容：moduleId="1"或moduleId="2"：指定内容模型，如文章（1）或产品（2）。categoryId="10"：指定显示特定分类下的内容。limit="5"：控制显示的数量。order="views desc"：按浏览量倒序排列。type="page"：开启分页模式，配合{% pagination pages %}标签可实现完整的翻页功能。 您可以使用{% for item in archives %}来循环显示列表中的每一项，并通过{{ item.Title }}、{{ item.Link }}、{{ item.Thumb }}等属性来调用标题、链接、缩略图等。
- 内容详情页：在文章或产品的详情页，
{% archiveDetail with name="Title" %}标签能够直接获取当前内容的详细信息。例如，要显示文章内容，可以使用{{ archiveDetail("Content")|safe }}。请注意，内容字段通常包含HTML，所以|safe过滤器是不可或缺的，它告诉模板引擎按HTML解析这段文本，而不是将其作为纯文本输出。 - 上下篇及相关内容：
{% prevArchive prev %}和{% nextArchive next %}标签可以轻松实现文章详情页的上一篇和下一篇导航。而{% archiveList archives with type="related" limit="3" %}则能智能地根据当前文章，列出相关推荐内容，极大地提升用户粘性。 - 灵活的内容模型与参数：AnQiCMS的“灵活内容模型”是其亮点之一。如果您为产品模型添加了“价格”、“型号”等自定义字段，可以通过
{% archiveParams params %}标签在详情页循环展示这些额外参数，甚至直接通过{{ archiveDetail("您自定义的字段名") }}来调用。这使得网站能适应各种复杂的业务需求。
除了文章和产品，单页面（如“关于我们”、“联系我们”）同样可以通过 {% pageList pages %} 和 {% pageDetail ... %} 标签进行管理和展示，其使用方式与文章类似，简单直观。
提升互动性：标签、留言与友情链接
一个活跃的网站离不开用户互动和信息互联：
- 标签云与标签列表：
{% tagList tags %}标签可以帮助您展示网站上的热门标签，或与当前内容相关的标签。用户点击标签后，{% tagDataList archives with tagId="..." %}就能根据标签ID显示所有关联的内容列表，方便用户快速发现感兴趣的信息。 - 留言表单：通过
{% guestbook fields %}标签，您可以轻松生成动态的留言表单。后台自定义的字段（如姓名、联系方式、留言内容）会通过此标签自动生成相应的表单元素，极大地方便了用户提交信息。 - 友情链接：
{% linkList friendLinks %}标签则用于显示后台设置的友情链接，便于网站间的互联互通。
掌握流程控制与数据精炼：条件、循环与过滤器
为了让模板更加智能和强大，AnQiCMS还提供了通用的流程控制标签和数据处理过滤器：
- 条件判断（
if/elif/else）：这是模板中最基础的逻辑控制。比如，您可以判断一张图片是否存在再决定是否显示它：{% if item.Thumb %} <img src="{{ item.Thumb }}" alt="{{ item.Title }}" /> {% else %} <img src="/static/images/default.jpg" alt="默认图片" /> {% endif %} - 循环遍历（
for/empty）：在展示列表数据时，for循环是不可或缺的。它能遍历数组或切片中的每一项。如果循环体为空，{% empty %}标签可以用来显示“暂无内容”的提示，提升用户体验。
您还可以在循环中利用{% for item in archives %} <li><a href="{{ item.Link }}">{{ item.Title }}</a></li> {% empty %} <li>当前没有文章。</li> {% endfor %}forloop.Counter来获取当前循环的索引，实现序号显示等效果。 - 数据过滤器（
|filter）：过滤器是用来对变量进行格式化或处理的工具，使用|符号连接。{{ item.CreatedTime | stampToDate("2006-01-02") }}：将时间戳格式化为“年-月-日”的日期格式。{{ item.Content | safe }}：确保HTML内容被正确解析。{{ item.Description | truncatechars:100 }}：截取描述的前100个字符，并自动添加省略号。 灵活运用这些过滤器，能让您的内容展示更加专业和规范。
总结与实践建议
AnQiCMS的模板标签系统旨在简化网站内容的动态展示，让内容运营者和模板开发者都能专注于内容的创作与用户体验的提升。通过灵活运用这些标签，您能够：