SuperAPI AI 工具集

wp-block-themes

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:面向 WordPress 区块主题开发,处理 theme.json(预设、设置、样式、按区块样式)、模板(templates/.html)与模板部件(parts/.html)、区块图案(patterns/.php)及其插入器可见性、样式变体(styles/.json),并排查“样式不生效”“编辑器未反映 theme.json”等问题。

主要能力:校验区块主题目录结构(style.css、theme.json、templates/、parts/、patterns/、styles/);编写 theme.json 的 settings 与 styles;创建模板与模板部件(部件不可嵌套子目录,slug 需与 template-part 块匹配);用 PHP 文件头声明图案标题、slug、分类与关键词;创建样式变体 JSON。

使用方式:需先明确仓库根目录与目标主题、目标 WordPress 版本范围(theme.json 版本随核心版本变化)、问题出现的界面(站点编辑器、文章编辑器、前端或全部)。样式生效顺序为:核心默认值 → 父主题 theme.json → 子主题 theme.json → 用户自定义(存于数据库),后者覆盖前者。

验证与调试:确认站点编辑器与前端渲染符合预期;若样式未变,检查用户自定义是否覆盖、清理缓存、校验 JSON 语法。可用命令:cat theme.json | python3 -m json.tool;ls -la templates/ parts/;wp theme list --status=active。常见失败原因包括编辑了未启用主题、用户覆盖、JSON 语法错误、模板或部件目录位置错误或嵌套。

限制:资料未提供具体版本兼容细节、性能数据或收费信息;深入问题需查阅 Theme Handbook 的 Block Themes 与 theme.json 参考文档。