如果你是一个 WordPress 主题作者,你肯定会经常到 WordPress 的 Codex 去搜索一些常用的模板函数,每次查询的话,有点麻烦,所以为了方便查询,制作了这个 WordPress 常用模板函数速查表。
这个速查表列出你制作主题时候常用的函数,你可以直接复制到你的主题中使用,并且大部分函数都链接到了其 Codex 页面以便了解更多详细使用。
基本模板文件
文件名 | 描述 |
---|---|
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'); ?> | 字符集 | 链接 |
导航菜单
默认导航菜单
代码语言:javascript复制<?php wp_nav_menu(); ?>
指定的导航菜单
代码语言:javascript复制<?php wp_nav_menu( array('menu' => 'Project Nav' )); ?>
基于分类的导航
代码语言:javascript复制<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>
基于页面的导航
代码语言:javascript复制<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(); ?> | 重回开头开始第二个循环 | 链接 |
主循环
代码语言:javascript复制<?php if(have_posts()) { ?>
<?php while(have_posts()) { the_post(); ?>
<?php // 显示文章标题,内容缩略图等的代码?>
<?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(); ?> | 显示生成当前页面所需的查询数 | 链接 |