对于任何想要深度定制网站外观和功能的开发者来说，学习WordPress主题开发是一项极具价值的技能。与使用现成主题不同，自己构建主题意味着你拥有完全的控制权，可以打造出独一无二、性能卓越且符合特定需求的网站。本文将引导你完成构建第一款自定义WordPress主题的核心步骤，从环境搭建到基础模板文件的创建。
개발 환경 및 도구 준비
코드를 작성하기 시작하기 전에, 적합한 로컬 개발 환경이 필요합니다. 이를 통해 온라인 웹사이트에 영향을 주지 않고 테스트와 디버깅을 수행할 수 있습니다.
로컬 서버 환경 설정
推荐使用集成的本地服务器软件包，如XAMPP、MAMP（适用于Mac）或Local by Flywheel。这些工具一键安装了Apache服务器、MySQL数据库和PHP，省去了繁琐的配置过程。以XAMPP为例，安装后启动Apache和MySQL服务，你就拥有了一个本地的服务器环境。
코드 편집기 선택
一个功能强大的代码编辑器是高效开发的必备工具。Visual Studio Code (VS Code) 是目前非常流行的选择，它免费、轻量，并且拥有丰富的扩展插件，如PHP Intelephense（用于PHP代码智能提示）、WordPress Snippet（代码片段）和Live Server（实时预览）等，能极大提升开发效率。
WordPress核心文件安装
로컬 서버의 루트 디렉터리(예: XAMPP의 `htdocs` 폴더)에 `my-first-theme`과 같은 새로운 프로젝트 폴더를 만드세요. 그런 다음 WordPress.org 공식 웹사이트에서 최신 버전의 WordPress 압축 파일을 다운로드하여 압축을 해제한 후 모든 파일을 `my-first-theme` 폴더에 저장하세요. 이후 브라우저를 사용하여 `http://localhost/my-first-theme`에 접속한 뒤, 유명한 “5분 안에 설치하기” 가이드에 따라 WordPress를 설치하세요. 설치 과정에서 설정한 데이터 이름, 사용자 이름, 비밀번호를 꼭 기억해 두세요. 이 정보는 나중에 데이터베이스에 연결할 때 필요합니다.
创建主题的基本结构与文件
一个WordPress主题本质上是一个位于`wp-content/themes/`目录下的文件夹，其中包含一系列具有特定功能的PHP模板文件、样式表和脚本文件。
主题文件夹与样式表
먼저, 로컬 WordPress 설치 디렉터리 내의 `wp-content/themes/`로 이동한 다음, 주제 이름(예: `mycustomtheme`)으로 새로운 폴더를 생성하세요. 이 폴더 내에서 반드시 만들어야 할 첫 번째이자 가장 중요한 파일은 `style.css`입니다. 이 파일의 헤더에 포함된 주석은 주제에 대한 정보를 명시하는 데 사용될 뿐만 아니라, WordPress가 해당 주제를 인식하는 데에도 필수적입니다.
추천 읽기 워드프레스 테마 개발 입문 가이드: 처음부터 나만의 사용자 정의 테마 구축하기。
```css
/*
Theme Name: My Custom Theme
Theme URI: https://example.com/mycustomtheme
Author: Your Name
Author URI: https://example.com
Description: 这是我的第一款自定义WordPress主题，用于学习开发。
Version: 1.0.0
License: GPL v2 or later
Text Domain: mycustomtheme
*/
```
核心模板文件：index.php 与 functions.php
创建`index.php`文件。这是主题的默认和后备模板文件，如果其他更具体的模板文件不存在，WordPress就会使用它来渲染页面。最初，它可以非常简单。
아래는 PHP 코드입니다.
<!DOCTYPE html>
<html no numeric noise key 1000>
<head>
<meta charset="">
<meta name="viewport" content="width=device-width, initial-scale=1">
<?php wp_head(); ?>
</head>
<body no numeric noise key 1000>
<h1><a href="/ko/</?php echo esc_url( home_url( '/' ) ); ?>"></a></h1>
<p></p>
<?php
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
// 暂时简单输出文章标题
the_title( '<h2>', '</h2>' );
the_content();
endwhile;
else :
echo '<p>현재 기사가 없습니다.</p>';
endif;
?>
<?php wp_footer(); ?>
</body>
</html>
```
接下来，创建`functions.php`文件。这是你主题的“引擎”，用于添加功能、启用特性（如文章缩略图）和排队加载样式与脚本。
아래는 PHP 코드입니다.
<?php
// 启用文章特色图像功能
`add_theme_support('post-thumbnails');`;
// 添加菜单支持
add_theme_support( 'menus' );
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'mycustomtheme' ),
) );
// 正确引入主样式表
function mycustomtheme_enqueue_styles() {
wp_enqueue_style( 'mycustomtheme-style', get_stylesheet_uri() );
}
add_action( 'wp_enqueue_scripts', 'mycustomtheme_enqueue_styles' );
```
추천 읽기 워드프레스 테마 개발 시작하기: 처음부터 첫 번째 사용자 정의 테마 만들기。
完成以上步骤后，登录你的WordPress后台，在“外观”->“主题”中，你应该能看到“My Custom Theme”出现，点击启用它。
模板层级与常用模板文件
理解WordPress的模板层级是主题开发的核心。它决定了WordPress针对不同类型的页面请求，会优先使用哪个模板文件。
模板层级概念
WordPress는 현재 보고 있는 페이지의 유형에 따라 템플릿 파일을 특정 우선순위에 따라 찾습니다. 예를 들어, 개별 블로그 글을 방문할 때 WordPress는 다음과 같은 순서로 템플릿 파일을 찾습니다: `single-post.php` -> `single.php` -> `singular.php` -> `index.php`. 존재하는 첫 번째 파일을 찾으면 그 파일을 사용합니다.
자주 사용하는 템플릿 파일을 만드세요.
基于这个层级，你可以开始创建更具体的模板文件来丰富你的主题。
- `header.php` 和 `footer.php`：将`index.php`中的头部和页脚代码分离到这两个文件中，然后在`index.php`中使用`get_header()`和`get_footer()`函数引入。这实现了代码重用。
- `page.php`：用于显示静态页面。你可以先复制`index.php`的内容来创建它，然后进行个性化修改。
- `single.php`：用于显示单篇文章。通常这里会包含文章标题、内容、发布日期、作者、分类和标签等信息。
- `archive.php`：用于显示文章归档列表，如分类、标签、作者或日期归档页。
- `front-page.php`：如果存在此文件，它将用作网站的首页，优先级高于`home.php`和`index.php`。你可以在这里设计独特的首页布局。
创建这些文件后，你的主题结构将更加清晰和专业。
추천 읽기 WordPress 테마 개발 완전 가이드: 초보자부터 전문가까지。
添加样式与基础功能
一个没有样式的主题是原始的，而一些基础功能则能极大提升主题的实用性和用户体验。
编写基础CSS样式
在`style.css`的头部注释下方，开始编写你的样式规则。首先从重置浏览器默认样式、设置全局字体和颜色开始，然后逐步为头部、导航、主内容区、侧边栏（如果以后添加）和页脚设计样式。使用响应式设计媒体查询，确保网站在手机、平板和电脑上都能良好显示。
```css
/* 基础重置与全局样式 */
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
line-height: 1.6;
color: #333;
background-color: #f4f4f4;
}
.container {
width: 90%;
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
/* 头部样式 */
header {
background: #333;
color: #fff;
padding: 1rem 0;
텍스트 정렬: 가운데;
}
/* 导航菜单样式 */
.primary-menu {
/* 你的导航菜单样式 */
}
```
实现导航菜单与侧边栏
在`header.php`中你预留的菜单位置，使用`wp_nav_menu()`函数来调用在`functions.php`中注册的菜单。
아래는 PHP 코드입니다.
```
要添加侧边栏，首先需要在`functions.php`中注册一个侧边栏小工具区域。
아래는 PHP 코드입니다.
function mycustomtheme_widgets_init() {
register_sidebar( array(
'name' => __( '主侧边栏', 'mycustomtheme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', 'mycustomtheme' ),
'before_widget' => '
그런 다음, 사이드바가 표시되기를 원하는 위치(예: `index.php` 또는 `single.php`의 메인 콘텐츠 영역 옆)에서 `dynamic_sidebar('sidebar-1')` 함수를 사용하여 사이드바를 표시하세요.
요약
通过本文的步骤，你已经完成了从零开始构建一款基础WordPress自定义主题的旅程。我们介绍了如何搭建本地开发环境，创建了包含`style.css`、`index.php`和`functions.php`在内的核心主题文件，理解了模板层级并扩展了常用模板，最后为主题添加了基础样式和导航菜单、侧边栏等功能。这只是一个起点，接下来你可以继续探索更高级的模板（如搜索页面`search.php`、404页面`404.php`），学习使用WordPress循环（The Loop）的更多功能，集成JavaScript框架，或者将你的主题提交到WordPress官方主题目录。持续实践和探索官方开发手册是提升技能的最佳途径。
자주 묻는 질문
WordPress 테마를 개발하기 위해서는 어떤 사전 지식이 필요한가요?
你需要具备HTML和CSS的基础知识，用于构建网页结构和样式。同时，对PHP有基本的理解至关重要，因为WordPress主题主要是由PHP模板文件构成的。了解一点JavaScript会对添加交互功能有帮助，但入门阶段并非必须。
为什么我的新主题没有在WordPress后台的主题列表中显示？
请首先检查你的主题文件夹是否被正确放置在`wp-content/themes/`目录下。然后，确认`style.css`文件是否存在于该文件夹的根目录，并且其头部注释信息（Theme Name等）格式是否正确。任何一个错误都可能导致WordPress无法识别你的主题。
functions.php文件的作用是什么？
`functions.php`文件是你的主题的功能中心。它用于启用或修改WordPress核心功能（如添加主题支持选项），注册导航菜单、侧边栏小工具区域，安全地加载CSS样式表和JavaScript脚本，以及定义自定义函数和过滤器。它是扩展主题能力的关键文件。
내 테마를 다국어로 지원하려면 어떻게 해야 하나요?
让主题支持多语言（国际化与本地化）是一项重要实践。你需要在`style.css`的头部和`functions.php`中设置正确的`Text Domain`（文本域），然后在代码中所有需要翻译的字符串处使用`__()`或`_e()`等翻译函数进行包裹。之后，可以使用像Poedit这样的工具生成`.po`和`.mo`语言文件，供翻译者使用。
开发完成后，如何将主题部署到线上网站？
部署主题主要有两种方式。一种是通过FTP/SFTP客户端（如FileZilla）直接将你本地的主题文件夹上传到线上网站的`wp-content/themes/`目录。另一种更专业的方式是将主题打包成ZIP文件，然后通过WordPress后台的“外观”->“主题”->“添加新主题”->“上传主题”功能进行安装。无论哪种方式，部署前都建议在线上网站的测试环境进行充分测试。
다음 단계는 무엇인가요?
확장된 독서 및 실무 지식
다음은 이 도움말의 주제와 관련이 있으며 더 깊이 있게 읽기에 적합합니다. 현재 문제와 가장 가까운 문서부터 시작하여 점차 주변 주제로 확장하는 것이 우선순위를 정하는 것이 좋습니다.
한국어