编程马·菜鸟教程

Appearance

5.2 常用模板标签 ​

在WordPress主题开发中，有一些模板标签是经常使用的，它们用于显示文章的标题、内容、摘要等基本信息。本章节将详细介绍这些常用模板标签的使用方法，帮助你更好地在主题中显示动态内容。

内容标签 ​

内容标签用于显示文章、页面等内容的基本信息，是主题开发中最常用的模板标签。

1. the_title() ​

功能：显示文章或页面的标题

语法：

php
the_title( $before, $after, $echo );

参数：

  • $before：标题前的文本（可选）
  • $after：标题后的文本（可选）
  • $echo：是否直接输出，默认为true（可选）

示例：

php
<!-- 基本用法 -->
<h2><?php the_title(); ?></h2>

<!-- 带前后文本 -->
<h2><?php the_title('<span class="title">', '</span>'); ?></h2>

<!-- 不直接输出，而是返回值 -->
<?php $title = the_title('', '', false); ?>
<h2><?php echo esc_html($title); ?></h2>

2. the_content() ​

功能：显示文章或页面的内容

语法：

php
the_content( $more_link_text, $strip_teaser, $more_file );

参数：

  • $more_link_text："阅读更多"链接的文本（可选）
  • $strip_teaser：是否删除摘要部分，默认为false（可选）
  • $more_file：自定义"阅读更多"链接的模板文件（可选）

示例：

php
<!-- 基本用法 -->
<div class="content">
    <?php the_content(); ?>
</div>

<!-- 自定义"阅读更多"链接文本 -->
<div class="content">
    <?php the_content('Read More'); ?>
</div>

3. the_excerpt() ​

功能：显示文章的摘要

语法：

php
the_excerpt( $deprecated );

参数：

  • $deprecated：已废弃的参数（可选）

示例：

php
<!-- 基本用法 -->
<div class="excerpt">
    <?php the_excerpt(); ?>
</div>

4. the_permalink() ​

功能：显示文章或页面的永久链接

语法：

php
the_permalink( $post );

参数：

  • $post：文章ID或文章对象（可选）

示例：

php
<!-- 基本用法 -->
<a href="<?php the_permalink(); ?>">Read More</a>

<!-- 用于特定文章 -->
<a href="<?php the_permalink(123); ?>">Read More</a>

元数据标签 ​

元数据标签用于显示文章、页面等的元数据，如日期、作者、分类等。

1. the_date() ​

功能：显示文章的日期

语法：

php
the_date( $format, $before, $after, $echo );

参数：

  • $format：日期格式，默认为"F j, Y"（可选）
  • $before：日期前的文本（可选）
  • $after：日期后的文本（可选）
  • $echo：是否直接输出，默认为true（可选）

示例：

php
<!-- 基本用法 -->
<span class="date"><?php the_date(); ?></span>

<!-- 自定义日期格式 -->
<span class="date"><?php the_date('Y-m-d'); ?></span>

<!-- 带前后文本 -->
<span class="date"><?php the_date('Y-m-d', 'Date: ', ''); ?></span>

2. the_author() ​

功能：显示文章的作者

语法：

php
the_author( $deprecated );

参数：

  • $deprecated：已废弃的参数（可选）

示例：

php
<!-- 基本用法 -->
<span class="author">By <?php the_author(); ?></span>

3. the_category() ​

功能：显示文章的分类

语法：

php
the_category( $separator, $parents, $post_id );

参数：

  • $separator：分类之间的分隔符，默认为" "（可选）
  • $parents：如何显示父分类，默认为0（可选）
  • $post_id：文章ID（可选）

示例：

php
<!-- 基本用法 -->
<span class="category"><?php the_category(); ?></span>

<!-- 自定义分隔符 -->
<span class="category"><?php the_category(', '); ?></span>

4. the_tags() ​

功能：显示文章的标签

语法：

php
the_tags( $before, $separator, $after );

参数：

  • $before：标签前的文本，默认为"Tags: "（可选）
  • $separator：标签之间的分隔符，默认为" "（可选）
  • $after：标签后的文本（可选）

示例：

php
<!-- 基本用法 -->
<span class="tags"><?php the_tags(); ?></span>

<!-- 自定义前后文本和分隔符 -->
<span class="tags"><?php the_tags('Tags: ', ', ', ''); ?></span>

