jmxkf_wzdh v1.9.0 — 文章资讯模块实施计划
## 已定决策
- **前台入口**:独立路由 + 自动注册站点导航「资讯」入口(未收到答复,采用推荐项)
- **正文编辑器**:复用核心 AIEditor(lib/EditorService.php)
- **列表页右栏**:文章专属右栏(热门文章/最新文章/热门标签),列表与详情共用;主栏卡片 2 列网格
- 设计语言沿用插件 v1.8.0 已实测的 toolify 技法(#f5f5f5 卡底、2px #d9d8fc 浅紫描边、圆角 12、sticky 侧栏、[data-bs-theme=dark] 暗色覆盖)
## 一、数据库(3 张新表,v190 阶段三处同步)
新建表(`$db->tablepre` 前缀、utf8mb4,命名风格对齐现有 cate/site 表):
1. **`jmxkf_wzdh_acate`** 文章分类表:`acate_id` PK AI、`acate_name` varchar(64)、`acate_alias` varchar(64)(UNIQUE,URL 别名)、`acate_pid`(0=顶级,支持子分类)、`acate_desc` text、`acate_seo_title` varchar(255)、`acate_seo_keywords` varchar(255)、`acate_seo_desc` varchar(500)(SEO 三字段留空时前台回退默认拼接)、`acate_rank`、`acate_count`(文章数)、`acate_create_date`;KEY acate_pid
2. **`jmxkf_wzdh_article`** 文章表:`article_id` PK AI、`article_title` varchar(255)、`article_summary` varchar(1000)(摘要)、`article_content` mediumtext(HTML)、`article_cover` varchar(512)(特色封面,空则运行时提取正文首图,无图不显示)、`article_tags` varchar(255)(逗号串)、`article_cate_id`(主分类=复选第一个,面包屑/SEO/相关文章用)、`article_status` tinyint(0草稿/1发布)、`article_views`、`article_uid`、`article_create_date`、`article_update_date`;KEY cate_id/status/views/create_date
3. **`jmxkf_wzdh_article_cate`** pivot(PK(article_id,cate_id)+KEY cate_id,复刻 site_cate 模式)
同步三处(遵守既有纪律):`install.php` 加 DDL → `Service::ensure_schema()` 加 `jmxkf_wzdh_schema_v190_ok` 阶段 → `upgrade.php` 加 2.6 段;`uninstall.php` 补 DROP 三表。
## 二、Service(model/JmxkfWzdhService.php 追加方法)
- `acate_*`:tree/list_all/by_alias/read/children/create/update/delete(删除规则:有子分类或有文章关联时拒绝并提示,不级联删文章)
- `article_set_cates`(pivot 全量覆盖+维护 acate_count,复刻 site_set_cates)、`article_cate_ids`
- `article_create/update/delete`(删 pivot、`_cache_clear()`)、`article_read($id)`(浏览量自增,`is_bot()` 跳过)、`article_status_toggle`
- 列表:`article_list($page,$cond)` 手写 COUNT+SQL 分页(status=1,返回 [列表,总数])、`article_list_by_cate`(EXISTS pivot 子查询含子分类)、`article_list_by_tag`(FIND_IN_SET)、`admin_article_list`(status/cate/keyword 筛选+分页)
- 侧栏/相关:`article_hot`、`article_latest`、`article_related($id)`(同主分类排除自身)、`article_hot_tags`(最近文章标签聚合);全部 `_cache_remember` 缓存(600/300s)
- `article_format()`(日期、分类名、tags 数组、**封面三级回退:cover→正文首图正则提取→无**)、`article_first_image($content)`
- 设置 defaults 追加:`article_pagesize`(12)、`article_related_count`(6)、`article_list_title`('资讯文章')
## 三、前台路由 + 页面
- `hook/index_route_case_end.php` 追加 `case 'article': include _include(...route/article.php); break;`
- **route/article.php**:action=param(1):`''/index` 全部列表、`cate`(param(2)=alias, param(3)=页码)、`tag`(param(2)=标签)、`detail`(param(2)=id)
- URL:`url('article')`、`url('article-cate-'.$alias.'-{page}')`、`url('article-tag-'.$slug.'-{page}')`、`url('article-detail-'.$id)`
- **SEO**:复用 nav.php:30-47 的闭包写法。分类页 title/keywords/description = acate SEO 字段优先,空则默认拼接(分类名_站名等);详情页 title=标题_站名、keywords=tags→分类 keywords 兜底、description=摘要→正文截断、`og_image`=封面/首图、`$header['json_ld']`=Article 类型;列表/分类页第 1 页输出 canonical,草稿不可见
- **view/htm 新模板**(照 nav_cat.htm 骨架:header.inc → ob_start 主栏 → 三栏 include → footer.inc):
- `article_list.htm`(列表/分类/标签三用):面包屑「资讯 > 分类」、toolify 风格**分类胶囊筛选条**(全部+顶级分类,选中分类下再排子分类胶囊,横排可换行,含文章数)、`article_list.htm` 卡片网格、空态、分页 `pagination()`
- `article_detail.htm`:面包屑、h1 标题、meta 行(日期/浏览量/分类链接)、封面图(有才渲染,圆角)、`.jmxkf-wzdh-article-content` 正文、底部标签 chips、相关文章区块
- `article_side.htm`(右栏):热门文章 Top10(缩略图+两行标题+日期)、最新文章、热门标签云
- 卡片 HTML 由 `Service::article_card_html()` 输出(复刻 site_card_html 模式,列表与相关文章共用):封面 16:9 顶部、标题 2 行截断、摘要 2 行、meta 行(分类徽章+日期+浏览量)、tags 最多 2 个
## 四、后台管理(复用 jmxkf_nav 独立页面组)
- **route/admin_nav.php** 追加两个 action 分支(param(1)):`article`(list 筛选分页/发布 add/编辑 edit-{id}/删除 delete-{id}/状态切换 status-{id}-{0|1},变更全 POST+CSRF)与 `articlecate`(list/add/edit/delete)
- **新模板**(ADMIN_PATH header/footer + card-header-tabs):
- `nav_admin_article_list.htm`:状态/分类/关键词筛选、表格(封面缩略、标题、分类、标签、状态、浏览、时间、操作)
- `nav_admin_article_edit.htm`:标题、摘要、**分类 checkbox 网格**(按父分组多选,第一个为主分类)、标签输入(逗号分隔)、封面单图上传(**复用现有 `url('jmxkf_nav-upload')` + nav-admin.js 上传函数**,注入 JMXKF_NAV_ADMIN 配置)、状态选择、正文 = `EditorService::renderEditorHtml('article_content')`(class_exists 守卫 + assets css/js 循环,post.htm:346-361 范式)
- `nav_admin_acate_list.htm` / `nav_admin_acate_edit.htm`:名称、别名(唯一校验)、父分类下拉、描述、**SEO 三字段组**(注明"留空使用默认")
- **Tab 栏**:全部后台模板统一加「文章管理」「文章分类」两个 tab(共 6 个)
- **setting.php + nav_admin_setting.htm**:加「资讯设置」分组(每页篇数/相关文章数/列表页标题)
- **lang_zh_cn_bbs.php**:补 `jmxkf_wzdh_article_nav='资讯'` 等新键
## 五、导航入口 + 资产
- 新建 **`nav_register.php`**:`NavService::register('jmxkf_wzdh_article', array('position'=>array('top','side','mobile'), 'url'=>'article', 'icon'=>'ti-news', 'rank'=>131))`(与"网址导航"入口并列)
- **static/css/nav.css** 加「文章资讯模块」区块:胶囊筛选条、卡片网格(≥1200px 2 列/≤768px 1 列)、文章卡、详情排版(h2/h3/p/img/blockquote/code、line-height 1.75)、右栏 mini 卡、暗色模式覆盖;**重跑 `php build.php`**
- 版本两处同步:conf.json → 1.9.0(brief 补"文章资讯")、Service `JMXKF_WZDH_VER` → '1.9.0'
## 六、实施顺序与验证
1. 建表三处同步 → Service 方法 → 前台路由/模板/CSS → 后台管理 → 导航注册 → build.php
2. 全部改动文件 `php -l`;CLI 冒烟(tmp 脚本:ensure_schema→分类/文章 CRUD→列表/详情格式化)
3. 清 `tmp/route_*、plugin_*、view_htm_*、model_*`(编译缓存不比较 mtime)
4. 浏览器验证前台列表/分类/标签/详情(URL 加 `?nocache=` 穿透页面缓存)、PC+窄屏两档;**后台页面无凭据,提醒用户手动验证**(发布文章→前台可见全链路)
5. 交付自查:hook 无 `return;`、无 jQuery/Alpine、esc_html/esc_attr 全覆盖、POST 全带 CsrfService、db_* 表名不带前缀、双引号插值用 `{$var}`(全角括号坑)



