规范的代码让主题易维护、易发布。本文分享主题开发的代码规范要点。

前缀与命名
函数、变量加主题前缀,如mob_get_xxx,避免与其他主题插件冲突。
前缀防冲突。
转义输出
前台输出用esc_html、esc_url、esc_attr转义,防止XSS和样式错乱。
国际化准备
文案用__()和_e()包裹,方便主题国际化,也是官方审核要求。
规范的代码让主题易维护、易发布。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

规范的代码让主题易维护、易发布。本文分享主题开发的代码规范要点。

函数、变量加主题前缀,如mob_get_xxx,避免与其他主题插件冲突。
前缀防冲突。
前台输出用esc_html、esc_url、esc_attr转义,防止XSS和样式错乱。
文案用__()和_e()包裹,方便主题国际化,也是官方审核要求。
规范的代码让主题易维护、易发布。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

主题代码直接影响加载速度。本文分享主题层的性能优化要点。

只在需要的页面加载js和css,用is_函数条件判断,减少无关请求。
按需加载。
主题模板里给图片加懒加载属性,首屏外的图延后加载,提升首屏速度。
避免循环内重复查询,用WP_Query预取数据,配合对象缓存减少数据库压力。
主题代码直接影响加载速度。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

后台填了字段,前台要取出来。本文分享get_field的用法与常见坑。

循环内用get_field(字段名)取值,直接echo输出;返回false表示该文章没填这个字段。
先判空。
get_field取原值,the_field直接输出,get_sub_field配合重复器使用。
按场景选择。
图片字段返回数组需取url,日期字段返回字符串需格式化,先var_dump看结构。
后台填了字段,前台要取出来。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

ACF让WordPress后台自定义字段变得可视化。本文分享ACF的安装与字段组创建。

后台插件市场搜索ACF安装启用,免费版已支持常用字段类型。
免费够用。
ACF菜单下新建字段组,添加文本、图片、选择等字段,设置显示规则。
规则控制显示。
显示规则选择“文章”或“页面”,在对应编辑页就能看到并填写字段。
ACF让WordPress后台自定义字段变得可视化。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

页面编辑器的“模板”下拉框来自主题的自定义页面模板。本文分享如何创建。

在PHP文件顶部写上Template Name: 模板名称注释,WordPress就会把它加入下拉框。
注释即注册。
模板文件里照常写循环和布局代码,前台选择后即可生效。
选择即应用。
一个主题可以定义多个自定义页面模板,配合模板层次结构灵活组合。
页面编辑器的“模板”下拉框来自主题的自定义页面模板。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

不同页面用不同模板,page-{slug}.php是最精准的方式。本文分享创建步骤。

页面别名(slug)在编辑页面的URL部分,比如/about-us就是别名。
先看别名。
在主题目录新建page-{slug}.php,写入页面循环代码,保存后该页面自动使用此模板。
同名即生效。
首页、关于页、联系页等固定页面最适合用page-slug.php单独定制。
不同页面用不同模板,page-{slug}.php是最精准的方式。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

index.php是模板层次结构的终点。本文讲解它的角色与写法。

任何模板缺失时WordPress都会回退到index.php,它必须存在,保证主题不会报错。
必须存在。
index.php通常包含循环:the_title、the_content配合get_header和get_footer输出页面。
循环是核心。
开发时先用index.php跑通全站,再逐页拆出专业模板,效率更高。
index.php是模板层次结构的终点。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

模板层次结构决定了一个URL最终用哪个模板渲染。本文用实例讲透加载顺序。

WordPress根据URL生成查询类型:首页、单页、分类、标签或搜索,每种类型有对应的模板优先级。
类型决定路线。
以单篇文章为例:single-{slug}.php → single-{post_type}.php → single.php → singular.php → index.php。
逐级回退。
从最具体到最通用逐级回退,理解这条链,做模板就知道该建哪个文件。
模板层次结构决定了一个URL最终用哪个模板渲染。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

子主题最大的好处是模板覆盖。本文分享子主题覆盖父主题模板的方法。

在子主题放一个与父主题同名的模板文件,WordPress会优先用子主题的版本。
同名即覆盖。
比如复制父主题的page.php到子主题修改,改坏也不影响父主题,删掉即还原。
可逆修改。
functions.php不能同名覆盖,要用父子主题各自的钩子加载逻辑。
子主题最大的好处是模板覆盖。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。

子主题是改版不丢升级的最佳方案。本文分享子主题的创建步骤。

在themes下新建子主题文件夹,至少包含style.css和functions.php两个文件。
目录即子主题。
style.css头部用Template字段指向父主题目录名,声明“我是谁的子主题”。
Template字段是关键。
functions.php里用wp_enqueue_style加载父主题style,子主题再加载自己的style。
双样式加载。
子主题是改版不丢升级的最佳方案。掌握这些要点,配合本地测试环境练习,开发水平会稳步提升。