其他常用标签 ​

1. bloginfo() ​

功能：显示网站的信息，如名称、描述、URL等

语法：

php
bloginfo( $show );

参数：

  • $show：要显示的信息类型，如"name"、"description"、"url"等

示例：

php
<!-- 显示网站名称 -->
<h1><?php bloginfo('name'); ?></h1>

<!-- 显示网站描述 -->
<p><?php bloginfo('description'); ?></p>

<!-- 显示网站URL -->
<a href="<?php bloginfo('url'); ?>">Home</a>

<!-- 显示主题样式表URL -->
<link rel="stylesheet" href="<?php bloginfo('stylesheet_url'); ?>">

2. wp_nav_menu() ​

功能：显示导航菜单

语法：

php
wp_nav_menu( $args );

参数：

  • $args：菜单参数数组，如"theme_location"、"menu_class"等

示例：

php
<!-- 基本用法 -->
<nav class="main-navigation">
    <?php wp_nav_menu(array('theme_location' => 'primary')); ?>
</nav>

<!-- 自定义菜单类和容器 -->
<nav class="main-navigation">
    <?php
    wp_nav_menu(array(
        'theme_location' => 'primary',
        'menu_class' => 'nav-menu',
        'container' => false,
        'depth' => 2,
    ));
    ?>
</nav>

3. dynamic_sidebar() ​

功能：显示侧边栏小工具

语法：

php
dynamic_sidebar( $index );

参数：

  • $index：侧边栏ID或名称

示例：

php
<!-- 基本用法 -->
<aside class="sidebar">
    <?php dynamic_sidebar('sidebar-1'); ?>
</aside>

<!-- 检查侧边栏是否有小工具 -->
<aside class="sidebar">
    <?php if (is_active_sidebar('sidebar-1')) : ?>
        <?php dynamic_sidebar('sidebar-1'); ?>
    <?php else : ?>
        <div class="widget">
            <h3>Sidebar Widget Area</h3>
            <p>Add widgets here to appear in your sidebar.</p>
        </div>
    <?php endif; ?>
</aside>

4. get_header() 和 get_footer() ​

功能：引入头部和底部模板文件

语法：

php
get_header( $name );
get_footer( $name );

参数：

  • $name：模板文件名称，如"home"、"page"等（可选）

示例：

php
<!-- 基本用法 -->
<?php get_header(); ?>

<!-- 页面内容 -->

<?php get_footer(); ?>

<!-- 引入特定的头部和底部模板 -->
<?php get_header('home'); ?>

<!-- 页面内容 -->

<?php get_footer('home'); ?>

最佳实践 ​

  1. 了解参数：在使用模板标签之前，了解其参数和用法
  2. 合理使用：根据需要选择合适的模板标签
  3. 安全输出：对于返回值的模板标签，使用esc_html()等函数进行安全输出
  4. 性能优化：避免在循环中使用过于复杂的模板标签
  5. 国际化：对于显示文本的模板标签，使用国际化函数

常见错误及解决方法 ​

1. 模板标签不显示内容 ​

问题：模板标签不显示内容，可能是因为在错误的上下文中使用

解决方法：确保在正确的上下文中使用模板标签，如在循环中使用the_title()等内容标签

2. 模板标签显示错误的内容 ​

问题：模板标签显示错误的内容，可能是因为没有正确设置当前文章

解决方法：确保在使用内容标签之前，使用the_post()函数设置当前文章

3. 模板标签参数错误 ​

问题：模板标签参数错误，导致显示异常

解决方法：查看WordPress官方文档，了解模板标签的正确参数

小结 ​

常用模板标签是WordPress主题开发中最基础、最常用的功能，它们用于显示文章的标题、内容、摘要等基本信息。通过本章节的学习，你应该：

  1. 掌握内容标签的使用方法，如the_title()、the_content()等
  2. 掌握元数据标签的使用方法，如the_date()、the_author()等
  3. 掌握其他常用标签的使用方法，如bloginfo()、wp_nav_menu()等
  4. 了解模板标签的最佳实践
  5. 了解常见错误及解决方法

在后续的章节中，我们将详细介绍条件标签和循环结构的使用方法，帮助你构建更加灵活和强大的WordPress主题。

© 2026 编程马·菜鸟教程 版权所有

基于 VitePress 构建