SuperAPI AI 工具集

wp-rest-api

编程与开发

查看项目

更新于 10-16 01:34

技能介绍

用途:把已在别处生成的区块标记、CSS 和动画 JS 原样传输到 WordPress 站点,走 /wp-json/ 接口,用 curl 与管理员 Application Password 认证,替代手工复制粘贴到代码编辑器。依赖 curl、jq(1.6+),验证步骤还需 grep 和 diff,不需要 MCP 服务器、CLI、SSH 或数据库访问。

主要能力:推送页面区块标记(按 slug 查询后 PUT 或 POST,读回 content.raw 逐字节比对);在区块主题上把 CSS 写入用户 global-styles 记录的 styles.css(需深合并,不能整体替换);通过 Code Snippets 插件的 code-snippets/v1 路由推送 PHP 或 JS 片段(先创建为 inactive,验证后再激活);提供端点、安全规则、Gutenberg 陷阱、代码片段、动画、故障排查等参考文档。

使用方式:先做三项预检——无认证 GET /wp-json/ 确认 wp/v2 存在;认证 GET /wp/v2/users/me?context=edit 确认管理员权限;GET /wp/v2/themes?status=active 确认是区块主题并取得 global-styles 记录 id(不可硬编码)。凭据放 gitignored 的 .env,用 curl -u "$WP_USER:$WP_APP_PASSWORD",仅发往用户指定的单一 https 源。写页面时按 slug 查询,命中则 PUT /wp/v2/pages/<id>,未命中才 POST 集合路由;未要求改状态时不要带 status 键。CSS 推送前用 grep -c '<' 确认无左尖括号,否则 Site Editor 会整体拒绝。

适用场景:区块主题站点的页面标记与站点级 CSS 更新、需要注入动画初始化或钩子的代码片段。

限制:经典主题没有 global-styles 记录,CSS 需改用 PHP 片段入队样式表;不支持编辑模板或模板部件、上传媒体、菜单与导航、区块模式(均未测试);Application Password 不能登录 wp-admin;最终必须由人工在区块编辑器中打开页面确认,前端截图与读回比对不能替代这一步。