Z-Blog前台页面插件钩子接口规范

摘要

本文档详细描述了Z-Blog博客系统前台页面模块中可挂载的插件钩子（Hook）接口规范。这些接口分为两大类：一类用于输出阶段，控制列表、文章、搜索、评论等页面的模板渲染；另一类用于流程阶段，介入索引、自动处理、Feed生成、列表、搜索及文章详情等请求的起始、核心逻辑与结束环节，为开发者提供了深度定制前台行为的扩展点。

核心要点

• 前台页面输出钩子用于干预最终渲染的模板文件，包括列表、文章、搜索、评论等模板。
• 前台页面流程钩子介入请求的完整生命周期，可在Index、Auto、Feed、List、Search、Post等核心流程的开始、核心逻辑及结束阶段注入自定义行为。
• 核心的ViewPost_Core钩子接收了查询构造所需的多个参数，如`$select`, `$w`, `$order`, `$limit`, `$option`，表明其能深度定制数据库查询逻辑。
• 钩子命名遵循清晰的模式：`Filter_Plugin_[模块]_[阶段]`，便于开发者理解和选择使用。

关键实体

• Z-Blog (product)
• Filter_Plugin_ViewList_Template (concept)
• Filter_Plugin_ViewPost_Template (concept)
• Filter_Plugin_ViewSearch_Template (concept)
• Filter_Plugin_ViewComments_Template (concept)
• Filter_Plugin_ViewComment_Template (concept)
• Filter_Plugin_ViewPost_Core (concept)

- Hook (插件钩子) (concept) ⚠️建议建页

建议新建页面

• [[Z-Blog插件钩子系统 (Hook) 概述]] — 作为所有Z-Blog插件钩子的索引入口，系统介绍钩子机制、分类和通用开发方法。
• [[Z-Blog前台页面请求生命周期]] — 详细解析一个前台页面请求从开始到结束的完整流程，并标注出文中列出的所有钩子的介入点。

---

> 编译时间: 2026-06-04 04:45 | 来源: `zblog-docs/app-20-interfaces/hook-view.md`