`{% diy %}`标签的`name`参数应该如何正确设置才能获取到后台自定义数据？

安企CMS（AnQiCMS）作为一个高效、灵活的内容管理系统，其强大的自定义功能是网站运营者提升效率、实现个性化展示的重要法宝。在日常内容运营中，我们经常会遇到需要调用后台预设但又非标准字段数据的情况，而{% diy %}标签正是为此而生。那么，这个标签的name参数究竟该如何设置，才能准确无误地获取到后台的自定义数据呢？让我们深入探讨一番。

揭秘{% diy %}标签：解锁后台自定义数据宝藏

在安企CMS的模板世界里，{% diy %}标签扮演着一个非常实用的角色：它让我们可以灵活地获取那些不属于系统预设字段，但又希望在前端页面展示的自定义全局数据。想象一下，你可能希望在网站页脚显示一个公司年度口号，或者在侧边栏展示一个特别活动入口，这些信息通常不需要与具体的文章或产品绑定，而是作为网站整体的一部分。这时，{% diy %}标签就是你的得力助手。

name参数的核心秘密：精准匹配后台设置

要正确使用{% diy %}标签，最关键的一步就是理解其name参数的设置规则。简而言之，name参数的值，必须精确匹配你在安企CMS后台“全局设置”或“联系方式设置”等模块中，添加自定义参数时所填写的“参数名”。

这意味着，当你在后台创建一个自定义数据项时，那个赋予它的唯一“参数名”就是前端{% diy %}标签中name参数所期待的值。它是连接后台数据与前端模板的桥梁。

数据源头：在后台哪里设置自定义数据？

为了让{% diy %}标签有数据可取，我们首先需要在安企CMS的后台进行相应的设置。通常，这些全局性的自定义数据会在以下两个主要位置进行配置：

1. 全局设置中的自定义参数（推荐用于网站通用信息） 进入后台，找到“后台设置”菜单下的“全局设置”。在这里，你会看到一个“自定义设置参数”的区域。点击“添加”按钮，你就可以定义新的自定义数据项了。

   • 参数名： 这是最重要的字段！例如，你可以填写CompanySlogan、SupportEmail、WeChatOfficialAccount等。这个名称将直接作为{% diy %}标签name参数的值。
   • 参数值： 填写该参数实际对应的内容，比如您的信任，我们守护！或support@yourcompany.com。
   • 备注： 用于内部管理，方便你记住这个参数的用途。

2. 联系方式设置中的自定义参数（推荐用于企业联系方式扩展） 与“全局设置”类似，“后台设置”下的“联系方式设置”也提供了“自定义设置参数”的功能。如果你需要添加除了默认联系方式（如电话、地址）以外的特定联系信息，比如Telegram账号、Skype ID等，可以在这里进行添加。其设置逻辑与全局设置中的自定义参数完全一致。

小贴士： 在填写“参数名”时，虽然安企CMS在某些情况下会自动将中文或包含空格的参数名转换为驼峰命名（例如“公司口号”可能会转换为CompanyKouHao），但为了保持模板代码的简洁性和可读性，强烈建议直接使用英文字母、数字和下划线的组合作为“参数名”，并遵循驼峰命名法则（如CompanySlogan），这样可以确保前后端调用的一致性和易维护性。

实战演示：正确设置name参数

让我们通过一个具体的例子来看看如何操作。

场景： 你想在网站页脚显示公司的年度口号，这个口号需要在后台可以随时修改。

第一步：后台设置自定义参数

1. 登录安企CMS后台。
2. 导航到“后台设置” -> “全局设置”。
3. 在“自定义设置参数”区域，点击“添加”按钮。
4. 在弹出的表单中：
   • 参数名： 填写 AnnualSlogan （注意这里我们使用了驼峰命名）。
   • 参数值： 填写 科技赋能未来，智慧连接世界。
   • 备注： 填写 公司年度宣传口号。
5. 点击“确定”保存。

第二步：前端模板中使用{% diy %}标签 现在，你可以在你的模板文件（比如partial/footer.html或其他你希望展示口号的位置）中，使用{% diy %}标签来获取并显示这个年度口号：

{# 直接输出自定义参数的值 #}
<p class="company-slogan">{% diy with name="AnnualSlogan" %}</p>

{# 或者，将值赋给一个变量再输出，方便进一步处理 #}
{% diy currentSlogan with name="AnnualSlogan" %}
<p class="company-slogan-dynamic">{{ currentSlogan }}</p>

运行网站，你将会在页脚看到：

<p class="company-slogan">科技赋能未来，智慧连接世界</p>
<p class="company-slogan-dynamic">科技赋能未来，智慧连接世界</p>

你看，只要name参数的值（AnnualSlogan）与后台设置的“参数名”完全一致，{% diy %}标签就能准确地将对应的“参数值”提取到前端页面。

为什么选择{% diy %}：运营效率的提升

正确掌握{% diy %}标签的用法，特别是name参数的设置，对网站运营来说意味着：

• 集中管理： 所有非内容主体的自定义信息，都可以在后台统一配置，避免了硬编码在模板中，提高了管理效率。
• 灵活迭代： 当这些信息需要更新时，只需在后台修改一次，全站所有调用该{% diy %}标签的地方都会自动同步更新，无需触碰代码。
• 降低风险： 减少了直接修改模板文件的频率，从而降低了因误操作导致网站出现问题的风险。
• 内容与表现分离： 进一步实现了网站内容与模板表现的有效分离，让内容运营和模板设计可以并行不悖。

常见问题解答 (FAQ)

在理解{% diy %}标签的name参数设置过程中，你可能还会遇到一些疑问。下面列出几个常见问题及其解答：

1. {% diy %}标签能获取哪些类型的数据？例如，能否获取图片或复杂的HTML片段？

{% diy %}标签主要用于获取后台“自定义参数”中存储的文本字符串数据。这可以是纯文本、URL链接、短语，甚至是小段的HTML代码。如果你在后台的“参数值”中填写了一个图片链接或者一段HTML代码，{% diy %}标签会原样输出这些字符串。在模板中，你可以结合<img>标签使用输出的图片链接，或者使用|safe过滤器安全地渲染HTML片段。但它并不直接支持复杂的富文本编辑器内容或文件上传。

2. 在安企CMS的多站点模式下，{% diy %}标签如何获取特定站点的数据？

{% diy %}标签支持siteId参数。如果你在后台启用了多站点管理，并且希望获取非当前站点的自定义数据，可以通过指定siteId来实现。例如，{% diy with name="AnnualSlogan" siteId="2" %}将尝试获取ID为2的站点的AnnualSlogan参数。如果未指定siteId，它将默认获取当前站点的自定义数据。

3. 如果后台的自定义参数名包含中文或特殊字符，前端name参数应该如何填写？

根据安企CMS的设计，后台设置自定义参数时，建议的“参数名”是英文字母和数字的组合。虽然系统在处理“全局设置”和“联系方式设置”中的自定义参数时，会将中文参数名自动转换为驼峰命名以供模板调用，但为避免不必要的混淆和潜在的编码问题，强烈建议在设置“参数名”时直接使用英文驼峰命名法则（例如CompanySlogan而不是公司口号），这样前端name参数就能与其直接匹配，确保代码清晰和调用准确。如果后台已经使用了中文作为参数名，你需要查看具体在哪个位置设置的，并按照其转换后的驼峰命名形式在name参数中填写。

希望这篇文章能帮助你更好地理解和运用安企CMS的{% diy %}标签，让你的网站运营更加得心应手