8
第一个 WordPress 插件做到三件事就可以验收:后台能识别并启用,测试页能输出预期内容,停用后不再执行该功能。下面用一个只返回固定提示的短代码走一遍,示例逻辑不读取访客输入,也不请求外部服务。
先让 WordPress 识别插件
在测试站的 wp-content/plugins/ 下建 sample-notice 目录,再创建 sample-notice.php 作为主文件。主 PHP 文件写入插件头,Plugin Name 是识别该插件的必填字段。示例不改 WordPress 核心文件;函数名、短代码名称使用项目自己的前缀,以减少和现有插件撞名的风险。
Action 和 Filter 分别在什么时候用
如果要在某个时机执行一项操作,例如在前台为插件加载样式,用 Action 挂接回调。它的回调返回值不会被钩子用来替换原来的值。如果要改写当前数据,例如给指定栏目标题补一段前缀,用 Filter 接收原值,处理后返回;不需要改时也返回原值。短代码注册有专门的 add_shortcode 接口,不用为了显示一行文字把操作挂到全站内容过滤上。

用一个短代码做最小验证
把下面的内容放进主 PHP 文件。回调直接返回要显示的字符串,不用 echo,这样 WordPress 才能把它放到短代码所在的位置。此例不是要安装到正在运行的官网。
<?php
/**
* Plugin Name: Demo Site Note
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
function demo_site_note_render() {
return '这是一个静态测试提示。';
}
add_shortcode( 'demo_site_note', 'demo_site_note_render' );
按三个结果排查问题
进入测试站后台的插件列表。找不到插件时,先查主文件路径、PHP 文件后缀和插件头。启用后,用短代码区块在测试页面填写 demo_site_note(名称两边各加一个英文方括号),预览应看到“这是一个静态测试提示。”;如果仍看到原样文字,先核对启用状态、名称拼写和注册回调是否执行。
最后停用插件并重新访问测试页。预期是原来的提示不再由插件输出,内容中的短代码可能显示成原样。若启用时出现 PHP 错误,在测试环境查日志和错误行号,避免直接把报错显示给访客。交接时至少记录文件位置、适用页面、验收结果和停用方法。