迅睿XunRuiCMS如何调用自定义属性myflag？

迅睿XunRuiCMS是一款功能强大且灵活的内容管理系统， 支持自定义字段和属性，方便开发者根据实际需求 内容结构。其中，自定义属性myflag常用于标记文章的特殊状态或分类。本文将详细介绍如何在迅睿CMS中调用自定义属性myflag 并给出具体代码示例，帮助你快速掌握相关操作。

一、自定义属性的概念及作用

什么是自定义属性？

自定义属性指的是用户中自行添加的字段。比方说文章可以有“推荐”、“热门”、“幻灯片”等标识，这些标识就是通过自定义字段来实现。迅睿CMS允许在后台模块管理中自由添加这些字段，然后在模板或代码中调用，实现灵活展示。

为什么要使用myflag？

myflag通常作为文章的状态标志， 比如“精选”、“置顶”或者其他特殊分类。通过调用myflag 前端页面可以过滤、排序或者高亮显示对应文章，从而提升内容展示效果和用户体验。

二、 如何新增与配置自定义属性myflag

默认情况下迅睿CMS后台可能没有名为myflag的字段，需要先添加：

1. 登录后台管理系统：进入--。
2. 选择对应模块：比如选择“文章”模块进行编辑。
3. 新增字段：
   • 字段名称：myflag
   • 类型：Select、 Checkbox等，根据需求决定。
   • 选项配置：{"p":"推荐","c":"置顶","f":"幻灯"} 等值对形式。
4. 保存设置并更新缓存：

*注意*：修改后务必清理缓存，否则模板无法读取最新字段数据。

三、 模板中调用自定义属性 myflag 的基本写法

XunRuiCMS的模板语法支持直接通过JSON参数传递筛选条件，其中{module}, {article}, 或其他列表标签都能用此方式进行过滤。要调用带有特定myflag 值的文章， 一般用法如下：

{module module=article JSON_myflag=f num=5 order=hits}
{/module}

• {module}: 调用指定模块，如 article
• JSON_myflag=f: 筛选 myflag 字段值为 f 的数据
• : 获取数量限制为5条数据
• : 按点击量排序
• {$t.url} 和 {$t.title} 是当前循环项标题和链接变量

*这里的JSON_myflag表示筛选json格式存储中的某个子键值，非常适合多选或复杂的数据结构*

四、多条件调用示例——AND与OR关系处理

XunRuiCMS允许在JSON_myflag 中传递多个参数，区分“并且”和“或者”条件，用逗号和竖线分隔即可:

• AND:  {module module=article JSON_myflag=p,c num=10}  只会返回一边满足 p 和 c 两个标记的文章。
• OR:  {module module=article JSON_myflag=p|c num=10}  返回带有 p 或 c 任意一个标记的文章。
• *目前官方程序不支持取反操作， 即不能筛选不含指定标记的数据*

五、完整步骤示范：从创建到调用 myflag 属性实例解析

步骤1：后台新增 myflag 字段配置样例图示

- 字段类型选择多选框 - 可填写多个标签，如：推荐,置顶,幻灯 - 保存完成后刷新缓存 - 新增文章时可勾选对应标签

步骤2：写入测试数据

- 新建一篇测试文章 - 勾选“推荐”和“幻灯”两个标签 - 保存发布完成

步骤3：模板中调用代码示例

{module module=article JSON_myflag=p|f num=8 order=id desc}
    

        
            {$t.title}
        
        
            {if strpos !== false}
            {if strpos !== false}
        
    
{/module}

• {$t.myflag} 为当前循环项里存储的 myflag 字段原始字符串或数组格式，可根据存储类型调整判断方式。
• {@literal strpos} 是PHP函数判断字符串包含关系， 用于显示不同状态图标；如果是多值json存储，请用相应解码方式获取数组再判断。
• {@literal JSON_myflag=p|f} 表示筛选带有推荐或幻灯任一标签数据，并取最新8条按ID倒序排列。
• *你也可以根据需要改成 AND 查询：JSON_myflag=p,f*
• *确保模板文件支持PHP判断， 否则需预处理数据后传入视图*

六、重要注意事项及调试技巧

• : 自定义字段必须先正确新增并保存至数据库，否则模板无法读取该字段数据；且每次修改完要清理缓存刷新生效。
• : XunRuiCMS一般将多选类型以json字符串形式保存在数据库，要正确理解其存储结构才能正确解析。比方说{"value":}这种格式，需配合模板函数转换读取；直接当作简单字符串操作可能导致错误后来啊。
• : 默认{module}标签支持大部分简单查询， 但复杂逻辑建议借助PHP辅助函数预处理后再渲染，比方说使用dr_array_column等系统内置方法简化处理过程。

---

调试提示： 
- 在模板输出阶段， 可以临时打印变量查看，比方说：{@literal var_dump}确认是否拿到正确的数据格式; - 如果拿不到值，请确认是否已经刷新了缓存，以及是否新加字段权限正确。 - 多数情况下建议开发者结合官方文档以及源码阅读，理解底层API是关键。 - 模板文件路径一般位于/modules/article/目录下对应show.html或list.html等。

七、归纳——实用快速掌握 myFlag 调用技巧！

- 自定义属性必须先由后台创建配置， 再通过前端模板语法引用；其中关键参数为"JSON_myFlag".

- 多个条件支持 AND 和 OR ，方便复杂筛选；目前暂不支持否定查询.

- 调用时请注意读取原始json格式还是已解码数组，根据实际存储做相应解析才能保证逻辑准确.

- 模板内可结合 PHP 判断对不同状态做图标高亮等展示提升用户体验.

- 开发流程务必重视清理缓存及测试输出变量确保效果达成.

---

更多XunRui CMS开发技巧敬请关注官方文档与社区交流！祝你开发顺利！🚀🚀🚀