最后更新时间为 2018年6月30日
WordPress 常用模板函数速查表
简单，快速，复制/粘贴，这个页面列出用于创建，更新和维护 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())?> | 是否为天存档页面 |
<!--?php if(is_single()):?-->
//这里写你想显示的内容，包括函数
<!--?php endif;?-->
湘公网安备43020002000238