分类： wordpress

the_tags是WordPress中的一个内置函数，用于获取文章的标签（Tag）信息并将其显示在文章页面上。本文和大家一起学习下the_tags的基本知识及实例应用。

一、函数语法

the_tags( string $before = ”, string $sep = ”, string $after = ” )

二、参数说明

1、$before（可选）：在标签列表之前输出的字符串，默认为空。

2、$sep（可选）：标签之间的分隔符，默认为空格。

3、$after（可选）：在标签列表之后输出的字符串，默认为空。

三、实例应用

假设我们有一篇文章，其标签为”技术”、”编程”、”WordPress”。我们可以使用the_tags函数来在文章页面上显示这些标签。

<?php
    // 在主题的单篇文章模板文件（例如single.php）中使用the_tags函数
    if (have_posts()) {
        while (have_posts()) {
            the_post();
            ?>
            <div class=”entry-content”>
                <?php the_content(); ?>
            </div>
            <div class=”tag-list”>
                <?php the_tags(‘标签：’, ‘, ‘, ”); ?>
            </div>
            <?php
        }
    }
?>

以上代码将会在文章内容下方显示类似以下的标签列表：

标签：技术, 编程, WordPress

我们也可以根据需要自定义$before、$sep和$after参数的值来调整标签列表的外观和样式。

在修改和制作Wordpress主题时经常为不知道内置函数而苦恼，而wordpress官方的文档看起来又不是那么方便。所搜集并且整理了一下放这，以备后用。

判断页面函数

is_home() : 是否为主页

is_single() : 是否为内容页(Post)

is_page() : 是否为内容页(Page)

is_category() : 是否为Category/Archive页

is_tag() : 是否为Tag存档页

is_date() : 是否为指定日期存档页

is_year() : 是否为指定年份存档页

is_month() : 是否为指定月份存档页

is_day() : 是否为指定日存档页

is_time() : 是否为指定时间存档页

is_archive() : 是否为存档页

is_search() : 是否为搜索结果页

is_404() : 是否为 “HTTP 404: Not Found” 错误页

is_paged() : 主页/Category/Archive页是否以多页显示

Header部分常用到的PHP函数

<?php bloginfo(’name’); ?> : 博客名称(Title)

<?php bloginfo(’stylesheet_url’); ?> : CSS文件路径

<?php bloginfo(’pingback_url’); ?> : PingBack Url

<?php bloginfo(’template_url’); ?> : 模板文件路径

<?php bloginfo(’version’); ?> : WordPress版本

<?php bloginfo(’atom_url’); ?> : Atom Url

<?php bloginfo(’rss2_url’); ?> : RSS 2.o Url

<?php bloginfo(’url’); ?> : 博客 Url

<?php bloginfo(’html_type’); ?> : 博客网页Html类型

<?php bloginfo(’charset’); ?> : 博客网页编码

<?php bloginfo(’description’); ?> : 博客描述

<?php wp_title(); ?> : 特定内容页(Post/Page)的标题

模板常用的PHP函数及命令

<?php get_header(); ?> : 调用Header模板

<?php get_sidebar(); ?> : 调用Sidebar模板

<?php get_footer(); ?> : 调用Footer模板

<?php the_content(); ?> : 显示内容(Post/Page)

<?php if(have_posts()) : ?> : 检查是否存在Post/Page

<?php while(have_posts()) : the_post(); ?> : 如果存在Post/Page则予以显示

<?php endwhile; ?> : While 结束

<?php endif; ?> : If 结束

<?php the_time(’字符串’) ?> : 显示时间，时间格式由“字符串”参数决定，具体参考PHP手册

<?php comments_popup_link(); ?> : 正文中的留言链接。如果使用 comments_popup_script() ，则留言会在新窗口中打开，反之，则在当前窗口打开

<?php the_title(); ?> : 内容页(Post/Page)标题

<?php the_permalink() ?> : 内容页(Post/Page) Url

<?php the_category(’, ‘) ?> : 特定内容页(Post/Page)所属Category

<?php the_author(); ?> : 作者

<?php the_ID(); ?> : 特定内容页(Post/Page) ID

<?php edit_post_link(); ?> : 如果用户已登录并具有权限，显示编辑链接

<?php get_links_list(); ?> : 显示Blogroll中的链接

<?php comments_template(); ?> : 调用留言/回复模板

<?php wp_list_pages(); ?> : 显示Page列表

<?php wp_list_categories(); ?> : 显示Categories列表

<?php next_post_link(’ %link ‘); ?> : 下一篇文章链接

<?php previous_post_link(’%link’); ?> : 上一篇文章链接

<?php get_calendar(); ?> : 日历

<?php wp_get_archives() ?> : 显示内容存档

<?php posts_nav_link(); ?> : 导航，显示上一篇/下一篇文章链接

<?php include(TEMPLATEPATH . ‘/文件名’); ?> : 嵌入其他文件，可为定制的模板或其他类型文件

其他函数

<?php _e(’Message’); ?> : 输出相应信息

<?php wp_register(); ?> : 显示注册链接

<?php wp_loginout(); ?> : 显示登录/注销链接

<!–next page–> : 将当前内容分页

<!–more–> : 将当前内容截断，以不在主页/目录页显示全部内容

<?php timer_stop(1); ?> : 网页加载时间(秒)

<?php echo get_num_queries(); ?> : 网页加载查询量