Por que escolher desenvolver um tema para o WordPress do zero?
在WordPress生态中，有海量的免费和付费主题可供选择，那么为什么开发者还需要学习从零开始构建主题呢？核心原因在于控制力、性能优化和技能提升。使用现成主题虽然快捷，但往往伴随着冗余代码、不必要的功能以及难以定制的限制。从零开发意味着你可以完全掌控每一行代码，确保主题只包含网站必需的功能，从而获得更快的加载速度、更好的SEO表现和更高的安全性。
从零开始构建主题也是深入理解WordPress核心工作机制的最佳途径。你将直接与模板层级、WP_Query、动作钩子（Action Hooks）和过滤器钩子（Filter Hooks）打交道，这种理解是进行高级定制和插件开发的基础。此外，一个精心构建的自定义主题能完美匹配品牌形象和用户体验需求，这是通用主题难以企及的。
搭建开发环境与创建主题基础结构
在编写第一行代码之前，建立一个高效的本地开发环境至关重要。推荐使用Local by Flywheel、DevKinsta或Docker等工具，它们能快速配置包含PHP、MySQL和Web服务器的完整环境。
Leitura recomendada Guia de Iniciação para o Desenvolvimento de Temas WordPress: Construa o Seu Primeiro Tema Personalizado do Zero。
接下来，在你的WordPress安装目录的wp-content/themes文件夹下，创建一个新的文件夹作为你的主题目录，例如my-custom-theme。一个有效的WordPress主题至少需要两个文件：style.csseindex.php。
style.css文件不仅是样式表，更承载着主题的元信息。其文件头部注释是主题的“身份证”。
/*
Theme Name: My Custom Theme
Theme URI: https://example.com/my-custom-theme
Author: Your Name
Author URI: https://example.com
Description: 一个从零开始构建的现代化WordPress主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/Text DomainUsado para internacionalização; deve coincidir com o nome da pasta do tema.
index.php是主题的默认模板文件，也是模板层级中的最后回退。初始阶段，它可以非常简单，仅用于确保主题能被WordPress识别。
<!DOCTYPE html>
<html no numeric noise key 1006>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<?php wp_head(); ?>
</head>
<body no numeric noise key 1003>
<?php wp_body_open(); ?>
<header>
<h1>Meu tema personalizado</h1>
</header>
<main>
<?php
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
the_content();
endwhile;
endif;
?>
</main>
<footer>
<p>Informações no fundo do site</p>
</footer>
<?php wp_footer(); ?>
</body>
</html>此时，你可以在WordPress后台的“外观”->“主题”中看到并激活你的主题。
Leitura recomendada Criação de sites profissionais: um guia completo para o desenvolvimento de temas personalizados do WordPress a partir do zero。
Arquivos de modelo principais e estrutura hierárquica dos modelos
WordPress使用一套精巧的“模板层级”系统来决定为当前请求加载哪个模板文件。理解这个层级是主题开发的核心。
Compreender a ordem de carregamento dos modelos.
当用户访问一个页面时，WordPress会基于查询类型（是首页、单篇文章、页面还是分类目录？）从最具体的模板文件开始寻找，如果不存在，则逐级回退，直到使用index.php。例如，对于一篇单独的文章，WordPress会按顺序寻找：single-post-{slug}.php -> single-post-{id}.php -> single-post.php -> single.php -> singular.php -> index.php。
Criar ficheiros de modelo comuns
你需要创建以下关键模板文件来构建主题的基本结构：
* header.php: A cabeça do site, que inclui<head>Área e navegação superior.
* footer.php: Parte inferior do site.
* functions.phpArquivos funcionais do tema, utilizados para adicionar funcionalidades, registrar menus, barras laterais, etc.
* page.php: Usado para exibir páginas estáticas.
* single.php: Usado para mostrar um único artigo.
* archive.php: 用于显示文章列表（分类、标签、作者等）。
* 404.php: 404错误页面。
* search.php: 搜索结果页面。
fazer uso deget_header(), get_footer(), get_sidebar()等模板标签在模板文件中引入部件。
Melhorar as funcionalidades do tema em functions.php
functions.php是你的主题的“控制中心”。在这里，你可以通过WordPress提供的各种钩子（Hooks）来扩展和修改功能。
A funcionalidade suportada pelo tema registado.
fazer uso deadd_theme_support()函数来声明你的主题支持哪些WordPress核心功能。这通常放在一个通过after_setup_theme钩子执行的函数中。
Leitura recomendada Do zero: domine o processo central e as técnicas práticas de desenvolvimento de temas WordPress de forma eficiente。
function my_custom_theme_setup() {
// 让主题支持文章和评论的RSS feed链接
add_theme_support( 'automatic-feed-links' );
// 支持文章标题标签（Title Tag），无需手动写入<head>
add_theme_support( 'title-tag' );
// 支持文章特色图像
add_theme_support( 'post-thumbnails' );
// 支持自定义Logo
add_theme_support( 'custom-logo', array(
'height' => 100,
'width' => 400,
'flex-height' => true,
'flex-width' => true,
) );
// 支持HTML5标记（用于评论表单、搜索表单等）
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption', 'style', 'script' ) );
}
add_action( 'after_setup_theme', 'my_custom_theme_setup' );Registar o menu de navegação e a barra lateral
O menu de navegação e a barra lateral (área de ferramentas) também precisam ser incluídos.functions.phpRegistre-se.
// 注册导航菜单位置
function my_custom_theme_menus() {
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
'footer' => __( '底部菜单', 'my-custom-theme' ),
) );
}
add_action( 'init', 'my_custom_theme_menus' );
// 注册侧边栏（小工具区域）
function my_custom_theme_widgets_init() {
register_sidebar( array(
'name' => __( '主侧边栏', 'my-custom-theme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', 'my-custom-theme' ),
'before_widget' => '<section id="%1$s" class="widget %2$s">',
'after_widget' => '</section>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
) );
}
add_action( 'widgets_init', 'my_custom_theme_widgets_init' );注册后，你就可以在后台“外观”->“菜单”和“外观”->“小工具”中进行配置，并在模板中使用wp_nav_menu()edynamic_sidebar()来调用它们。
样式、脚本引入与循环控制
现代主题开发需要遵循最佳实践来管理CSS和JavaScript，并安全高效地输出文章内容。
安全地加入CSS和JavaScript
Nunca faça links diretos (hard links) para arquivos CSS e JS dentro de arquivos de template. Em vez disso, use métodos adequados para incluí-los no template.wp_enqueue_style()ewp_enqueue_script()Função, e montada emwp_enqueue_scriptsNo gancho.
function my_custom_theme_scripts() {
// 引入主题主样式表
wp_enqueue_style( 'my-custom-theme-style', get_stylesheet_uri(), array(), wp_get_theme()->get( 'Version' ) );
// 引入自定义CSS
wp_enqueue_style( 'my-custom-theme-custom', get_template_directory_uri() . '/assets/css/custom.css', array(), '1.0' );
// 引入jQuery（WordPress已内置）和自定义JS
wp_enqueue_script( 'my-custom-theme-navigation', get_template_directory_uri() . '/assets/js/navigation.js', array( 'jquery' ), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_custom_theme_scripts' );将第三个参数（$deps）设为array( 'jquery' )可以声明依赖，确保jQuery先加载。最后一个参数为true表示脚本在页面底部加载。
在循环中安全输出内容
No arquivo de modelo (por exemplo,single.php, archive.php）中，使用“循环”来输出文章内容。务必使用WordPress提供的模板标签和转义函数来确保安全。
<article id="post-<?php the_ID(); ?>" no numeric noise key 1009>
<header class="entry-header">
<h1 class="entry-title">\n</h1>
<div class="entry-meta">
</div>
</header>
<div class="entry-content">
<?php
// 输出文章内容，并应用段落过滤器等
the_content();
?>
</div>
<footer class="entry-footer">
<?php the_tags( '标签: ', ', ', '<br />' ); ?>
</footer>
</article>
<p><?php esc_html_e( '抱歉，没有找到符合条件的内容。', 'my-custom-theme' ); ?></p>fazer uso dethe_title(), the_content()等函数会自动输出内容。使用esc_html_e()ouesc_html__()对需要翻译的字符串进行转义和国际化。
resumos
从零开发一个WordPress主题是一个系统性的工程，它远不止是编写HTML和CSS。你需要理解WordPress的核心概念：模板层级决定了内容的显示逻辑；functions.php是你的功能中枢，通过钩子系统与WordPress核心交互；WP_Query和“循环”是动态内容输出的引擎；而安全地引入资源、转义输出和国际化则是构建专业级主题的必要准则。从创建最简单的style.csseindex.php开始，逐步添加模板文件、注册菜单、支持特色功能，你将一步步见证一个功能完整、高性能、易维护的自定义主题的诞生。这个过程不仅能让你打造出独一无二的网站，更能使你成为一名真正的WordPress开发者。
Perguntas frequentes Perguntas frequentes
从零开发主题必须掌握哪些编程语言？
从零开发一个WordPress主题，你需要掌握HTML、CSS和PHP作为核心语言。HTML用于构建页面结构，CSS用于样式设计和布局（建议同时了解响应式设计）。PHP是WordPress的服务器端语言，用于处理逻辑、调用数据和生成动态页面。此外，对JavaScript（尤其是jQuery）有基本了解会非常有帮助，用于实现前端交互效果。
主题开发中，如何实现页面布局的自定义？
在WordPress主题开发中，页面布局主要通过模板文件和CSS来实现。首先，你可以为不同页面类型（如首页、博客列表、单页）创建不同的模板文件（如front-page.php, home.php），在每个文件内定义独特的HTML结构。其次，利用CSS的Flexbox或Grid布局技术来实现响应式的版面设计。更高级的方法是创建多个侧边栏区域，并允许用户在后台通过“小工具”拖拽组件来动态组合布局。
什么是子主题，为什么以及如何使用它？
子主题是一个依赖于另一个主题（父主题）而工作的主题。它允许你修改或扩展父主题的功能和样式，而无需直接修改父主题的代码。这样做的好处是：当父主题更新时，你的自定义修改（在子主题中）不会被覆盖，更新过程安全无虞。
使用子主题非常简单。在wp-content/themes目录下创建一个新文件夹作为子主题，并在其中创建一个style.css文件，其文件头必须通过Template:字段声明父主题的目录名。子主题的functions.php会被优先加载，你可以在这里添加新功能或通过钩子修改父主题行为。模板文件也会被优先使用。
Como posso fazer com que o meu tema suporte vários idiomas (internacionalização)?
让主题支持多语言，即国际化（i18n），主要涉及将用户可见的文本字符串进行包装，以便被翻译工具识别。在代码中，不要直接写死英文或中文文本，而是使用WordPress的翻译函数，如()用于在PHP中返回翻译字符串，_e()用于直接输出，esc_html()用于转义并返回。
Você precisa de…style.cssNão.Text Domain和所有翻译函数调用中，使用一致的主题文本域（Text Domain）。然后，可以使用Poedit这类软件扫描你的主题代码，生成.pot翻译模板文件，译者基于此创建对应语言（如zh_CN.po）的翻译文件，最后编译成.moOs documentos foram colocados no tópico.languages文件夹。WordPress会根据网站语言设置自动加载对应翻译。
O que vem a seguir, o que vem a seguir?
Leitura ampliada e conhecimento prático
Os seguintes estão relacionados ao tópico deste artigo e são adequados para uma leitura mais aprofundada. Geralmente, é melhor priorizar o artigo que está mais próximo do seu problema atual e, em seguida, expandir gradualmente para os tópicos adjacentes.
- Como escolher e personalizar o seu tema WordPress: Um guia completo do iniciante ao avançado
- O guia definitivo para escolher o tema perfeito para o WordPress: uma análise completa, desde os frameworks até as personalizações.
- Guia Completo de Otimização de Desempenho do WordPress: Acelerando o Site de Todas as Formas, do Núcleo ao Frontend
- Como escolher um host VPS? Do básico ao avançado, ensinamos passo a passo como montar o servidor para o seu site pessoal.
- Desenvolvimento de Temas para WordPress: Do Início à Expertise: Um Guia Completo para Construir Sites Personalizados
Português do Brasil