安企CMS自定义系统参数如何定义和在模板中调用？

在安企CMS的日常运营中，我们经常需要处理各种网站级的配置信息。这些信息可能包括公司统一的联系方式、特定业务流程相关的链接，甚至是用于特定功能的全局开关。为了满足这种灵活多变的需求，安企CMS提供了自定义系统参数的功能，它使得网站运营人员无需深入代码，即可高效地管理和更新这些全局性设置。

自定义系统参数本质上是网站层面的配置项，它们与具体的文章、产品或分类内容无关，而是对整个网站或特定站点生效。这种参数的优势在于集中管理和快速调用。一旦在后台定义，它们就可以在网站的任何模板文件中被轻松引用，极大地提升了内容更新和模板维护的效率。

定义安企CMS自定义系统参数

在安企CMS中，自定义系统参数的定义主要集中在后台的“全局设置”和“联系方式设置”这两个区域。

首先，访问您的安企CMS后台管理界面。

  1. 全局设置中的自定义参数：

    • 导航至“后台设置”下的“全局功能设置”。
    • 在页面底部的“自定义设置参数”区域，您可以添加新的参数。
    • 每个自定义参数需要填写三个关键信息：“参数名”、“参数值”和“备注”。
      • 参数名：这是您在模板中调用该参数时使用的唯一标识。请注意，系统会自动将输入的参数名转换为驼峰命名法（即每个单词的首字母大写，中间不含空格）。例如，如果您输入“HelpUrl”，它将直接作为HelpUrl用于模板调用。
      • 参数值：这是该自定义参数实际存储和将在前端显示的内容。它可以是文本、URL链接、数字等。
      • 备注：这仅用于后台管理人员对参数的说明和识别，不会在前端模板中显示。
    • 完成填写后，保存设置即可。

  2. 联系方式设置中的自定义参数：

    • 导航至“后台设置”下的“联系方式设置”。
    • 与全局设置类似，在页面底部的“自定义设置参数”区域，您可以添加与联系方式相关的自定义参数。
    • 填写“参数名”、“参数值”和“备注”的规则与全局设置相同。例如，您可以添加一个名为WhatsApp的参数，用于存储公司的WhatsApp联系方式。
    • 保存设置以使参数生效。

通过这种方式，您可以根据网站的实际需求，灵活地扩展系统默认提供的参数，满足个性化的配置需求。

在模板中调用安企CMS自定义系统参数

定义好自定义参数后，接下来就是如何在前端模板中将它们展现出来。安企CMS提供了专门的标签来调用这些系统级参数，这些标签的使用方法简洁直观，遵循Django模板引擎的语法规则。

  1. 调用全局设置中的自定义参数： 对于在“全局功能设置”中定义的自定义参数，我们需要使用system标签来调用。 其基本调用格式是：{% system 变量名称 with name="字段名称" %}。

    • 如果您希望直接输出参数值而不将其赋给一个变量，可以直接使用： 
      
<div>我的帮助页面链接：{% system with name="HelpUrl" %}</div>
    • 如果您想将参数值赋给一个局部变量，以便在模板中多次使用或进行进一步处理，可以使用： 
      
{% system helpLink with name="HelpUrl" %}
<p>如需帮助，请访问：<a href="{{ helpLink }}">{{ helpLink }}</a></p>
      请记住，name属性的值必须与您在后台“全局功能设置”中定义的“参数名”保持一致（注意大小写，虽然后台会自动处理驼峰命名，但模板中仍需确保准确匹配）。

  2. 调用联系方式设置中的自定义参数： 对于在“联系方式设置”中定义的自定义参数，则使用contact标签进行调用。 其基本调用格式与system标签类似：{% contact 变量名称 with name="字段名称" %}。

    • 直接输出参数值： 
      
<p>我们的WhatsApp联系方式是：{% contact with name="WhatsApp" %}</p>
    • 将参数值赋给一个局部变量： 
      
{% contact whatsappNumber with name="WhatsApp" %}
<p>加我WhatsApp：{{ whatsappNumber }}</p>
      同样，name属性的值应与您在后台“联系方式设置”中定义的“参数名”精确匹配。

  3. 多站点环境下的参数调用： 在安企CMS支持多站点管理的环境中，如果您需要调用其他站点的系统参数，可以在system和contact标签中额外添加siteId参数来指定站点ID。 例如：

    <div>其他站点的网站名称：{% system with name="SiteName" siteId="2" %}</div>

    这使得跨站点的数据调用变得可行。

实际应用场景与**实践

自定义系统参数的应用场景非常广泛，例如：

  • 社交媒体链接：统一管理Facebook、Twitter、LinkedIn等社交平台的URL。
  • 客服联系方式：除了电话邮箱，还可以是Skype ID、在线客服链接等。
  • 全局通知信息：例如网站维护公告、节日问候语。
  • API密钥或第三方服务链接：用于某些集成服务的通用参数。
  • 业务特定配置：例如一个产品展示网站可能需要一个“产品咨询热线”参数。

使用自定义参数的**实践包括：

  • 保持命名清晰：参数名应具有描述性，让人一眼就能理解其用途。
  • 区分作用域：将全局性的网站配置放在“全局设置”中，而与联系方式强相关的则放在“联系方式设置”中。
  • 避免过度使用：对于内容模型（文章、产品）中特有的属性，应通过内容模型自定义字段来管理，而不是滥用系统参数。系统参数更适合那些贯穿整个网站的通用配置。
  • 及时更新备注：为每个自定义参数添加详细的备注，方便团队成员理解和维护。

安企CMS的自定义系统参数功能，为网站运营人员提供了一套强大且灵活的工具。它不仅简化了网站配置的管理，也为模板开发带来了更高的自由度和效率。通过合理地定义和调用这些参数，我们可以构建出更易于维护、响应迅速的动态网站。

常见问题解答 (FAQ)

1. 哪些类型的信息最适合作为安企CMS的自定义系统参数？

自定义系统参数最适合存储那些对整个网站或特定站点普遍生效、不随具体内容（如文章或产品）变化而变化的信息。这包括但不限于：网站名称、LOGO图片路径、备案号、版权信息、社交媒体主页链接、统一的客服电话或邮箱、API密钥、外部脚本代码片段、或任何需要在多个页面统一显示且易于修改的全局性文本或链接。

2. 在模板中调用自定义参数时，如何确保参数名被正确识别？

在安企CMS后台定义自定义参数时，您输入的“参数名”将自动转换为驼峰命名法。例如，如果您输入“Help Url”，它在后台可能显示为“HelpUrl”。在模板中调用时，您必须使用这个转换后的驼峰命名格式作为name属性的值。例如，使用name="HelpUrl"，而不是name="Help_Url"或name="helpurl"。务必确保模板中的命名与后台自动生成的驼峰命名精确匹配，才能成功调用。

3. 我能否使用自定义系统参数来存储文章或产品的特定属性，例如文章的作者或产品的价格？

不建议这样做。自定义系统参数主要用于网站级的通用配置。对于文章、产品或其他内容模型特有的属性，安企CMS提供了“内容模型”自定义字段功能。您可以在相应的“内容模型”中定义这些字段（例如文章模型添加“作者”字段，产品模型添加“价格”字段），这样能更合理地组织数据，并支持内容的批量管理和筛选。将内容特定数据混入系统参数会使管理变得混乱且难以维护。