9. 逐页拆解:文章与排行
第 3 节那张表只收了站点类页面的公开地址,文章、排行榜、专题这几页的地址在这一节补齐。
地址对着主程序 app/core/Router.php 的路由表和 app/core/helpers.php 里 url() 的分支核过,
行号对着 app/controllers/FrontController.php。翻页形态、别名回落、老地址 301 都写在下面。
9.1 公开地址与渲染位置
| 公开地址 | 视图 | 控制器方法 |
|---|---|---|
/news.html、/news/p2.html | wz_all |
FrontController::wzall(),行 382,render 在行 399。翻页是路径段 /p2.html,由 url('wz', ['page' => 2]) 生成 |
/list/<文章分类别名>.html、/list/<文章分类别名>/p2.html | wz_sort |
先进 cat():它先查站点分类 dtr_sort,认不出再查文章分类 dtr_sortwz,命中后转 wzsort(),行 402,render 在行 407;两个都认不出才 404 |
/list/<分类段>/<文章别名>.html | wz_show |
先进 item():分类段认得出是站点还是文章就按那边走,认不出时站点和文章各试一次,最后交给 wzshow(),行 418,render 在行 475。地址用 url('wzshow', ['id' => 12]) 生成,别名没登记时分类段拼成 0,形如 /list/0/12.html,item() 照样认 |
/ranking.html | ranking |
ranking(),行 232,render 在行 236,出的是榜单总览 |
/ranking/day.html、/ranking/article/p2.html | ranking |
rankingList($type, $page),行 249,render 在行 270。类型只认 day、month、total、article 四个词,路由正则写死,写成别的直接 404 |
/topic.html、/topic/p2.html | topics |
topics($page),行 494,render 在行 514,专题合集列表 |
/topic/<别名>.html、/topic/<别名>/p2.html | topic |
topic($alias, $page),行 518,render 在行 540,专题内文章列表 |
/article/like、/article/tip、/article/buy | 不出页面 | articlePost($what),行 623。文章详情页的点赞、打赏、购买三个 AJAX 接口,正则里不带伪静态后缀,提交时别加 .html |
/wzshow_3.html、/wz2.html、/wz.html | 先 301 | Router::legacyMove() 用 url() 算出规范地址再跳,规则在 app/core/Router.php 行 152 到 163。配伪静态时把这类规则删了,收录过的老链接就断 |
这几页的翻页形态和 search、daishen 不一样:文章类走路径段 /p2.html,
那两个走查询串 ?page=2。自己写列表页时 pager 片段里的 route 要传对,
传错了一页能看、第二页 404。
9.2 视图与变量对照
这些键就是 FrontController 那几行 render() 递过来的,取法见 3.4,控制器给什么视图里就有什么。
| 视图 | 控制器传进来的变量 |
|---|---|
ranking | 榜单首页:$page $seo_title $rankDay $rankMonth $rankTotal $rankArticles $rankStats $latest。分榜:$page $seo_title $rankType $rankTitle $rows $total $pages $cur $per $rankStats |
wz_all | $page $rows $total $pages $cur $sortwz $articleGroups $tui $hotWords $notice $cntWz |
wz_sort | $page $sortwz $rows $total $pages $cur $allwz |
wz_show | $page $article $sortwz $readable $readWhy $toc $contentHtml $words $readMin $related $prev $next $topics $hot $reader $likeOn $liked $likeCount $payReady $tipOn $priceYuan $payStats $payAmounts $walletFen $flash |
topics | $page $topics $counts $cur $pages $total $hot |
topic | $page $topic $arts $total $pages $cur $others $hot |
默认模板这几个视图都在 templates/default/views/ 下同名,文件注释头列着控制器给的键。
其中 ranking.php 只是个容器,真正的排版在 ranking_body.php 片段里,
它用 $this->partial('ranking_body', get_defined_vars()) 把整份数据原样递进去,总览和分榜共用这一份主体。
9.3 文章表里模板用得上的几列
完整字段字典在第 4 节 4.3,这里摘模板真正会碰的那几列。
| 列 | 类型 | 是什么 | 模板里注意 |
|---|---|---|---|
content | longtext | 正文 HTML,入库前已过 Html::clean 白名单 | 前台直接 echo $article["content"],不要再 e(),否则满屏实体码 |
view / hits / rhits | int | 总 / 当月 / 当天浏览 | 口径和站点表一模一样,按天按月自动重计 |
date / datem | varchar | 最后计数那天、那月 | 不是发布时间,发布时间看 publish_at |
likes | int | 点赞数 | 点赞过没赞过记在 dtr_wz_like,模板里想禁用重复点赞要查它 |
status | tinyint | 0 草稿 1 已发布 2 待审 3 定时发布 4 已下架 | 前台可见的唯一判据是 Article::VISIBLE 那段条件 |
publish_at | datetime | 发布时间 | 定时发布到点自动可见,靠的是查询条件直接比 NOW(),不需要计划任务改状态 |
uid | int | 作者的用户 ID,0 是管理员发的 | 投稿来的文章这里是人 |
price | int | 付费阅读价,单位分,0 免费 | 付费逻辑在插件里,模板只管显示价格徽标 |
tip_on | tinyint | 是否开启打赏 | |
vis | tinyint | 可见性开关 | 配合 min_level 做等级限制 |
min_level | tinyint | 最低可见等级 |
9.4 这几页相关的钩子
全量清单在第 13 节 13.2,写文章类模板时先记住下面这几个。
| 钩子名 | 用法 | 触发位置 | 典型用途 |
|---|---|---|---|
front_slot_detail | fire | 内页正文后 | 相关推荐、免责声明 |
front_wzall | filter | 文章首页数据数组 | 改 /news.html 那页要用的变量 |
article_end | filter | 文章正文收尾 | 正文读得到才输出,返回一段 HTML 拼在正文后面;付费文没解锁时不触发 |
user_tab_html | filter | 标签页内容 HTML | 配套上一条输出内容 |
article_saved | fire | 文章保存 | 推送 |
text_check | filter | 用户提交文本入库前 | 敏感词拦截 |
第 5 到第 8 章那种一页一段的拆法,站点类视图已经拆完,文章类这几页还没拆到。
要自己核就先打开 templates/default/views/ 下的同名文件,注释头写着给的键,
核心那侧对着 FrontController 行 382 到 540 这一段读。
内容有问题去论坛发帖,或直接联系老李 QQ 260468289。