WordPress 主题构建 是做什么的?
目标是创建一个设计锁定在代码中、内容在编辑器中可编辑的主题。模板中的硬编码文本是客户要求进行琐碎修改的最常见原因。
选择方法
| 方法 | 何时选择 |
|---|---|
区块主题(theme.json、HTML 模板) | 新构建,客户在站点编辑器中进行编辑,内容主要是标准区块 |
混合经典主题(PHP 模板加上 theme.json 和区块模式) | 需要精确 HTML 控制的复杂自定义标记或大量动画 |
| 子主题 | 修改现有主题;切勿直接编辑父主题,因为更新会覆盖它 |
对于以动画、设计为导向的市场营销网站,混合方法通常是务实的选择:在 PHP 中保留精确的标记,通过模式、字段和区块编辑器使内容可编辑。
最小结构
my-theme/
├── style.css # 主题头部注释(必需)
├── functions.php # 设置、入队、注册
├── theme.json # 调色板、字号、间距、布局宽度
├── index.php # 回退模板(经典/混合)
├── front-page.php # 首页
├── header.php footer.php
├── template-parts/ # 每个部分一个文件
├── patterns/ # 区块模式(自动注册)
├── assets/css assets/js assets/media
└── screenshot.png # 1200x900
style.css 头部:
/*
Theme Name: 我的主题
Author: 你的名字
Version: 1.0.0
Requires at least: 6.4
Requires PHP: 8.0
Text Domain: my-theme
*/
转换工作流程
- 冻结静态构建。 首先完成 HTML、CSS 和 JS 并验证。转换一个不断变化的目标会使工作量加倍。
- 拆分为部件。 头部和脚部放入
header.php和footer.php,并调用wp_head()和wp_footer()。每个首页部分成为template-parts/中的一个文件,通过get_template_part()加载。 - 将令牌迁移到
theme.json(调色板、字号、间距、内容宽度),以便编辑器显示与前端的相同选项。保持与 CSS 自定义属性相同的值;WordPress 会生成--wp--preset--*变量,你可以为其创建别名。如果webcraftCLI 可用,webcraft tokens "#brand" --format theme-json -o theme.json会根据与tokens.css相同的值写入一个第 3 版文件。 - 入队资产,切勿硬编码:
add_action('wp_enqueue_scripts', function () {
$v = wp_get_theme()->get('Version');
$uri = get_theme_file_uri('assets');
wp_enqueue_style('my-theme', "$uri/css/main.css", [], $v);
wp_enqueue_script('gsap', "$uri/js/vendor/gsap.min.js", [], '3', ['strategy' => 'defer', 'in_footer' => true]);
wp_enqueue_script('my-theme', "$uri/js/main.js", ['gsap'], $v, ['strategy' => 'defer', 'in_footer' => true]);
});
尽可能将库文件打包到本地,而不是使用 CDN;这可以避免第三方请求和同意问题。 5. 使内容可编辑。 按部分选择:
- 拥有独立页面的重复项(服务、作品集、推荐信):使用
WP_Query查询的自定义文章类型。 - 一次性章节文本和图片:客户端插入和编辑的区块模式,或自定义字段。
- 全局项目(电话、社交链接、页脚文本):使用自定义器或小型选项页面。
- 导航:
register_nav_menus()和wp_nav_menu()。
- 输出时转义所有内容:
esc_html()、esc_attr()、esc_url()、富文本使用wp_kses_post()。使用__()或esc_html__()包裹字符串,并指定文本域。 - 图片: 使用
wp_get_attachment_image()以便生成srcset、sizes、尺寸和懒加载。使用add_image_size()注册所需的尺寸。 - 主题支持:
title-tag、post-thumbnails、editor-styles、responsive-embeds、html5、wp-block-styles。
WordPress 中的动画
- 隐藏内容的脚本不得在区块编辑器中运行。仅在前端入队它们(使用
wp_enqueue_scripts,而不是enqueue_block_assets)。 - 管理栏会使固定头部偏移 32px(移动端 46px);使用
body.admin-bar .header { top: var(--wp-admin--admin-bar--height, 32px); }进行补偿。 - 延迟或合并 JS 的缓存和优化插件可能会破坏加载顺序。正确声明依赖关系,并启用插件进行测试。
- 编辑器中添加的内容不会具有你的动画属性。要么在 JS 中按区块类应用动画,要么提供包含这些属性的模式。
禁止事项
- 编辑 WordPress 核心或父主题。
- 将应在主题切换后保留的功能(自定义文章类型、短代码)放在主题中;如果客户可能会更换主题,小型插件才是正确的位置。
- 在循环内部进行查询而不重置(
wp_reset_postdata())。 - 在启用
WP_DEBUG的情况下发布带有通知的代码。开发时请打开WP_DEBUG。 - 捆绑付费插件或其许可证不允许再分发的资产。
交接清单
- 客户可以更改所有可见文本、图片、菜单项和联系信息,而无需接触代码。
- 在“设置”>“阅读”中设置首页;永久链接设置为文章名称。
- 存在网站图标(站点图标)、404 模板、搜索模板、隐私页面。
- 提供包含截图的单页编辑指南。
- 然后运行
launch-qa技能。