WP常用函数汇总

转自 http://www.licream.net/wp%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0%E6%B1%87%E6%80%BB.html

 

基本模板文件

style.css : CSS(样式表)文件
index.php : 主页模板
archive.php : Archive/Category模板
404.php : Not Found 错误页模板
comments.php : 留言/回复模板
footer.php : Footer模板
header.php : Header模板
sidebar.php : 侧栏模板
page.php : 内容页(Page)模板
single.php : 内容页(Post)模板
searchform.php : 搜索表单模板
search.php : 搜索结果模板

基本条件判断TAG

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页是否以多页显示

HEAD部分

<?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(); ?> : 网页加载查询量

分类列表函数wp_list_cats详解

wp_list_cats(“sort_column=name&optioncount=1&feed=RSS“);这句就是告诉它分类要依照名称排序、并显示拥有的文章数量、而且分类要显示分类RSS连结。sort_column
ID 或 name，预设为 ‘ID
分别为依 ID 值或分类名称排序

sort_order
asc 或 desc，预设为递增 asc
排序递增或递减list
0 或 1，预设为以清单方式显示： 1
设定是否以清单方式显示？
将会在分类上加上

optiondates
0 或 1，预设为不显示： 0
设定是否显示每个分类下最新发表文章的发表日期？  

optioncount
0 或 1，预设为不显示： 0
是否显示分类所拥有的文章计数？

hide_empty
0 或 1，预设为隐藏： 1
设定是否隐藏无文章的分类？

use_desc_for_title
0 或 1，预设为显示成分类说明： 1
设定分类连结的title是否显示为分类说明？

   1. title=”分类说明” href=”…

children
0 或 1，预设为显示： 1
是否显示子分类

hierarchical
0 或 1，预设为层级方式显示： 1
子分类是否以层级方式显示

child_of
无预设值
只显示某项分类（ID）的子分类
child_of=分类ID值
有设定此项目的话，hide_empty要设为0

exclude
无预设值
设定不要显示的分类ID，可为复数
如 exclude=ID1,ID2,ID3,…..

feed
无预设值
设定分类 RSS 的显示文字
如 feed=RSS
如果这个项目有设定的话，分类之後将会显示分类Feed的连结

feed_image
无预设值
设定分类 RSS 的图片路径
如 feed=images/rss.gif
如果同时有设定 feed_image 与 feed，则将以 feed_image 为主