在安企CMS中，为了满足网站个性化和灵活的内容展示需求，你可以轻松地自定义新的参数，并将这些参数在前端模板中调用显示。这大大增强了网站的定制能力，无论是为了展示特定的联系信息、文章的额外属性，还是单页面的特殊配置，都能游刃有余。

安企CMS提供了两种主要的自定义参数方式：系统/联系方式级别的全局参数和内容模型级别的自定义字段。了解这两种方式及其适用场景，将帮助你更好地管理和展示网站内容。

一、理解安企CMS的参数定制能力

安企CMS的参数定制能力主要体现在两个层面：

  1. 全局及联系方式参数： 这些参数通常是网站范围内的通用信息，如公司名称、备案号、联系电话等，或是一些需要在多个页面重复使用的固定文本。它们在后台设置一次后，可以在任何前端模板中调用。
  2. 内容模型自定义字段： 这些参数与特定的内容类型（如文章、产品、单页面、分类等）绑定。例如，你可能需要为“产品”模型添加“产品型号”、“颜色选项”等字段，为“文章”模型添加“作者简介”、“来源网站”等字段。这些字段仅在对应的内容项编辑时出现，并在该内容项的详情页或列表中被调用。

下面，我们将详细讲解如何在后台设置这些参数，以及如何在前端模板中调用显示。

二、在后台创建自定义参数

1. 设置全局和联系方式参数

全局和联系方式参数是在后台的系统设置中进行配置的。

  • 路径： 登录安企CMS后台，导航到左侧菜单的系统设置。

    • 对于全局参数（如网站名称、版权信息、自定义网站辅助链接等），请选择全局功能设置。
    • 对于联系方式参数（如公司传真、WhatsApp链接等），请选择联系方式设置。

  • 操作步骤：

    1. 在全局功能设置或联系方式设置页面，你会看到一些内置的参数。在其下方，有一个自定义设置参数区域。
    2. 点击新增按钮。
    3. 在弹出的对话框中，填写以下信息：
      • 参数名： 这是在前端模板中调用此参数时使用的名称。建议使用有意义的英文单词，系统会自动将其转换为驼峰命名法（例如，你输入company fax，系统可能会处理为CompanyFax）。请牢记此名称，它将是您前端调用的关键。
      • 参数值： 填写您希望显示在前端的实际内容。这可以是文本、数字、链接甚至是HTML代码片段。
      • 备注： 对此参数的功能进行简要说明，方便日后管理和理解。
    4. 点击确定保存。

举个例子，如果你想在页脚显示一个客服热线，但在内置参数中没有此项，你可以去联系方式设置的自定义设置参数中新增：

  • 参数名： CustomerServiceHotline
  • 参数值： 400-123-4567
  • 备注： 客服热线电话

2. 设置内容模型自定义字段

内容模型自定义字段允许你为文章、产品等内容类型添加特有的数据字段。

  • 路径： 登录安企CMS后台，导航到左侧菜单的内容管理 -> 内容模型。
  • 操作步骤：
    1. 选择你想要添加自定义字段的内容模型（例如“文章模型”或“产品模型”），点击右侧的编辑按钮。
    2. 进入模型编辑页面后，向下滚动到内容模型自定义字段区域。
    3. 点击新增字段按钮。
    4. 在弹出的对话框中，填写以下信息：
      • 参数名： 这是在后台编辑内容时显示给编辑者的中文名称（例如“文章来源”）。
      • 调用字段： 这是在前端模板中调用此字段时使用的英文变量名。请务必使用英文小写字母，并保持唯一性（例如sourceUrl）。
      • 字段类型： 选择适合你数据类型的字段，如单行文本（用于短文本）、多行文本（用于长文本）、数字、单项选择、多项选择、下拉选择等。不同的类型在后台编辑时会有不同的输入控件。
      • 是否必填： 根据需要设置该字段是否为必填项。
      • 默认值： 为该字段设置一个默认值，如果编辑时未填写，将显示此默认值。对于选择类型的字段（单选、多选、下拉），这里输入的是可选项，一行一个。
    5. 点击确定保存字段。
    6. 保存后，别忘了点击模型编辑页面底部的确定按钮，保存整个模型配置的更改。

现在，当你添加或编辑该内容模型下的文章/产品时，在其他参数折叠框内，你将看到新添加的自定义字段。

三、在前端模板中调用并显示

安企CMS的模板引擎类似Django语法，使用{{变量}}来输出变量内容。

1. 调用全局及联系方式参数

对于全局和联系方式中设置的自定义参数，可以通过system和contact标签来调用。

  • 调用全局参数： 使用{% system with name="您的参数名" %}。 如果你在全局功能设置中添加了一个参数名为CustomerServiceHotline的自定义参数，在模板中你可以这样调用：

    <p>客服热线：{% system with name="CustomerServiceHotline" %}</p>

    或者，你也可以将其赋值给一个变量再使用：

    {% system hotline with name="CustomerServiceHotline" %}
<p>客服热线：{{ hotline }}</p>

  • 调用联系方式参数： 使用{% contact with name="您的参数名" %}。 如果你在联系方式设置中添加了一个参数名为WhatsApp的自定义参数，在模板中你可以这样调用：

    <p>WhatsApp联系方式：{% contact with name="WhatsApp" %}</p>

    同样，也可以赋值给变量：

    {% contact whatsappNum with name="WhatsApp" %}
<p>WhatsApp联系方式：{{ whatsappNum }}</p>

2. 调用内容模型自定义字段

内容模型自定义字段的调用通常在文章、产品、分类或单页面的详情页模板中进行。

  • 调用单个自定义字段： 使用archiveDetail（文章/产品）、categoryDetail（分类）或pageDetail（单页面）标签，并指定name为你的调用字段。 如果你为“文章模型”添加了一个调用字段为sourceUrl的字段，在文章详情