WordPress action视频教程自学路线图：附全套学习资源

WordPress Action 钩子自学路线图(视频 + 全套资源)

> 先说明：**Action(动作钩子)是 WP 开发的核心**，在指定事件触发时执行自定义代码，和 Filter(过滤钩子)成对学习;不要直接硬啃全部钩子，按阶段实战。前置基础：PHP 基础、本地 WP 环境(LocalWP / XAMPP)、了解子主题 / 自定义插件基础。

整体路线 4 阶段(循序渐进)

阶段 1：入门认知(1～2 天，看懂原理，跑通第一个 demo)

目标：分清 Action 和 Filter、掌握 `add_action()`、理解优先级、参数

学习内容：

1. 什么是 Hook，Action 和 Filter 核心区别

2. `add_action( $hook, $callback, $priority, $accepted_args )` 参数详解

3. 最简单实战：`wp_footer` 注入统计代码、`wp_enqueue_scripts` 加载样式 JS

4. 优先级规则：数字越小越早执行;同优先级按注册顺序

5. `remove_action()` 移除已有钩子(关闭原生功能、插件钩子)

✅ 必练 demo：

- 页脚输出自定义文字

- 加载前端 css/js

- 移除 WP 自带版本号、头部多余 meta

阶段 2：高频核心 Action 实战(3～5 天，重点!日常开发 90% 都在这里)

分前台、后台、文章发布、初始化四大类，逐个写 demo：

1. **初始化类**

`init`(最常用，注册自定义文章类型、分类、重写规则)

`after_setup_theme`(主题挂载、注册菜单、缩略图支持)

2. **前台渲染**

`wp_head`、`wp_footer`、`wp_enqueue_scripts`

`template_redirect`(页面跳转、权限拦截)

3. **文章内容事件**

`save_post`(保存文章触发，发通知、写日志、同步第三方)

`publish_post`(文章发布时触发)

`transition_post_status`(状态流转，草稿→发布)

4. **后台管理**

`admin_init`(后台加载初始化，注册设置项)

`admin_menu`(添加后台侧边菜单)

`admin_enqueue_scripts`(后台加载样式脚本)

5. 进阶小练习：AJAX 钩子 `wp_ajax_xxx` / `wp_ajax_nopriv_xxx`

>

> 学习方法：每个钩子先查官方文档，看触发时机、传入参数，再写独立小插件测试，**不要写在父主题 functions.php**。

阶段 3：自定义 Action + 复杂项目落地(3～7 天)

目标：学会自己定义钩子，写出可扩展的插件 / 主题

1. `do_action()` 创建自定义 Action 钩子：`do_action('my_prefix_before_form')`

2. 规范命名：**加唯一前缀，避免钩子冲突**

3. 实战：给自定义表单、自定义文章模板埋钩子，方便后续二次开发

4. 常见坑：

- save_post 无限循环(缺少判断 `wp_is_post_autosave`、`wp_is_post_revision`)

- 优先级冲突，插件互相覆盖

- 钩子执行时机搞错(init 拿不到 post 数据，要在 wp 或者 template_redirect)

5. 项目练习：写一个简易文章发布邮件通知插件

阶段 4：高阶拓展(长期沉淀)

1. WooCommerce Action 钩子(电商独立站高频：woocommerce_add_to_cart、woocommerce_checkout 等)

2. 古腾堡 Block Editor @wordpress/hooks(JS 端 Action：addAction)

3. REST API 钩子、多站点 Multisite 钩子

4. 调试工具：钩子查看插件、日志打印、Xdebug 断点调试

5. 阅读知名插件源码：看大佬怎么组织 Action

视频教程资源(B 站 + 官方，优先看这套)

1. **官方入门开发课(中英字幕，必看)**

Learn WordPress 《Beginner WordPress Developer》，其中单独一节 **Action Hooks**

B 站链接：BV1NxQJBZEbt(文派茶馆 WP-TEA 翻译字幕版)

配套主页：[https://wptea.com/zh-tw/wordpress-beginner-developer-video-tutorial/](https://wptea.com/zh-tw/wordpress-beginner-developer-video-tutorial/)

>

> 整套课程包含页面请求流程、Action、Filter、自定义文章类型、REST API

2. 国内 WP 开发博主推荐(B 站搜索关键词)

- 搜索：`WordPress 钩子 action filter 实战`、`save_post 钩子避坑`、`wp ajax action`

- 推荐看带源码实操、带排坑讲解的视频，避开只讲理论的

3. 国际优质视频源

- WordPress.tv：WordCamp 大会 Hooks 专题分享(免费) [https://wordpress.tv/](https://wordpress.tv/)WordPress....

- YouTube：`WordPress Hooks Action Tutorial`(Justin Tadlock、WPBeginner)

文档 & 查询手册(写代码随时查)

1. 官方 Action 参考手册(最重要，查每个钩子触发时机、参数)

[https://developer.wordpress.org/apis/hooks/action-reference/](https://developer.wordpress.org/apis/hooks/action-reference/)WordPress ...

2. Plugin API 钩子总文档

[https://developer.wordpress.org/plugins/hooks/](https://developer.wordpress.org/plugins/hooks/)

3. 自定义钩子规范：

[https://developer.wordpress.org/plugins/hooks/custom-hooks/](https://developer.wordpress.org/plugins/hooks/custom-hooks/)WordPress ...

4. WP 智库中文钩子参考(适合快速中文查阅)：[https://www.wpzhiku.com/document/plugins-hooks/](https://www.wpzhiku.com/document/plugins-hooks/)

配套工具(学习必备)

1. LocalWP：本地一键搭建 WP 环境，开发测试首选

2. **Query Monitor**(插件)：✅ 钩子调试神器!可以看当前页面所有执行的 Action、Filter、调用顺序、参数，学 Hook 必装

3. WP Hooks Finder / Show Hooks：可视化页面上标记钩子位置(适合主题找位置挂载代码)

4. VSCode + WordPress Snippets 代码片段

练习清单(学完一个阶段完成对应任务)

- 阶段 1：wp_footer 输出代码、移除 WP 头部冗余钩子

- 阶段 2：init 注册自定义文章类型、save_post 记录日志、admin_menu 增加后台菜单、wp_ajax 实现简单前端 AJAX 提交

- 阶段 3：自己 do_action 埋自定义钩子，写可扩展表单插件

- 阶段 4：Woo 购物车钩子实战、JS 端 @wordpress/hooks

高频避坑清单(视频里很多教程不讲)

1. 不要修改父主题 functions，全部用**自定义插件 / 子主题**

2. save_post 一定要判断自动保存、修订版本，防止死循环

3. filter 必须 return 数据;action 是执行动作，不需要 return

4. 钩子有执行顺序，不要在太早的钩子(比如 plugins_loaded)拿不到文章 ID

5. 钩子名称全局唯一，必须加前缀 `myprefix_`，防止插件冲突

6. AJAX 必须同时处理登录 / 未登录两套钩子：`wp_ajax_` + `wp_ajax_nopriv_`