简单,快速,复制/粘贴,这个页面列出用于创建,更新和维护 WordPress 模板的常用函数列表。
基本模板文件
文件名 描述
style.css 主题样式文件
index.php 首页模板文件
header.php 头部模板文件
single.php 单篇文章模板文件
archive.php 存档/分类模板文件
searchform.php 搜索表单模板文件
search.php 搜索模板文件
404.php 404 模板文件
comments.php 留言模板文件
footer.php 底部模板文件
sidebar.php 侧边栏模板文件
page.php 静态页面模板文件
front-page.php 静态首页模板文件
tag.php 标签存档模板文件
category.php 分类存档模板文件
头部函数
函数名 描述
<?php site_url(); ?> 站点根链接
<?php wp_title(); ?> 文章或者静态页面标题
<?php bloginfo(‘name’); ?> 站点名称
<?php bloginfo(‘description’); ?> 站点描述
<?php get_stylesheet_directory(); ?> 样式文件所在目录
<?php bloginfo(‘stylesheet_url’); ?> 样式文件链接
<?php bloginfo(‘pingback_url’); ?> pingback 链接
<?php bloginfo(‘template_url’); ?> 模板文件所在目录链接
<?php bloginfo(‘version’); ?> WordPress 版本
<?php bloginfo(‘atom_url’); ?> atom 链接
<?php bloginfo(‘rss2_url’); ?> rss2 链接
<?php bloginfo(‘url’); ?> 网站根链接
<?php bloginfo(‘html_type’); ?> html 版本
<?php bloginfo(‘charset’); ?> 字符集
导航菜单
默认导航菜单
<?php wp_nav_menu(); ?>
指定的导航菜单
<?php wp_nav_menu( array(‘menu’ => ‘Project Nav’ )); ?>
基于分类的导航
<ul id=”menu”>
<li <?php if(is_home()) { ?> class=”current-cat” <?php } ?>>
<a href=”<?php bloginfo(‘home’); ?>”>Home</a></li>
<?php wp_list_categories(‘title_li=&orderby=id’);?>
</ul>
基于页面的导航
<ul id=”menu”>
<li <?php if(is_home()) { ?> class=”current-page-item” <?php } ?>>
<a href=”<?php bloginfo(‘home’); ?>”>Home</a></li>
<?php wp_list_pages(‘sort_column=menu_order&depth=1&title_li=’);?>
</ul>
模板函数
函数名 描述
<?php the_content(); ?> 文章内容
<?php if(have_posts()): ?> 检查是否有文章
<?php while(have_posts()): the_post(); ?> 显示文章
<?php endwhile; ?> 结束循环
<?php endif; ?> 结束判断
<?php get_header(); ?> 头部模板内容
<?php get_sidebar(); ?> 侧边栏模板内容
<?php get_footer(); ?> 底部模板内容
<?php the_time(‘m-d-y’); ?> 显示时间,格式为:’08-18-07′
<?php comments_popup_link(); ?> 显示到文章留言的链接
<?php the_title(); ?> 文章标题
<?php the_permalink(); ?> 文章链接
<?php the_category(); ?> 文章分类
<?php the_author(); ?> 文章作者
<?php the_ID(); ?> 文章 ID
<?php edit_post_link(); ?> 文章编辑链接
<?php wp_list_bookmarks(); ?> 友情链接列表
<?php comments_template(); ?> 留言模板内容
<?php wp_list_pages(); ?> 所有页面列表
<?php wp_list_categories(); ?> 所有分类列表
<?php next_post_link(‘%link’); ?> 下一篇文章链接
<?php previous_post_list(‘%link’); ?> 上一篇文章链接
<?php get_calendar(); ?> 显示文章日历
<?php wp_get_archives(); ?> 存档链接列表
<?php posts_nav_link(); ?> 上一篇和下一篇文章链接
<?php rewind_posts(); ?> 重回开头开始第二个循环
主循环
基本循环
<?php if(have_posts()) { ?>
<?php while(have_posts()) { ?>
<?php the_post(); ?>
<?php // custom post content code for title, excerpt and featured image ?>
<?php } // end while ?>
<?php } // end if ?>
其他函数
函数名 描述
/%postname%/ 自定义固定链接
<?php include(TEMPLATEPATH . ‘/x’); ?> 从模板文件夹加载文件
<?php the_search_query(); ?> 搜索表单返回的值
<?php _e(‘Message’); ?> 返回翻译之后的文本
<?php wp_register(); ?> 注册链接
<?php wp_loginout(); ?> 登录/登出链接
<!–nextpage–> 将文章那个内容分页
<!–more–> 截断文章内容,并创建到全文的链接
<?php wp_meta(); ?> 管理元链接
<?php timer_start(); ?> 开始计时 (header.php)
<?php timer_stop(1); ?> 停止计时 (footer.php)
<?php echo get_num_queries(); ?> 显示生成当前页面所需的查询数
页面判断函数
函 数 名 称 用 法 说 明
is_home() <?php if(is_home())?> true 为首页,false 为第二页 判断是否为第一页
is_paged() <?php if(is_paged())?> 当页面为第二页时,?paged=2
is_single() <?php if(is_single())?><?php if(is_single(2))?>文章 id<?php if(is_single(‘标题’))?>文章标题 是否为文章单一页面,如要针对特定文章时,可在()中加入文章的 ID 参数,或标题文字
is_page() <?php if(is_page())?><?php if(is_page(2))?>分页 id<?php if(is_page(‘标题’))?>分页标题 是否为分页,与单一页面用法相同,在()中可再针对个別的分页 ID 与标题作判断
is_category() <?php if(is_category())?><?php if(is_category(2))?>分类 id<?php if(is_category(‘标题’))?>分类标题<?php if(is_category(array(6,7)))?>分类 id 为 6、7<?php if(is_category(array(6,7,’minwt’)))?>分类 id 为 6、7 或 minwt 是否为分类,()中可输入分类 ID 与名称,再个別作判断
is_archive() <?php if(is_archive())?> 是否为存档页面
is_search() <?php if(is_search())?> 是否为搜索面
is_404 <?php if(is_404())?> 是否为找不到画面 404
is_tag() <?php if(is_tag())?> 是否为标签页面
is_date() <?php if(is_date())?> 是否为日期存档页面
is_year() <?php if(is_year())?> 是否为年份存档页面
is_month() <?php if(is_month())?> 是否为月份存档页面
is_day() <?php if(is_day())?> 是否为天存档页面
基本模板文件
文件名 描述
style.css 主题样式文件
index.php 首页模板文件
header.php 头部模板文件
single.php 单篇文章模板文件
archive.php 存档/分类模板文件
searchform.php 搜索表单模板文件
search.php 搜索模板文件
404.php 404 模板文件
comments.php 留言模板文件
footer.php 底部模板文件
sidebar.php 侧边栏模板文件
page.php 静态页面模板文件
front-page.php 静态首页模板文件
tag.php 标签存档模板文件
category.php 分类存档模板文件
头部函数
函数名 描述
<?php site_url(); ?> 站点根链接
<?php wp_title(); ?> 文章或者静态页面标题
<?php bloginfo(‘name’); ?> 站点名称
<?php bloginfo(‘description’); ?> 站点描述
<?php get_stylesheet_directory(); ?> 样式文件所在目录
<?php bloginfo(‘stylesheet_url’); ?> 样式文件链接
<?php bloginfo(‘pingback_url’); ?> pingback 链接
<?php bloginfo(‘template_url’); ?> 模板文件所在目录链接
<?php bloginfo(‘version’); ?> WordPress 版本
<?php bloginfo(‘atom_url’); ?> atom 链接
<?php bloginfo(‘rss2_url’); ?> rss2 链接
<?php bloginfo(‘url’); ?> 网站根链接
<?php bloginfo(‘html_type’); ?> html 版本
<?php bloginfo(‘charset’); ?> 字符集
导航菜单
默认导航菜单
<?php wp_nav_menu(); ?>
指定的导航菜单
<?php wp_nav_menu( array(‘menu’ => ‘Project Nav’ )); ?>
基于分类的导航
<ul id=”menu”>
<li <?php if(is_home()) { ?> class=”current-cat” <?php } ?>>
<a href=”<?php bloginfo(‘home’); ?>”>Home</a></li>
<?php wp_list_categories(‘title_li=&orderby=id’);?>
</ul>
基于页面的导航
<ul id=”menu”>
<li <?php if(is_home()) { ?> class=”current-page-item” <?php } ?>>
<a href=”<?php bloginfo(‘home’); ?>”>Home</a></li>
<?php wp_list_pages(‘sort_column=menu_order&depth=1&title_li=’);?>
</ul>
模板函数
函数名 描述
<?php the_content(); ?> 文章内容
<?php if(have_posts()): ?> 检查是否有文章
<?php while(have_posts()): the_post(); ?> 显示文章
<?php endwhile; ?> 结束循环
<?php endif; ?> 结束判断
<?php get_header(); ?> 头部模板内容
<?php get_sidebar(); ?> 侧边栏模板内容
<?php get_footer(); ?> 底部模板内容
<?php the_time(‘m-d-y’); ?> 显示时间,格式为:’08-18-07′
<?php comments_popup_link(); ?> 显示到文章留言的链接
<?php the_title(); ?> 文章标题
<?php the_permalink(); ?> 文章链接
<?php the_category(); ?> 文章分类
<?php the_author(); ?> 文章作者
<?php the_ID(); ?> 文章 ID
<?php edit_post_link(); ?> 文章编辑链接
<?php wp_list_bookmarks(); ?> 友情链接列表
<?php comments_template(); ?> 留言模板内容
<?php wp_list_pages(); ?> 所有页面列表
<?php wp_list_categories(); ?> 所有分类列表
<?php next_post_link(‘%link’); ?> 下一篇文章链接
<?php previous_post_list(‘%link’); ?> 上一篇文章链接
<?php get_calendar(); ?> 显示文章日历
<?php wp_get_archives(); ?> 存档链接列表
<?php posts_nav_link(); ?> 上一篇和下一篇文章链接
<?php rewind_posts(); ?> 重回开头开始第二个循环
主循环
基本循环
<?php if(have_posts()) { ?>
<?php while(have_posts()) { ?>
<?php the_post(); ?>
<?php // custom post content code for title, excerpt and featured image ?>
<?php } // end while ?>
<?php } // end if ?>
其他函数
函数名 描述
/%postname%/ 自定义固定链接
<?php include(TEMPLATEPATH . ‘/x’); ?> 从模板文件夹加载文件
<?php the_search_query(); ?> 搜索表单返回的值
<?php _e(‘Message’); ?> 返回翻译之后的文本
<?php wp_register(); ?> 注册链接
<?php wp_loginout(); ?> 登录/登出链接
<!–nextpage–> 将文章那个内容分页
<!–more–> 截断文章内容,并创建到全文的链接
<?php wp_meta(); ?> 管理元链接
<?php timer_start(); ?> 开始计时 (header.php)
<?php timer_stop(1); ?> 停止计时 (footer.php)
<?php echo get_num_queries(); ?> 显示生成当前页面所需的查询数
页面判断函数
函 数 名 称 用 法 说 明
is_home() <?php if(is_home())?> true 为首页,false 为第二页 判断是否为第一页
is_paged() <?php if(is_paged())?> 当页面为第二页时,?paged=2
is_single() <?php if(is_single())?><?php if(is_single(2))?>文章 id<?php if(is_single(‘标题’))?>文章标题 是否为文章单一页面,如要针对特定文章时,可在()中加入文章的 ID 参数,或标题文字
is_page() <?php if(is_page())?><?php if(is_page(2))?>分页 id<?php if(is_page(‘标题’))?>分页标题 是否为分页,与单一页面用法相同,在()中可再针对个別的分页 ID 与标题作判断
is_category() <?php if(is_category())?><?php if(is_category(2))?>分类 id<?php if(is_category(‘标题’))?>分类标题<?php if(is_category(array(6,7)))?>分类 id 为 6、7<?php if(is_category(array(6,7,’minwt’)))?>分类 id 为 6、7 或 minwt 是否为分类,()中可输入分类 ID 与名称,再个別作判断
is_archive() <?php if(is_archive())?> 是否为存档页面
is_search() <?php if(is_search())?> 是否为搜索面
is_404 <?php if(is_404())?> 是否为找不到画面 404
is_tag() <?php if(is_tag())?> 是否为标签页面
is_date() <?php if(is_date())?> 是否为日期存档页面
is_year() <?php if(is_year())?> 是否为年份存档页面
is_month() <?php if(is_month())?> 是否为月份存档页面
is_day() <?php if(is_day())?> 是否为天存档页面