WordPress 插件定制开发
一个插件只管一件事，别让十个插件抢同一块地盘
装插件解决需求很爽，装到第十五个就开始互相打架：白屏、表单提交 500、样式错位。插件定制开发的思路正好相反——先看这个需求值不值得写，再让一个插件把一件事做干净，代码可读、可维护、可交接。
什么需求该写插件，什么不该
先花十分钟判断，能省很多钱
该写：业务逻辑只有你有
询盘按区域分配给业务员、按参数算报价、经销商按授权查价格，这些逻辑外面买不到，硬套通用插件只会把数据搅乱。
该写：需要对接内部系统
订单进 ERP、客户进 CRM、库存每天同步。现成连接器往往只支持标准字段，你的编码规则和审批流它不认识。
一个插件的最小骨架
六件事做对，后面都不容易出事
注册与安装
- 主文件头部写清名称、版本、依赖的 PHP 与 WP 版本
- register_activation_hook 里建表、写默认选项、刷新固定链接
- register_deactivation_hook 只清临时数据，不删业务数据
- 建表用 dbDelta，字段类型与字符集按规范写，方便后续升级
数据与接口
- 业务数据优先用自定义文章类型加字段，别急着造新表
- 确需新表时加前缀，索引建在查询条件上
- 对外接口走 register_rest_route，带权限回调
- 每个写操作校验 nonce，每个读操作校验 capability
- 入库前 sanitize，出库时按上下文 escape
后台页面用 add_menu_page 挂到设置下，不要占顶级菜单；列表用 WP_List_Table，改起来和原生后台一致。表单提交统一走 admin-post.php，比自定义入口文件安全。
五个真实做过的定制场景
都不是模板能解决的
询盘按规则分配
按国家、产品线、语种三条规则路由到对应业务员，超时未跟进自动提醒主管。数据落库后与推送解耦，推送失败不影响存档。
产品选型计算器
客户输入工况参数，前台算出推荐型号与配套件。计算规则写在服务端，前台只负责传参与展示，避免被改参数套价。
经销商价格查询
登录后按授权区域显示对应价目，未授权只显示建议零售价。价格表存在独立表里，按角色与区域双重校验。
ERP 库存同步
每天定时拉取接口，更新产品库存状态与交期。用 wp_schedule_event 定时任务加手动触发按钮，失败写日志可回溯。
产品批量导入
按 Excel 模板导入上千条产品，支持图片按文件名匹配、分类自动创建、重复型号跳过。导入过程分批执行，避免超时中断。
下载留资门禁
画册与图纸需填表后下载，链接带时效签名，防止被直接转发。下载记录与询盘记录关联，能看出谁在关注哪类资料。
插件冲突长什么样，怎么定位
先看现象，再缩小范围
客户常说”网站突然坏了”，其实多数是更新或新装插件引起。下面这张表是我们排障时最常对上的几种组合。
| 现象 | 常见原因 | 定位办法 | 处理方向 |
|---|---|---|---|
| 整站白屏，后台也进不去 | PHP 内存耗尽或致命错误 | 开 WP_DEBUG 看 debug.log，或查服务器错误日志 | 改内存限制，重命名插件目录逐个排除 |
| 表单提交转圈后 500 | 两个插件同时挂 AJAX 动作，或 nonce 过期 | 浏览器网络面板看请求返回，比对动作名 | 统一动作前缀，调高优先级，延长 nonce 有效期 |
| 前台脚本报 $ is not defined | 主题注销了 jQuery，插件仍依赖它 | 控制台看第一个报错文件属于谁 | 给插件单独声明依赖，或改写为原生 JS |
| 页面样式局部错乱 | 多个插件各自引入 Bootstrap 或图标库 | 看样式表加载顺序与重复文件 | 保留一份，其余注销入队 |
| 保存文章提示无权限 | 自定义权限被角色插件覆盖 | 打印当前用户 capabilities 对比 | 调整权限注册时机到 init 之后 |
排障有个笨办法最有效：停用全部插件，逐个启用，一次只动一个。听着慢，其实比猜快。现场排查的工具与流程，我们在 WordPress 托管维护 里做成固定动作。
自己写的插件，最容易在这三处漏
不是功能没做对，是边界没守住
忘了校验权限
接口只判断了登录，没判断角色。结果是任何注册用户都能改价格。每个写操作都要 current_user_can，别指望前端藏按钮。
直接拼 SQL
把参数直接塞进查询字符串，等于把数据库交出去。用 prepare 占位，或者干脆用 WP_Query 与元查询。
文件上传不设限
只判断了扩展名，没判断 MIME 与实际内容，php 文件改个后缀就能传上来。上传目录要禁止执行脚本。
自查一遍这三条，能挡掉大部分低级风险。站点整体的加固思路另有一套，见 WordPress 安全加固与木马清理。
交付标准：三个月后你还看得懂
这是我们对自己代码的要求
代码可读
按功能分目录，类名与函数名带前缀避免撞车，关键逻辑写中文注释。不用别人看不懂的缩写。
版本可追
插件带版本号与更新日志，改动记清改了什么、为什么改。出问题时能快速回退到上一版。
数据可迁
业务数据不写死在代码里，导出导入有对应工具。换服务器时按文档走，不依赖开发在场。
文档可用
一份安装说明、一份字段说明、一份常见问题。文档不超过五页，长了没人看，短了不解决问题。
插件定制开发常见问题
按规范写不会。业务逻辑放插件、展示逻辑放主题，这是我们划分的边界。真正容易冲突的是两个插件抢同一个钩子或同一个前端库，所以我们在开发前会先扫一遍现有插件的钩子占用。
单一功能两到三周，涉及外部系统对接的四到六周。时间主要花在确认规则与联调上，写代码反而是快的。规则说不清就开始写，最后一定返工。
只用官方推荐的接口与钩子，跟着核心升级基本没问题。我们也会在每次大版本发布后跑一轮回归测试。用了废弃函数的旧插件才容易在大版本上出事，那种属于 二次开发 的改造范围。
可以。源码、数据库结构说明、部署文档一次性交付，之后你自己找人维护也行。我们不做加密，也不把功能拆成必须联网授权的形式。
建议一个插件一个主题域。询盘分配和价格计算塞进同一个插件，改一处影响两处，排查成本翻倍。拆开之后各自独立升级，出问题也好定位。
看查询怎么写。上万条记录时，元查询的连表会明显变慢，这时候要建独立表加索引，或把常用筛选结果做缓存。产品过千的站，我们在设计阶段就会考虑这一点。
有个功能一直找不到合适的插件？
说清楚流程，我们评估能不能写
把业务场景、涉及的角色、数据从哪来到哪去讲一遍，我们给判断：该买、该改，还是该写。电话/微信 13280692153，邮箱 web@wordpressx.com。