# WordPress 主题开发 ## 概述创建遵循官方 WordPress 编码标准、WordPress.org 主题审核要求、WCAG 2.1 AA 级可访问性标准和现代 Web 开发最佳实践的可用于生产的 WordPress 主题。此技能生成的每个主题都是可访问的、安全的、可翻译的、高性能的，并且可以提交 WordPress.org。 ## 快速启动工作流程 1. **阅读参考资料** — 在编写任何代码之前，请阅读相关参考文件： * `references/block-theme-architecture.md` — 块主题结构、theme.json、模板、模式 * `references/classic-theme-architecture.md` — 经典主题结构、模板层次结构、循环 * `references/accessibility.md` — WCAG 2.1 AA 要求，WordPress 可访问性就绪标准 * `references/review-requirements.md` — WordPress.org 主题审核清单（14 个类别） 2. **确定主题类型** — 询问用户是否想要块主题（推荐）、经典主题或子主题 3. **收集需求** — 设计目标、调色板、版式、所需功能 4. **Scaffold** — 生成目录结构、所需文件和 theme.json 5. **构建模板和模式** — 将每个模板/模式创建为单独的文件 6. **生成 readme.txt** — 始终包含符合 WordPress.org 标准的 readme.txt 7. **交付** — 询问用户是否需要下载文件或自定义路径 ## 核心原则——始终遵循这些原则 ### 1\.块主题是默认的除非用户明确要求使用经典主题，否则始终构建**块主题**（全站编辑）。块主题： * 使用 HTML 模板文件（不是 PHP 模板文件） * 通过 `theme.json` （不是 PHP/CSS）配置设计 * 支持站点编辑器进行全可视化编辑 * 使用块模式进行可重用的布局 * 使用页眉、页脚、侧边栏的模板部分仅当用户特别请求或需要仅在经典主题中提供的功能时才构建经典主题。 ### 2\.清理函数.php `functions.php` 文件应该只包含： * 主题设置（`after_setup_theme` 钩子）——声明对主题功能的支持 * 资产排队（`wp_enqueue_scripts` 钩子） * 注册块图案、图案类别和块样式 * 注册导航菜单（经典主题） * 注册小部件区域（经典主题） * 从 `inc/` 目录加载额外的 PHP 文件 **永远不要**将冗长的逻辑、输出 HTML 或复杂的功能直接放在functions.php 中。将附加功能拆分到 `inc/` 目录中的文件中。 ### 3\.无障碍——不可协商每个主题必须满足 WCAG 2.1 AA 级和 WordPress 可访问性要求。这不是可选的。阅读 `references/accessibility.md` 了解完整的要求。关键强制项目： **跳过链接：** 第一个可聚焦元素，在焦点上可见，跳转到主要内容。 **键盘导航：** 所有交互元素均可通过键盘访问和操作。所有可聚焦元素上都有可见的焦点指示器。焦点顺序遵循逻辑阅读顺序。 **语义 HTML：** 使用正确的 HTML5 地标元素（`

`、`

Wp 主题开发

包含技能