在安企CMS中，后台自定义系统参数的灵活运用，是提升网站可维护性和运营效率的关键。许多时候，我们可能需要一些系统默认字段未能涵盖的信息，例如特定的外部链接、额外的企业荣誉信息、或是某个特定活动的专属文案。安企CMS提供了便捷的方式来添加这些自定义参数，并确保它们能在前端模板中准确无误地呈现。
一、理解自定义系统参数的设置位置
首先，我们需要明确自定义系统参数在安企CMS后台的设置入口。主要有两个地方可以进行此类操作：
- 全局功能设置 (System Settings)： 访问后台的“后台设置”菜单，选择“全局功能设置”。在这里，除了可以设置网站名称、Logo、备案号等基础信息外，您还可以找到“自定义设置参数”区域。这个区域允许您添加适用于全站的自定义信息。
- 联系方式设置 (Contact Settings)： 同样在“后台设置”菜单下，选择“联系方式设置”。除了联系人、电话、邮箱等常规字段，这里也设有“自定义设置参数”，专门用于添加与网站联系方式相关的额外信息，例如WhatsApp账号、Facebook主页链接等。
在这两个地方添加自定义参数时，您需要填写三个关键项：“参数名”、“参数值”和“备注”。其中，“参数名”是重中之重，它将是您在前端模板中调用该自定义参数的唯一标识。请注意，系统会自动将您输入的参数名转换为驼峰命名法（即每个单词的首字母大写，中间无空格），在模板中调用时，您需要使用这个转换后的驼峰命名参数名。而“参数值”则是您希望在网站前端显示的具体内容，“备注”则用于方便您自己记忆和管理该参数的用途。
二、在前端模板中正确调用自定义参数
一旦自定义参数在后台设置完毕，下一步便是在前端模板中将其调用出来。安企CMS提供了专门的模板标签来实现这一点：
调用全局功能设置中的自定义参数： 对于在“全局功能设置”中添加的自定义参数，您需要使用
{% system %}标签来调用。例如，如果您在后台设置了一个名为HelpUrl的参数（参数名为HelpUrl），其值为“https://www.example.com/help”，那么在模板中，您可以通过以下方式显示它：<a href="{% system with name="HelpUrl" %}" target="_blank">帮助页面</a>如果您希望将参数值先赋值给一个变量再使用，可以这样操作：
{% system helpPageLink with name="HelpUrl" %} <a href="{{ helpPageLink }}" target="_blank">帮助中心</a>调用联系方式设置中的自定义参数： 同理，对于在“联系方式设置”中添加的自定义参数，则需要使用
{% contact %}标签。例如，如果您添加了一个名为WhatsApp的参数，其值为“+1234567890”，在模板中调用时，您可以这样写：<p>WhatsApp 联系：{% contact with name="WhatsApp" %}</p>或者赋值给变量：
{% contact whatsAppNumber with name="WhatsApp" %} <a href="https://wa.me/{{ whatsAppNumber }}" target="_blank">联系我们（WhatsApp）</a>
重要提示：
- 参数名（name属性）务必与后台自动转换后的驼峰命名保持一致。 例如，如果您在后台输入的参数名是“帮助链接”，系统可能会将其转换为
HelpLink，那么在模板中就必须使用name="HelpLink"。 - 如果您的自定义参数值中包含HTML代码（比如一个链接、一个图片标签，或者一段带格式的文字），为了确保这些HTML代码能够被浏览器正确解析而不是直接显示为文本，您需要在输出变量时加上
|safe过滤器。例如：{% system customHtmlContent with name="CustomHtml" %} <div>{{ customHtmlContent|safe }}</div>
三、实践中的一些建议
- 命名规范化： 尽量使用英文单词来定义“参数名”，并保持其简洁、有意义，这样更便于记忆和在模板中调用。例如，
SiteEmail比网站邮箱更通用。 - 区分使用场景： 全局设置的参数适用于全站通用信息，而联系方式设置的参数则更侧重于各种联系方式。合理分类有助于后期管理。
- 及时测试： 每当您在后台设置或修改了自定义参数后，务必立即在前端对应的页面上查看显示效果，以确保参数被正确调用。
- 利用备注字段： 后台的“备注”字段虽然不会在前端显示，但对于复杂的自定义参数，它可以帮助您记录参数的用途、值类型或注意事项，方便团队协作和未来的维护。
通过上述方法，您就能轻松地在安企CMS后台定义和管理各种自定义系统参数，并在前端模板中灵活调用，从而大大增强网站的个性化和可管理性。
常见问题 (FAQ)
1. 我在后台设置的自定义参数，为什么在前端模板中调用时无法显示？
这通常有几个原因。首先，请检查您在模板中使用的标签（{% system %} 或 {% contact %}）是否与后台设置的区域匹配。其次，最重要的可能是“参数名”的拼写问题。请确保 name 属性的值与后台参数名自动转换后的驼峰命名（例如 HelpUrl 而不是 helpurl 或 help_url）完全一致。此外，确认该参数在后台已保存成功，并且没有被其他配置覆盖。
2. 我的自定义参数值是图片或链接，但前端显示时只有纯文本，链接不可点击，图片也未显示，这是为什么？
如果您的自定义参数值本身就是HTML代码（例如 <img src="..." /> 或 <a href="...">链接文本</a>），那么在前端模板输出该变量时，需要额外添加 |safe 过滤器。例如 {{ myImageVar|safe }}。这是为了告诉模板引擎，这段内容是安全的HTML，不需要进行转义处理，从而确保浏览器能将其正确解析并呈现出来。
3. 我可以自定义哪些类型的系统参数？有没有数量限制？ 安企CMS的自定义参数功能非常灵活，您可以根据需要添加任何文本、数字、链接、简单的HTML代码片段等类型的数据。例如，您可以添加公司使命、特定活动的截止日期、客服在线时间段等。理论上，可添加的自定义参数数量没有严格限制，但为了系统的性能和管理便利性，建议根据实际需求进行合理规划。对于复杂的、结构化的内容，可能更适合通过“内容模型”或“单页面”功能来实现。