如何自定义系统级别的参数并在前端模板中灵活调用？

驾驭安企CMS：灵活定制系统级参数并在前端模板中高效调用

作为一名资深的网站运营专家，我深知一套灵活、可定制的内容管理系统对于企业高效运营的重要性。安企CMS（AnQiCMS）凭借其基于Go语言的高性能架构和丰富功能，在内容发布、多站点管理以及SEO优化方面表现出色，尤其在系统级参数的定制与调用上，更是提供了极大的便利，让运营者能够轻松驾驭网站的方方面面。

今天，我们就来深入探讨安企CMS如何让您自定义系统级别的参数，并将其在前端模板中灵活调用，从而实现更动态、更个性化的网站内容呈现。

一、为何要自定义系统级参数？

在日常网站运营中，我们经常会遇到一些需要在全站范围内统一显示的信息，比如公司的客服电话、统一的社交媒体链接、企业愿景、特殊的公告文字，或者是一些在特定时期需要快速调整的配置。如果这些信息都硬编码在模板里，一旦需要修改，就意味着要修改多个模板文件，这无疑增加了维护成本，也提高了出错的风险。

安企CMS的系统级参数定制功能，正是为了解决这一痛点。它允许我们在后台集中管理这些全局性数据，并通过简洁的模板标签在前端按需调用，实现了内容与表现的分离，极大地提升了网站的灵活性和运营效率。

二、在安企CMS后台定制您的专属参数

安企CMS的后台设置区域，是管理这些系统级参数的核心枢纽。我们可以通过“全局设置”和“联系方式设置”这两个入口，轻松添加和管理自定义参数。

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

   首先，登录您的安企CMS后台，导航到左侧菜单的“后台设置”区域，然后选择“全局功能设置”。在这个页面上，您会看到网站名称、网站Logo、备案号码等一些默认的系统参数。页面底部通常设有一个“自定义设置参数”的区域。

   点击“添加”按钮，您便可以创建一个新的自定义参数。这里需要填写三个关键信息：

   • 参数名：这是您在前端模板中调用此参数的唯一标识符。建议使用英文驼峰命名法（CamelCase），例如 CompanyMotto 或 HolidayNotice，以便于理解和区分。
   • 参数值：这便是该参数实际承载的内容。它可以是纯文本、URL链接，甚至是简短的HTML代码片段（如果需要在前端直接渲染HTML）。
   • 备注：为这个参数添加一个清晰的说明，方便您和团队其他成员理解其用途，避免混淆。

   举个例子，如果您的公司有一个核心的企业愿景，需要在多个页面展示，您可以这样设置：

   • 参数名：CompanyVision
   • 参数值：以创新驱动，赋能数字营销新时代！
   • 备注：企业文化愿景，用于首页和关于我们页面

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

   同样地，在“后台设置”中，选择“联系方式设置”入口。这里默认提供了联系人、联系电话、联系地址、联系邮箱等常用信息。与全局设置类似，页面底部也有一个“自定义设置参数”区域。

   如果您需要添加一些不属于默认联系方式的定制信息，比如公司的 WhatsApp 链接或者特定节假日的客服时间，可以在这里进行添加。例如：

   • 参数名：WhatsAppLink
   • 参数值：https://wa.me/xxxxxxxxxxxx
   • 备注：公司WhatsApp联系链接

   这种分类管理自定义参数的方式，有助于保持后台配置的条理性和可维护性。

三、在前端模板中灵活调用自定义参数

安企CMS采用了类似Django模板引擎的语法，让前端模板的开发变得直观而高效。一旦您在后台定义了系统级参数，就可以通过特定的模板标签在前端进行灵活调用。

安企CMS提供了system标签用于获取全局功能设置的参数，以及contact标签用于获取联系方式设置的参数。无论是系统内置参数还是您自定义的参数，都通过这两个标签进行调用。

调用这些参数的基本语法是：{% 标签名称 变量名 with name="参数名" %}。其中，标签名称可以是system或contact，参数名就是您在后台定义的“参数名”。

1. 调用全局设置中的参数

   以我们前面定义的CompanyVision为例，在您的前端模板（例如 index.html 或 base.html）中，您可以这样调用：

   <div class="company-slogan">
       <p>{% system with name="CompanyVision" %}</p>
   </div>
   

   如果希望将参数值先存储在一个变量中，以便进行更复杂的逻辑判断或多次使用，可以使用 set 标签：

   {% set companyVision = '' %}
   {% system companyVision with name="CompanyVision" %}
   
   {% if companyVision %}
   <div class="company-slogan">
       <p>{{ companyVision }}</p>
   </div>
   {% else %}
   <div class="company-slogan-fallback">
       <p>抱歉，公司愿景正在更新中...</p>
   </div>
   {% endif %}
   

   这段代码不仅调用了参数，还演示了如何使用if逻辑判断标签，在参数值为空时显示备用内容，增加了网站的健壮性。

2. 调用联系方式设置中的参数

   同样，对于在“联系方式设置”中定义的WhatsAppLink参数，调用方式也非常相似：

   {% set whatsappLink = '' %}
   {% contact whatsappLink with name="WhatsAppLink" %}
   
   {% if whatsappLink %}
   <a href="{{ whatsappLink }}" target="_blank" rel="nofollow">联系我们 (WhatsApp)</a>
   {% endif %}
   

   这里我们还加入了target="_blank"和rel="nofollow"属性，这对于外部链接的SEO优化和用户体验来说是良好的实践。

3. 处理包含HTML内容的参数

   如果您的自定义参数值中包含了HTML代码，并且希望前端能直接解析并渲染这些HTML，而不是显示原始代码，您需要使用|safe过滤器。例如，如果您有一个包含特殊排版或链接的公告：

   后台参数设置：

   • 参数名：ImportantNotice
   • 参数值：`请访问我们的 <a href=“/faq