如何在分类详情页获取分类的自定义字段？

在安企CMS中管理网站内容时，我们常常需要让分类页面不仅仅是文档列表的简单聚合，而是能够承载更多专属信息，以更好地引导用户或展示分类特色。这时，为分类添加并获取自定义字段就显得尤为重要。通过这些自定义字段，您可以让每个分类页面都独具个性，无论是展示特定的Banner图、联系方式，还是该分类特有的属性。

理解分类自定义字段的重要性

安企CMS提供了强大的内容模型和分类管理功能，允许我们为内容（如文章、产品）定义各种自定义字段，以适应不同的业务需求。同样，分类本身也支持添加这些个性化的自定义信息。这意味着，除了分类名称、描述等基础属性外，您还可以根据需要，在后台为每个分类设置诸如“分类Banner大图”、“该分类独有的联系方式”、“特色标签说明”等自定义字段。

这些字段一旦设定，就如同给分类打上了独特的“烙印”，极大地丰富了分类页面的表现力。例如，如果您运营一个旅游网站，可以为“海岛游”分类添加一个“**出行季节”的下拉选择字段，或者为“亲子游”分类设置一个“推荐适用年龄段”的数字字段。这样，用户在访问这些分类页面时，就能一眼获取到更精准、更实用的信息。

在分类详情页获取自定义字段

要在分类详情页的模板中展示这些自定义字段，我们需要使用安企CMS内置的 categoryDetail 标签。这个标签是获取分类详细信息的关键，它不仅能帮我们获取分类的ID、标题、链接和描述等基础数据，还能通过一个特殊的参数来访问那些您在后台为分类定义的自定义字段。

当您在后台为分类添加了自定义字段后（通常在“分类管理”中编辑某个分类，并在“其他参数”或“更多模型自定义字段”部分进行设置），这些字段会被安企CMS封装在一个名为 Extra 的数据集合中。

要获取并遍历所有自定义字段，您可以在分类详情页的模板（通常是 {分类模型}/list.html 或您为分类指定的自定义模板文件）中，这样来使用 categoryDetail 标签：

{% categoryDetail categoryExtraFields with name="Extra" %}
{% if categoryExtraFields %}
    <div class="category-custom-info">
        <h3>分类附加信息</h3>
        {% for field in categoryExtraFields %}
            {# 仅显示有值的自定义字段 #}
            {% if field.Value %}
                <p><strong>{{ field.Name }}：</strong> {{ field.Value|safe }}</p>
            {% endif %}
        {% endfor %}
    </div>
{% endif %}

在这段代码中：

• {% categoryDetail categoryExtraFields with name="Extra" %}：我们定义了一个变量 categoryExtraFields 来存储当前分类的所有自定义字段。name="Extra" 是指明我们要获取的就是这些附加的自定义数据。
• {% if categoryExtraFields %}：这是一个简单的判断，确保只有当分类存在自定义字段时，才渲染下面的内容，避免页面上出现不必要的空模块。
• {% for field in categoryExtraFields %}：由于 Extra 返回的是一个包含多个自定义字段的数组或列表，我们需要用 for 循环来逐一遍历它们。
• {{ field.Name }}：会输出您在后台为自定义字段设置的“参数名”（例如，“**出行季节”）。
• {{ field.Value|safe }}：会输出该自定义字段的具体值（例如，“春季和秋季”）。这里的 |safe 过滤器非常重要，特别是当您的自定义字段内容可能包含HTML富文本时，它能确保内容被正确解析显示，而不是作为纯文本输出。

如果您知道自定义字段的“调用字段名”（即在后台定义时使用的英文小写字段名，例如 bestSeason），您也可以直接通过 categoryDetail 标签来获取这个特定的字段值，而无需遍历所有字段：

{% categoryDetail with name="bestSeason" %}

这样，您就能直接在模板中定位并显示某个特定的自定义字段内容，这在您只需要展示某个特定信息而不需要列表展示所有自定义字段时非常方便。

实践小贴士

1. 后台设置是基础： 所有的自定义字段都必须先在安企CMS后台的“内容管理” -> “文档分类”中，选择您要编辑的分类，进入其编辑界面。在“其他参数”或“更多模型自定义字段”区域，根据您的需求添加和配置这些字段。请注意，这里定义的“参数名”是给后台管理员看的，而“调用字段”才是您在模板中直接获取某个特定字段时使用的名称。
2. 灵活运用字段类型： 安企CMS支持多种自定义字段类型，如单行文本、多行文本、数字、单项选择、多项选择和下拉选择。根据您自定义字段的实际用途选择合适的类型，这会影响其在后台的输入形式以及前端值的呈现方式。
3. 条件判断不可少： 在模板中展示自定义字段时，建议添加条件判断（如 {% if field.Value %}），以避免当某个字段没有填写内容时，页面上出现空白标签或不美观的提示。
4. 注意 |safe 的使用： 如果您的自定义字段内容可能包含HTML标签（例如，使用了富文本编辑器），请务必使用 |safe 过滤器，否则HTML代码会被转义为纯文本显示。

通过这些灵活的自定义字段和模板调用方式，安企CMS让您的分类详情页变得更加动态、信息更丰富，从而更好地服务于您的网站运营目标。

常见问题 (FAQ)

1. 为什么我在分类详情页中尝试获取自定义字段，但页面上没有显示任何内容？ 首先，请检查您是否已在安企CMS后台的“文档分类”编辑页面中，为该分类确实添加了自定义字段，并且这些字段有实际的值。其次，确认您在模板中使用了正确的 categoryDetail 标签，特别是 name="Extra" 参数，并且循环遍历了 categoryExtraFields 变量。如果直接获取特定字段，确保 name 参数的值与您在后台定义的自定义字段的“调用字段名”完全匹配且大小写正确。

**2. 我可以直接获取某个特定的自定义字段，而不是遍历所有