开发文档 ›全部章节 ›逐页拆解 ›逐页拆解:文章与排行

9. 逐页拆解:文章与排行

第 3 节那张表只收了站点类页面的公开地址,文章、排行榜、专题这几页的地址在这一节补齐。 地址对着主程序 app/core/Router.php 的路由表和 app/core/helpers.php 里 url() 的分支核过, 行号对着 app/controllers/FrontController.php。翻页形态、别名回落、老地址 301 都写在下面。

9.1 公开地址与渲染位置

公开地址视图控制器方法
/news.html、/news/p2.htmlwz_all FrontController::wzall(),行 382,render 在行 399。翻页是路径段 /p2.html,由 url('wz', ['page' => 2]) 生成
/list/<文章分类别名>.html、/list/<文章分类别名>/p2.htmlwz_sort 先进 cat():它先查站点分类 dtr_sort,认不出再查文章分类 dtr_sortwz,命中后转 wzsort(),行 402,render 在行 407;两个都认不出才 404
/list/<分类段>/<文章别名>.htmlwz_show 先进 item():分类段认得出是站点还是文章就按那边走,认不出时站点和文章各试一次,最后交给 wzshow(),行 418,render 在行 475。地址用 url('wzshow', ['id' => 12]) 生成,别名没登记时分类段拼成 0,形如 /list/0/12.html,item() 照样认
/ranking.htmlranking ranking(),行 232,render 在行 236,出的是榜单总览
/ranking/day.html、/ranking/article/p2.htmlranking rankingList($type, $page),行 249,render 在行 270。类型只认 day、month、total、article 四个词,路由正则写死,写成别的直接 404
/topic.html、/topic/p2.htmltopics topics($page),行 494,render 在行 514,专题合集列表
/topic/<别名>.html、/topic/<别名>/p2.htmltopic 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,这里摘模板真正会碰的那几列。

列类型是什么模板里注意
contentlongtext 正文 HTML,入库前已过 Html::clean 白名单前台直接 echo $article["content"],不要再 e(),否则满屏实体码
view / hits / rhitsint 总 / 当月 / 当天浏览口径和站点表一模一样,按天按月自动重计
date / datemvarchar 最后计数那天、那月不是发布时间,发布时间看 publish_at
likesint 点赞数点赞过没赞过记在 dtr_wz_like,模板里想禁用重复点赞要查它
statustinyint 0 草稿 1 已发布 2 待审 3 定时发布 4 已下架前台可见的唯一判据是 Article::VISIBLE 那段条件
publish_atdatetime 发布时间定时发布到点自动可见,靠的是查询条件直接比 NOW(),不需要计划任务改状态
uidint 作者的用户 ID,0 是管理员发的投稿来的文章这里是人
priceint 付费阅读价,单位分,0 免费付费逻辑在插件里,模板只管显示价格徽标
tip_ontinyint 是否开启打赏
vistinyint 可见性开关配合 min_level 做等级限制
min_leveltinyint 最低可见等级

9.4 这几页相关的钩子

全量清单在第 13 节 13.2,写文章类模板时先记住下面这几个。

钩子名用法触发位置典型用途
front_slot_detailfire 内页正文后相关推荐、免责声明
front_wzallfilter 文章首页数据数组改 /news.html 那页要用的变量
article_endfilter 文章正文收尾正文读得到才输出,返回一段 HTML 拼在正文后面;付费文没解锁时不触发
user_tab_htmlfilter 标签页内容 HTML配套上一条输出内容
article_savedfire 文章保存推送
text_checkfilter 用户提交文本入库前敏感词拦截

第 5 到第 8 章那种一页一段的拆法,站点类视图已经拆完,文章类这几页还没拆到。 要自己核就先打开 templates/default/views/ 下的同名文件,注释头写着给的键, 核心那侧对着 FrontController 行 382 到 540 这一段读。

内容有问题去论坛发帖,或直接联系老李 QQ 260468289。