AnQiCMS如何在后台配置自定义参数，并在前台模板中灵活调用显示？

在网站运营中，我们经常会遇到需要为内容或网站全局添加一些标准字段之外的个性化信息。这些信息可能是网站的特色功能描述、产品参数、文章的特定属性，甚至是多渠道联系方式等。安企CMS（AnQiCMS）深知这种灵活性的重要性，因此提供了强大的自定义参数配置功能，让您可以轻松在后台定义所需数据，并在前台模板中灵活地调用和展示。

接下来，我们将深入探讨如何在安企CMS后台配置这些自定义参数，以及如何在您的网站前台模板中巧妙地运用它们。

第一部分：在安企CMS后台配置自定义参数

安企CMS的自定义参数配置主要分为两大类：针对网站全局设置和联系方式的自定义参数，以及针对不同内容模型（如文章、产品）的自定义字段。

1. 配置全局与联系方式的自定义参数

网站的全局信息和联系方式往往需要根据业务变化进行调整，而每次都修改模板代码显然不是高效的解决方案。安企CMS允许您直接在后台添加这些通用的自定义参数。

操作路径： 登录安企CMS后台，您可以在左侧菜单找到“后台设置”。

  • 全局设置： 进入“全局功能设置”页面，拉到底部会看到一个“自定义设置参数”的区域。
  • 联系方式： 进入“联系方式设置”页面，同样在底部有“自定义设置参数”区域。

配置方法： 点击“添加参数”按钮，您会看到三个输入框：

  • 参数名： 这是您在模板中调用时使用的唯一标识。建议使用英文或拼音，例如“HelpUrl”、“WhatsApp”。系统会自动将其转换为驼峰命名。
  • 参数值： 对应这个参数的实际内容，比如一个帮助页面的URL，或者您的WhatsApp账号。
  • 备注： 用于描述这个参数的用途，方便日后管理和理解。

通过这种方式，您可以轻松地添加例如公司荣誉资质、特色服务链接、多语种网站的切换提示等全局信息，或是除了电话邮箱之外的更多社交媒体联系方式。

2. 配置内容模型的自定义字段

对于文章、产品、活动等不同类型的内容，它们需要展示的信息结构往往大相径庭。例如，一篇产品介绍可能需要“颜色”、“尺寸”、“材质”等属性，而一篇新闻文章则可能需要“作者”、“来源”、“阅读时长”等。安企CMS的内容模型自定义字段功能正是为解决这类需求而设计。

操作路径： 在安企CMS后台，选择“内容管理”菜单，然后点击“内容模型”。这里列出了您网站所有的内容模型，例如默认的“文章模型”和“产品模型”。

配置方法：

  1. 编辑或新增模型： 您可以选择编辑一个现有模型，也可以点击“新增模型”来创建一个全新的内容类型。
  2. 添加自定义字段： 进入模型编辑页面，找到“内容模型自定义字段”区域。点击“添加字段”按钮，将弹出字段配置界面：
    • 参数名： 这是后台编辑人员在发布或修改内容时看到的字段中文名称，如“文章来源”、“产品颜色”。
    • 调用字段： 这是前台模板中用于获取该字段值的唯一英文标识。请确保其名称简洁且具有描述性，例如“source”、“color”。这个字段名会直接作为数据库字段进行存储。
    • 字段类型： 安企CMS提供了多种字段类型来适应不同的数据格式：
      • 单行文本： 适用于短文本输入，如作者名、文章来源。
      • 数字： 仅允许输入数字，如价格、库存。
      • 多行文本： 适用于较长的文本内容，如产品详情的简要介绍。
      • 单项选择/多项选择/下拉选择： 这些类型适用于需要预设选项供选择的场景，如产品颜色（红、蓝、黑）、房屋类型（住宅、商铺）。
    • 是否必填： 根据业务需求决定该字段是否为必填项。
    • 默认值： 为字段设置一个初始值。对于选择类型，这里则用于定义所有可选的选项，每行输入一个选项。

完成自定义字段的配置后，当您在“内容管理”中添加或编辑相应模型下的文档时，在“其他参数”区域便会看到您刚刚定义的这些自定义字段，可以直接填写内容。

第二部分：在前台模板中灵活调用显示

配置好后台参数后，下一步就是在前台模板中将这些数据展示给访问者。安企CMS的模板引擎语法类似Django，通过简洁的标签即可实现数据的调用。

1. 调用全局与联系方式的自定义参数

对于在“全局功能设置”和“联系方式设置”中添加的自定义参数，安企CMS提供了特定的标签进行调用：

  • 全局自定义参数： 使用 {% system %} 标签。 如果您在后台全局设置中添加了一个名为“HelpUrl”（帮助页面链接）的参数，其值为https://www.yourdomain.com/help，您可以在模板中这样调用：

    <a href="{% system with name="HelpUrl" %}">访问帮助中心</a>

  • 联系方式自定义参数： 使用 {% contact %} 标签。 如果您在后台联系方式设置中添加了一个名为“WhatsApp”（WhatsApp账号）的参数，其值为+1234567890，您可以这样调用：

    <span>我们的WhatsApp：{% contact with name="WhatsApp" %}</span>

2. 调用内容模型的自定义字段

内容模型的自定义字段通常在文档详情页或列表页使用，安企CMS提供了多种灵活的调用方式。

  • 直接调用指定自定义字段： 在文档详情页，如果您为文章模型定义了一个“作者（author）”字段，您可以直接通过 archive.author 或 {% archiveDetail with name="author" %} 来获取并显示：

    <p>作者：{{ archive.author }}</p>
{# 或者，如果您想在当前文档之外指定其他文档ID #}
<p>文章来源：{% archiveDetail with name="source" id="10" %}</p>

    对于分类、单页面、标签等，也有类似的 categoryDetail、pageDetail、tagDetail 标签来直接调用其自定义字段。例如，分类的“Banner”字段：

    <img src="{% categoryDetail with name="Banner" %}" alt="分类Banner">

  • 循环展示所有自定义字段： 有时，您可能希望在一个区域动态展示某个内容项（如产品）的所有自定义参数，而不必一个一个地单独调用。{% archiveParams %} 标签便是为此设计。它会返回一个包含所有自定义字段名称和值的数组，您可以使用 for 循环遍历显示：

    <h3>产品参数详情</h3>
<ul>
{% archiveParams params %}
    {% for item in params %}
    <li>
        <span>{{item.Name}}：</span> {# 这是后台设置的“参数名”（中文显示） #}
        <span>{{item.Value}}</span> {# 这是该参数的实际值 #}
    </li>
    {% endfor %}
{% endarchiveParams %}
</ul>

    这个