自定义字段

我们在模型、自定义表单、单页、专题中可以使用自定义字段。

字段类型

数据调用

我们在前台模板列表页或详情页时可以调用自定义字段的数据，详情页和栏目列表页可以直接调用自定义字段数据。arclist调用自定义字段，请参考文档：https://doc.fastadmin.net/cms/26.html 调用副表数据章节

单选/复选

如果我们在后台创建自定义字段时选择的类型是单选/复选，则我们可以在模板中直接使用字段名称来获取数据外，还可以使用字段名称_text来获取对应的显示文本

//文章详情页使用
//对应表中的值
{$__ARCHIVES__.字段名称|htmlentities}
//数据列表对应的值
{$__ARCHIVES__.字段名称_text|htmlentities}

//文章列表页
{cms:pagelist id="item"}
    {$item.字段名称|htmlentities} //对应表中的值
    {$item.字段名称_text|htmlentities} //数据列表对应的值
{/cms:pagelist}

//cms:arclist标签使用
{cms:arclist id="item" row="8" orderby="id" orderway="desc"}
    {$item.字段名称|htmlentities} //对应表中的值
    {$item.字段名称_text|htmlentities} //数据列表对应的值
{/cms:arclist}

如果我们需要对复选数据进行循环，可以使用字段名称_list来获取对应的数组数据，如在文章详情页使用：

{foreach name="__ARCHIVES__.字段名称_list" id="item"}
值：{$key|htmlentities}，标题：{$item|htmlentities}
{/foreach}

列表/列表(多选)

如果我们在后台创建自定义字段时选择的类型是列表/列表(多选)，则我们可以在模板中直接使用字段名称来获取数据外，还可以使用字段名称_text来获取对应的显示文本

//文章详情页使用
//对应表中的值
{$__ARCHIVES__.字段名称|htmlentities}
//数据列表对应的值
{$__ARCHIVES__.字段名称_text|htmlentities}

//文章列表页
{cms:pagelist id="item"}
    {$item.字段名称|htmlentities} //对应表中的值
    {$item.字段名称_text|htmlentities} //数据列表对应的值
{/cms:pagelist}

//cms:arclist标签使用
{cms:arclist id="item" row="8" orderby="id" orderway="desc"}
    {$item.字段名称|htmlentities} //对应表中的值
    {$item.字段名称_text|htmlentities} //数据列表对应的值
{/cms:arclist}

如果我们需要对列表(多选)数据进行循环，可以使用字段名称_list来获取对应的数组数据，如在文章详情页使用：

{foreach name="__ARCHIVES__.字段名称_list" id="item"}
值：{$key|htmlentities}，标题：{$item|htmlentities}
{/foreach}

数组

如果我们在后台创建自定义字段时选择的类型是数组，则我们可以在模板中使用字段名称_list来获取对应的数组数据，如在文章详情页使用：

{foreach name="__ARCHIVES__.字段名称_list" id="item"}
键名：{$key|htmlentities}，键值：{$item|htmlentities}
{/foreach}

关联字段/关联字段(多选)

如果我们在后台创建自定义字段时选择的类型是关联字段/关联字段(多选)，则我们可以在模板中直接使用字段名称来获取数据外，还可以使用字段名称_value来获取对应关联表的显示文本

//文章详情页使用
//对应表中的值
{$__ARCHIVES__.字段名称|htmlentities}
//关联表显示文本
{$__ARCHIVES__.字段名称_value|htmlentities}

//文章列表页
{cms:pagelist id="item"}
    {$item.字段名称|htmlentities} //对应表中的值
    {$item.字段名称_value|htmlentities} //关联表显示文本
{/cms:pagelist}

//cms:arclist标签使用
{cms:arclist id="item" row="8" orderby="id" orderway="desc"}
    {$item.字段名称|htmlentities} //对应表中的值
    {$item.字段名称_value|htmlentities} //关联表显示文本
{/cms:arclist}

温馨提示：此功能仅在CMS1.4.4+版本可使用

数据列表

如果需要获取列表/多选选中的数据，可以参考上方使用字段名称_text和字段名称_list来获取相应的数据，如果需要获取后台自定义字段配置时数据列表配置的字典数据信息，可以使用在自定义表单详情页使用{$fieldList['字段名称']['content_list']}来获取原始字典数据，如在详情页使用：

{foreach name="fieldList.字段名称.content_list" id="item"}
值：{$key|htmlentities}，标题：{$item|htmlentities}
{/foreach}

目前暂时只支持自定义表单详情页

温馨提示