模组参考文章
文章字段
MacCMS V10 文章字段：字段类型、对象上下文与输出注意事项。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
文章列表内使用 $vo，详情页的当前对象使用 $obj。字段不是全站全页面都有：把详情字段放到搜索页而没有对象，会出现空值。
两种上下文
<!-- 在 详情模板中 -->
<p>{$obj.art_name}</p>
<!-- 列表循环中 -->
{maccms:art num="10" order="desc" by="time"}
{$vo.art_name}
{/maccms:art}字段类型与含义
下表来自本次版本的安装表结构。数据库字段与运行时追加对象不同；自定义表前缀不改变模板字段名。
| 字段 | 存储类型 | 说明 |
|---|---|---|
| art_id | int(10) | " data-sid="{$param.sid}" data-nid="{$param.nid}"> |
| type_id | smallint(6) | 分类id |
| type_id_1 | smallint(6) | 一级分类id |
| group_id | smallint(6) | 用户组id |
| art_name | varchar(255) | " data-pic="{$obj.art_pic／mac_url_img}"> |
| art_sub | varchar(255) | 副标题 |
| art_en | varchar(255) | 别名 |
| art_status | tinyint(1) | 状态0未审1已审 |
| art_letter | char(1) | 首字母 |
| art_color | varchar(6) | 颜色 |
| art_from | varchar(30) | 来源 |
| art_author | varchar(30) | 作者 |
| art_tag | varchar(100) | tags |
| art_class | varchar(255) | 扩展分类 |
| art_pic | varchar(1024) | 主图 |
| art_pic_thumb | varchar(1024) | 缩略图 |
| art_pic_slide | varchar(1024) | 幻灯图 |
| art_pic_screenshot | text | 截图多个图片用#连接 |
| art_blurb | varchar(255) | 简介 |
| art_remarks | varchar(100) | 备注 |
| art_jumpurl | varchar(150) | 跳转url |
| art_tpl | varchar(30) | 独立模板 |
| art_level | tinyint(1) | 推荐等级 |
| art_lock | tinyint(1) | 锁定 |
| art_points | smallint(6) | 访问整个文章所需点数 |
| art_points_detail | smallint(6) | 访问每一页所需点数 |
| art_up | mediumint(8) | 顶数 |
| art_down | mediumint(8) | 踩数 |
| art_hits | mediumint(8) | 总点击量 |
| art_hits_day | mediumint(8) | 日点击量 |
| art_hits_week | mediumint(8) | 周点击量 |
| art_hits_month | mediumint(8) | 月点击量 |
| art_time | int(10) | 更新时间 |
| art_time_add | int(10) | 添加时间 |
| art_time_hits | int(10) | 点击时间 |
| art_time_make | int(10) | 生成时间 |
| art_recycle_time | int(10) | 参照后台同名数据项；本字段没有单独中文注释 |
| art_score | decimal(3 | 平均分 |
| art_score_all | mediumint(8) | 总评分 |
| art_score_num | mediumint(8) | 评分次数 |
| art_rel_art | varchar(255) | 关联文章 |
| art_rel_vod | varchar(255) | 关联视频 |
| art_pwd | varchar(10) | 访问密码 |
| art_pwd_url | varchar(255) | 密码获取链接 |
| art_title | mediumtext | 页标题 |
| art_note | mediumtext | 页备注 |
| art_content | mediumtext | 页详细介绍 |
输出时注意
- 名称直接输出；图片路径通过 mac_url_img 转换，不要假设总是完整 URL。
- 时间字段通常是 Unix 时间戳，按需要格式化；先确认字段类型。
- 数组或 JSON 不能当作一段普通文本直接输出。
- 关联对象取决于控制器和模型，不在本页表结构内的对象需要查对应页面。
查看文章标签选择数据，再按页面约定输出。