建站知识

WordPress原生主题二次开发时，下面这些“高频知识点”建议先吃透。它们既能帮你快速定位要改的文件，也能避免破坏升级路径，90%的日常需求都能覆盖。

模板层级(Template Hierarchy)

先判断“WordPress现在会加载谁?”——同一类页面可以有多份模板，系统按固定优先级依次命中。

单篇文章：single-{post-type}.php→single.php→singular.php→index.php

分类目录：category-{slug}.php→category-{id}.php→category.php→archive.php→index.php

页面：自定义模板(后台可选)→page-{slug}.php→page-{id}.php→page.php→singular.php→index.php

404：404.php→index.php

牢记这条“降级链”，就能精准地把代码写到“最小粒度”文件里，避免整站通用模板写满if/else。

目录组织与最小可用文件

纯技术上index.php+style.css就能被WP识别，但二次开发建议先补齐“安全7件套”：

header.php/footer.php/sidebar.php/functions.php/single.php/page.php/404.php

再按类型分目录：

assets/
├─ css/ ├─ js/ ├─ images/
template-parts/
├─ post/ ├─ page/ ├─ navigation/
inc/
├─ custom-post-type.php ├─ shortcode.php …

在functions.php用require_onceget_template_directory().’/inc/xxx.php’;按需加载，保持主函数文件不过千行。

functions.php的“钩子思维”

只改“钩子”不动核心：

注册菜单register_nav_menus()

注册侧边栏register_sidebar()

注册主题支持add_theme_support(‘post-thumbnails’)

引入资源

add_action('wp_enqueue_scripts', function () {
    wp_enqueue_style('main', get_stylesheet_uri(), [], '1.0');
    wp_enqueue_script('main', get_template_directory_uri() . '/assets/js/main.js', [], '1.0', true);
});

这样parent主题升级不会覆盖你的逻辑。

子主题(ChildTheme)——二次开发第一站

新建文件夹父主题-child，里面放style.css与functions.php即可。

在style.css头部Template:行填写父主题目录名，WP会自动把父子样式与功能串起来。

想改哪份模板，就把父主题同名文件复制过来再改;父主题升级时你的文件安然无恙。

模板片段(TemplatePart)

复用利器：get_template_part(‘template-parts/content’,’product’)会尝试加载

template-parts/content-product.php→不存在则降级到template-parts/content.php。

把循环(loop)、卡片、导航拆成碎片，代码可读性直接翻倍。

TheLoop循环

任何要输出文章列表的地方都离不开它，最小骨架：

if (have_posts()) :
    while (have_posts()) : the_post();
        the_title('<h2>', '</h2>');
        the_content();
    endwhile;
endif;

二次开发常配合setup_postdata($post)或自定义WP_Query做多重循环，记得wp_reset_postdata()还原全局变量。

自定义文章类型&字段(CPT+Meta/ACF)

用register_post_type()与register_taxonomy()写在inc/cpt.php里，模板按层级命名：

archive-{post_type}.php、single-{post_type}.php即可自动命中。

字段输出用get_post_meta(get_the_ID(),’price’,true)或者AdvancedCustomFields的the_field(‘price’)都行，模板里尽量保持“数据–表现”分离，方便后期换前端。

国际化(i18n)

在functions.php里load_theme_textdomain(‘textdomain’,get_template_directory().’/languages’)，

模板里用__()/_e()包起需要翻译的字符串，配合Poedit生成.po/.mo扔到languages目录，后续做多语言站直接上WPML或Polylang即可。

版本与调试

开发阶段wp-config.php里打开WP_DEBUG/WP_DEBUG_LOG，浏览器即时报红。

上线前把style.cssVersion号与wp_enqueue_*的$ver统一，清缓存无烦恼。

任何修改先在子主题或专属插件完成，避免“直接动父主题→升级被覆盖→一夜回到解放前”。

掌握以上9块，就能在不碰WP核心的前提下，把原生主题改造成“高度可维护、可升级、可交接”的定制站。

• wordpress主题模板开发必须要掌握的知识点