如何在AnQiCMS后台创建和管理供`{% diy %}`标签使用的自定义参数？

安企CMS作为一款以高效、可定制著称的企业级内容管理系统，其强大的模板标签功能无疑是内容运营者和网站开发者得心应手的好帮手。在日常网站运营中，我们经常会遇到需要快速调整一些全局性、站点层面的配置信息，比如公司Slogan、某个特定活动的链接、或者一个临时的公告文本等，这些信息不像文章内容那样需要复杂的分类和模型，但又比硬编码在模板中更灵活。这时，安企CMS提供的{% diy %}标签和其背后的自定义参数管理机制就显得尤为重要了。

本文将深入探讨如何在AnQiCMS后台创建和管理这些供{% diy %}标签使用的自定义参数，并将其无缝地应用到网站前端，帮助您更好地利用AnQiCMS的灵活性，实现快速响应和高效运营。

理解{% diy %}标签：您的定制化信息中枢

在AnQiCMS的模板体系中，{% diy %}标签扮演着一个“万能信息箱”的角色。不同于{% system %}标签用于获取系统预设的全局信息（如网站名称、Logo、备案号），也不同于{% contact %}标签用于获取联系方式（如电话、邮箱、地址），{% diy %}标签专门用于调用您在后台自定义添加的、具有全局或半全局性质的文本或链接信息。

想象一下，如果您的网站需要在一个特殊时期显示一个“夏季促销进行中！”的横幅，或者您想在页脚加入一个不属于预设联系方式的社交媒体链接，使用{% diy %}标签配合自定义参数，就能轻松实现，而无需修改任何模板代码文件，大大提升了运营效率。

在AnQiCMS后台创建和管理自定义参数

要让{% diy %}标签有内容可“取”，我们首先需要在AnQiCMS后台定义这些自定义参数。这个过程非常直观。

您会发现，在AnQiCMS后台，全局功能设置和联系方式设置这两个模块都提供了“自定义设置参数”的功能。这意味着，{% diy %}标签可以灵活地调用您在这两个区域定义的自定义参数。这为参数的逻辑归类提供了一定的便利性，例如，与联系相关的自定义链接可以放在“联系方式设置”中，而其他更通用的信息则可以放在“全局功能设置”里。

让我们以在“全局功能设置”中添加一个公司愿景（Company Mission）的自定义参数为例：

1. 导航至设置页面：首先，登录您的AnQiCMS后台管理界面。在左侧导航栏中，找到并点击系统设置，然后选择全局功能设置。

2. 定位自定义参数区域：在“全局功能设置”页面中，向下滚动，您会看到一个名为“自定义设置参数”的区域。这里就是我们添加个性化配置的地方。

3. 添加新的自定义参数：点击添加自定义参数按钮，此时会弹出或展开一个表单，供您填写参数信息。

   • 参数名：这是最关键的一个字段，它决定了您在模板中调用此参数时所使用的名称。建议您使用英文字母，并遵循驼峰命名法（如CompanyMission、HolidayNotice），这样既能保持命名的清晰性，也方便在模板中进行调用。请注意，这个参数名在整个网站中应该是唯一的，以避免混淆。
   • 参数值：这里就是您要存储的实际内容了，可以是纯文本、HTML代码片段、URL链接等。例如，我们可以填写“引领行业创新，赋能企业发展”。
   • 备注：这是一个可选但强烈推荐填写的字段。在这里，您可以简要描述此参数的用途，例如“公司对外展示的核心愿景”，这对于团队协作和日后参数维护非常有帮助。

4. 保存更改：填写完毕后，点击保存按钮，您的自定义参数就成功添加并生效了。

通过同样的方式，您可以在“联系方式设置”中添加与联系方式相关的自定义参数，比如一个特定的WhatsApp群组链接或者一个客服在线时间段描述。

在前端模板中使用{% diy %}标签

自定义参数创建完成后，接下来就是在网站模板中巧妙地运用{% diy %}标签来显示这些信息了。AnQiCMS的模板引擎采用了类似Django模板引擎的语法，让变量和标签的使用变得非常直观。

{% diy %}标签的基本使用方式与{% system %}和{% contact %}类似，通过name属性指定要调用的参数名。

例如，我们想在网站的页眉或页脚展示刚才设置的“公司愿景”：

{# 直接输出自定义参数的值 #}
<p>我们的愿景：{% diy with name="CompanyMission" %}</p>

{# 将自定义参数的值赋值给一个变量，再进行输出和处理 #}
{% diy missionText with name="CompanyMission" %}
{% if missionText %}
    <p>我们的愿景是：{{ missionText }}</p>
{% else %}
    <p>暂无公司愿景信息。</p>
{% endif %}

在上面的代码片段中：

• {% diy with name="CompanyMission" %}会直接输出名为CompanyMission的自定义参数值。
• {% diy missionText with name="CompanyMission" %}则将CompanyMission参数的值赋给了一个名为missionText的模板变量。这样做的好处是，您可以对这个变量进行进一步的逻辑判断（如{% if missionText %}）、字符串处理（如果AnQiCMS的过滤器支持）或者与页面的其他内容结合使用，使得模板更具动态性和健壮性。

请注意，{% diy %}标签支持的所有参数，例如siteId，也同样适用于自定义参数的调用，如果您有管理多个站点的需求，可以指定siteId来获取特定站点的自定义参数。

通过这种方式，您可以将各种运营信息、公告、促销口号等，轻松地从后台推送到网站前台，实现内容的快速更新和灵活管理，而无需触碰一行代码，这正是AnQiCMS作为企业级内容管理系统所带来的强大便利。

常见问题 (FAQ)

1. {% diy %}标签与{% system %}或{% contact %}标签有何区别？ {% system %}和{% contact %}标签是用于调用AnQiCMS系统预设的全局信息（如网站名称、Logo、备案号）和联系方式（如电话、邮箱）的。而{% diy %}标签则专门用于调用您在后台“全局功能设置”或“联系方式设置”的自定义参数区域中手动创建的、个性化的、非预设的参数。简单来说，前者是内置项，后者是您的扩展项。

2. 我能否使用{% diy %}标签为特定的文章或产品添加自定义字段？ 不能。{% diy %}标签是为站点层面或全局性的自定义参数设计的。如果您需要为特定的文章、产品或其他内容模型添加自定义字段（例如，文章的“作者”字段、产品的“颜色”选项），您应该在内容管理 -> 内容模型中定义这些模型字段。这些模型字段会在编辑具体文章或产品时显示，并通过{% archiveDetail %}或{% archiveParams %}等标签进行调用，而不是{% diy %}。

3. 如果我调用的{% diy %}参数不存在，会发生什么？ 如果{% diy %}标签尝试调用的参数名在后台并未定义，AnQiCMS模板引擎通常会返回一个空值或者不输出任何内容，而不是抛出错误导致页面崩溃。为了增强模板的健壮性，您可以在模板中使用条件判断（如{% if yourDiyParameter %}）来检查参数是否存在或是否有值，从而避免显示不必要或缺失的信息。