WordPress 模板层次（Template Hierarchy）和模板函数（Template Tags）是 WordPress 主题开发的核心内容。理解它们可以帮助开发者更好地控制网站的显示逻辑和功能实现。以下是关于 WordPress 模板层次和常用模板函数的详细介绍。

一、WordPress 模板层次（Template Hierarchy）

1. 主页（Home Page）

• front-page.php：用于静态首页。
• home.php：用于博客首页（如果启用了“博客页面”）。
• index.php：默认模板，如果没有其他模板匹配，WordPress 将加载此文件。

2. 单篇文章（Single Post）

• single-{post_type}-{slug}.php：针对特定文章类型和文章的模板。
• single-{post_type}.php：针对特定文章类型的模板。
• single.php：通用单篇文章模板。
• index.php：默认模板。

3. 页面（Page）

• page-{slug}.php：针对特定页面的模板。
• page-{id}.php：针对特定页面 ID 的模板。
• page.php：通用页面模板。
• index.php：默认模板。

4. 分类目录（Category）

• category-{slug}.php：针对特定分类目录的模板。
• category-{id}.php：针对特定分类目录 ID 的模板。
• category.php：通用分类目录模板。
• archive.php：通用存档模板。
• index.php：默认模板。

5. 标签（Tag）

• tag-{slug}.php：针对特定标签的模板。
• tag-{id}.php：针对特定标签 ID 的模板。
• tag.php：通用标签模板。
• archive.php：通用存档模板。
• index.php：默认模板。

6. 作者页面（Author）

• author-{nicename}.php：针对特定作者的模板。
• author-{id}.php：针对特定作者 ID 的模板。
• author.php：通用作者模板。
• archive.php：通用存档模板。
• index.php：默认模板。

7. 时间存档（Date Archive）

• date.php：通用日期存档模板。
• archive.php：通用存档模板。
• index.php：默认模板。

8. 搜索结果（Search Results）

• search.php：搜索结果模板。
• index.php：默认模板。

9. 404 页面（Not Found）

• 404.php：404 页面模板。
• index.php：默认模板。

二、常用模板函数（Template Tags）

1. 获取和显示标题

<?php the_title(); ?>  <!-- 显示文章或页面标题 -->

2. 显示内容

<?php the_content(); ?>  <!-- 显示文章或页面内容 -->

3. 显示摘要

<?php the_excerpt(); ?>  <!-- 显示文章摘要 -->

4. 获取和显示链接

<?php the_permalink(); ?>  <!-- 获取文章或页面的链接 -->
<a href="<?php the_permalink(); ?>">Read More</a>

5. 显示分类和标签

<?php the_category(', '); ?>  <!-- 显示文章分类 -->
<?php the_tags('Tags: ', ', ', ''); ?>  <!-- 显示文章标签 -->

6. 显示作者信息

<?php the_author(); ?>  <!-- 显示作者名称 -->

7. 显示日期和时间

<?php the_time('F j, Y'); ?>  <!-- 显示文章发布时间 -->
<?php the_date(); ?>  <!-- 显示文章发布日期 -->

8. 显示评论链接

<?php comments_popup_link('No Comments', '1 Comment', '% Comments'); ?>  <!-- 显示评论链接 -->

9. 显示分页导航

<?php the_posts_pagination(); ?>  <!-- 显示文章分页导航 -->

10. 显示侧边栏

<?php get_sidebar(); ?>  <!-- 显示侧边栏 -->

11. 显示头部和尾部

<?php get_header(); ?>  <!-- 显示头部 -->
<?php get_footer(); ?>  <!-- 显示尾部 -->

12. 显示自定义字段

<?php echo get_post_meta($post->ID, 'custom_field_key', true); ?>  <!-- 获取自定义字段值 -->

13. 显示图片

<?php the_post_thumbnail(); ?>  <!-- 显示特色图片 -->

14. 显示分页内容

<?php wp_link_pages(); ?>  <!-- 显示分页内容链接 -->

15. 显示搜索表单

<?php get_search_form(); ?>  <!-- 显示搜索表单 -->

三、模板层次和模板函数的应用

1. 创建自定义模板

1. 在主题目录下创建一个文件，如 page-contact.php。
2. 在文件顶部添加模板注释：
   php复制

   <?php
   /*
   Template Name: Contact Page
   */
   get_header();
   ?>
   <div id="primary" class="content-area">
       <main id="main" class="site-main">
           <?php while (have_posts()) : the_post(); ?>
               <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
                   <header class="entry-header">
                       <?php the_title('<h1 class="entry-title">', '</h1>'); ?>
                   </header>
                   <div class="entry-content">
                       <?php the_content(); ?>
                   </div>
               </article>
           <?php endwhile; ?>
       </main>
   </div>
   <?php get_footer(); ?>

2. 使用模板函数

<?php get_header(); ?>
<div id="primary" class="content-area">
    <main id="main" class="site-main">
        <?php while (have_posts()) : the_post(); ?>
            <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
                <header class="entry-header">
                    <h1 class="entry-title"><?php the_title(); ?></h1>
                </header>
                <div class="entry-meta">
                    <?php the_time('F j, Y'); ?> by <?php the_author(); ?>
                </div>
                <div class="entry-content">
                    <?php the_content(); ?>
                </div>
                <footer class="entry-footer">
                    <?php the_tags('Tags: ', ', ', ''); ?>
                </footer>
            </article>
        <?php endwhile; ?>
    </main>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

四、总结

• 模板层次：通过了解模板层次，你可以灵活地控制 WordPress 网站的显示逻辑，为不同的页面或内容类型创建自定义模板。
• 模板函数：模板函数是实现主题功能的关键工具，通过合理使用这些函数，可以动态地输出内容、链接、分类等信息。