如何在AnQiCMS后台设置中，自定义新的参数并在前端模板中调用显示？

📅 👁️ 82

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

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

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

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

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

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

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

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

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

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

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

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

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

调用全局参数： 使用{% system with name="您的参数名" %}。如果你在全局功能设置中添加了一个参数名为CustomerServiceHotline的自定义参数，在模板中你可以这样调用：
```
客服热线：{% system with name="CustomerServiceHotline" %}
```
或者，你也可以将其赋值给一个变量再使用：
```
{% system hotline with name="CustomerServiceHotline" %}
客服热线：{{ hotline }}
```
调用联系方式参数： 使用{% contact with name="您的参数名" %}。如果你在联系方式设置中添加了一个参数名为WhatsApp的自定义参数，在模板中你可以这样调用：
```
WhatsApp联系方式：{% contact with name="WhatsApp" %}
```
同样，也可以赋值给变量：
```
{% contact whatsappNum with name="WhatsApp" %}
WhatsApp联系方式：{{ whatsappNum }}
```

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

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