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

摘要

本文档详细列出了Z-Blog博客系统中，前台页面（如列表页、文章页、搜索页、评论页、RSS订阅页）在渲染和流程处理过程中可用的PHP插件钩子（Filter Hook）接口。这些接口允许插件开发者在特定的页面输出阶段或数据查询阶段注入自定义逻辑，修改模板变量或数据查询参数，从而实现功能扩展和界面定制。

核心要点

• 接口分为两大类：控制页面输出模板的`Filter_Plugin_View*_Template`接口和介入页面处理流程的`Filter_Plugin_*_Begin/Core/End`接口。
• 输出类钩子（如`Filter_Plugin_ViewPost_Template`）直接操作`$template`变量，用于替换或修改最终渲染的模板文件。
• 流程类钩子（如`Filter_Plugin_ViewPost_Core`）介入数据查询阶段，允许修改`$select, $w, $order, $limit, $option`等SQL查询参数，从而改变页面展示的数据内容。
• 覆盖了博客前台主要场景：首页(`ViewIndex`)、自动重定向(`ViewAuto`)、列表页(`ViewList`)、文章页(`ViewPost`)、搜索页(`ViewSearch`)、评论(`ViewComment`)及RSS订阅(`Feed`)。

关键实体

- Z-Blog (product) ⚠️建议建页

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

相关内容

• [[个人知识库_v1v2_改造方案.md]]
• [[2026-04-02_发布系统升级与视频流程优化工作日志.md]]

建议新建页面

• [[Z-Blog插件开发指南]] — 基于当前钩子接口列表，可扩展为完整的Z-Blog插件开发入门与实践指南。
• [[Z-Blog模板引擎与标签系统]] — 钩子与模板变量紧密相关，可深入解析Z-Blog的模板机制。

---

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