在网站运营中，我们经常会遇到需要快速调整某些信息的情况，比如更新帮助页面的链接、更换某个功能开关的状态，或者在页面中显示一些不常变动但又需要灵活修改的自定义文本。如果每次修改都需要深入代码文件，那无疑会大大降低效率。

安企CMS（AnQiCMS）深知这一痛点，因此提供了一套非常便捷的自定义设置机制，让您无需编写代码，就能轻松在后台配置任意内容，并将其呈现在网站模板中。

后台设置：配置您的自定义内容

要实现这一功能，首先我们需要在安企CMS的后台进行简单的配置。这通常涉及到“后台设置”中的“全局功能设置”部分。在这里，您可以找到一个名为“自定义设置参数”的区域。

假设我们想要在网站页脚显示一个指向我们帮助页面的链接，并且这个链接可能会不时更新。我们可以在这里新增一个自定义参数：

  • 参数名 (Parameter Name): HelpUrl (建议使用驼峰命名法，纯英文字母，这样在模板中调用时会更规范和方便)
  • 参数值 (Parameter Value): https://www.yourdomain.com/help (填写您实际的帮助页面URL)
  • 备注 (Remark): 网站帮助页面的链接 (用于说明该参数的用途，方便您和其他运营人员理解)

参数名是您在模板中调用时使用的唯一标识，建议使用清晰、有意义的英文字母。参数值则是您希望展示的具体内容。备注字段则用于内部管理，帮助您和其他运营者理解该参数的用途。

模板调用：将自定义内容呈现在网站上

自定义参数在后台配置完成后，下一步就是将它引入到网站的前端模板中。安企CMS为此提供了强大的模板标签功能，特别是system标签，它是获取网站全局配置信息的核心。

system标签主要用于获取后台“全局功能设置”中配置的各项参数，包括网站名称、网站Logo、备案号，当然也包括我们自定义的参数。

要调用我们刚才设置的HelpUrl，可以在模板文件中（例如 footer.html 或 header.html）使用如下方式：

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

这条代码会直接输出后台为HelpUrl设置的值，并将其作为超链接<a>标签的href属性。

如果您希望将这个值先存储在一个变量中，以便在模板中多次使用或者进行其他逻辑判断，可以这样操作：

{% system helpPageUrl with name="HelpUrl" %}
<a href="{{ helpPageUrl }}" target="_blank">帮助中心</a>
<p>更多信息请访问：{{ helpPageUrl }}</p>

这里，我们先将HelpUrl的值赋给了helpPageUrl这个变量，然后就可以在模板中随心所欲地引用它了。这种方式提高了代码的可读性和维护性，避免了重复调用标签。

超越链接：更多自定义内容的运用

自定义设置参数的强大之处远不止于此。除了简单的URL，您还可以存储其他各种类型的内容，例如：

  • 网站公告文字： 在后台配置一段简短的公告，如“国庆假期暂停发货通知”，前端通过标签显示在顶部导航。
  • 网站统计代码片段： 对于一些公共的、非敏感的第三方集成代码（如网站统计ID），可以通过自定义参数灵活管理，方便更换。
  • 功能开关： 配置一个布尔值（如IsNewFeatureEnabled，值为true或false），在模板中通过{% if %}标签判断是否显示某个新功能模块或某个广告位。
  • 不同地区的联系电话或地址： 如果您的网站服务多个区域，可以通过自定义参数为每个区域预设不同的联系方式，并在模板中通过逻辑判断展示。

结合contact标签（专门用于联系方式）和diy标签（用于更通用的自定义内容），安企CMS为您提供了极大的内容运营灵活性，让您能够轻松应对各种内容展示需求。

小贴士与注意事项

  • 命名规范： 为自定义参数选择清晰、一致的英文命名，方便日后管理和查找。避免使用过于通用或可能与系统内置参数冲突的名称。
  • 适度使用： 避免将大量、频繁变动或具有复杂结构的数据存储为自定义参数，这些更适合通过内容模型或数据列表进行管理，以保持数据的结构化和可维护性。
  • 测试验证： 每次修改自定义参数后，务必清除网站缓存并访问前台页面，确认内容已正确显示。如果内容中包含HTML代码，可能需要使用|safe过滤器来确保其被正确解析而非转义。

通过安企CMS提供的自定义设置和模板标签功能，您可以轻松将后台配置的任意内容呈现在网站前端，极大地提升了网站运营的效率和灵活性。无论是简单的URL更新，还是复杂的文本展示，都可以在不触碰代码的前提下完成，让内容管理变得更加得心应手。

常见问题 (FAQ)

  1. 我可以在自定义参数中直接输入HTML代码吗？如果可以，如何确保它在前台正确显示？ 可以。您可以在自定义参数的“参数值”中输入HTML代码。为了确保这些HTML代码在前台页面被浏览器正确解析而不是作为纯文本显示，您需要在模板调用时使用|safe过滤器。例如：<div>{% system myHtmlContent with name="MyHtmlContent" %}{{ myHtmlContent|safe }}</div>。请注意，使用|safe意味着您信任这些HTML内容的安全性，避免XSS风险。

  2. 我设置了自定义参数，并在模板中引用了，但为什么前台页面没有显示或者显示不正确？ 首先，请检查自定义参数的“参数名”是否与模板中name属性的值完全一致（包括大小写）。其次，修改后台设置后，您可能需要清除网站缓存才能让更改生效。您可以尝试在后台管理界面的“更新缓存”功能中进行清理。如果问题依然存在，请检查您的模板文件是否被正确保存并上传。

  3. 自定义参数和内容模型（如文章、产品模型）有什么区别，我该如何选择？ 自定义参数更适合存储少量、全局性或跨页面复用的，且结构相对简单的单一值内容，例如帮助页面URL、公司简介中的某段文字、网站公告等。它们通常不具备复杂的结构和大量的字段。而内容模型则用于管理大量结构化、多字段的内容，例如文章、产品、用户案例等，这些内容通常有分类、标签、图片、详细内容等复杂属性，并且需要列表展示、详情页展示、搜索等功能。简单来说，自定义参数是“小而巧”的全局配置，内容模型是“大而全”的数据管理。