WordPress模板标签使用手册

什么是模板标签?
模版标签是用来命令WordPress进行工作的代码。

模板标签的属性
name <?php bloginfo(‘name’); ?>
显示博客的名称. 可以在 Options(设置) > General(常规)中设置。
description <?php bloginfo(‘description’); ?>
显示博客的说明,可以在 Options(设置) > General(常规)中设置。
url <?php bloginfo(‘url’); ?>
显示博客的url地址,可以在 Options(设置) > General(常规)中设置。
admin_email <?php bloginfo(‘admin_email’); ?>
显示管理员的邮箱,可以在 Options(设置) > General(常规)中设置。
version <?php bloginfo(‘version’); ?>
显示当前使用的Wordpress的版本.

模板标签?

1-Include Tags 包含标签
comments_template <?php comments_template(‘comments-2.php’); ?>
调用评论模板comments-2.php,如果不填参数,则默认调用comments.php.
get_footer <?php get_footer(’404′); ?>
调用页脚模版 footer-404.php,如果不填参数则调用 footer.php.
get_header <?php get_header(‘home’); ?>
调用页头模版header-home.php,如果不填参数则调用 header.php.
get_search_form <?php get_search_form(); ?>
调用searchform.php.
get_sidebar <?php get_sidebar(‘cat’); ?>
调用边栏模版sidebar-cat.php,如果不填参数则调用sidebar.php.
get_template_part <?php get_template_part (‘player’,’2′); ?>
调用模板片段player-2.php,可以只填一个参数,如有两个参数,会用”-”连接字符串.(3.0新标签)
2-Blog info tags 博客信息标签

bloginfo <?php bloginfo($name); ?>
输出博客信息,$name变量有.
name = Testpilot
description = Just another WordPress blog
admin_email = admin@example
url = http://example/home
wpurl = http://example/home/wp
stylesheet_directory = http://example/home/wp/wp-content/themes/child-theme
stylesheet_url = http://example/home/wp/wp-content/themes/child-theme/style.css
template_directory = http://example/home/wp/wp-content/themes/parent-theme
template_url = http://example/home/wp/wp-content/themes/parent-theme
atom_url = http://example/home/feed/atom
rss2_url = http://example/home/feed
rss_url = http://example/home/feed/rss
pingback_url = http://example/home/wp/xmlrpc.php
rdf_url = http://example/home/feed/rdf
comments_atom_url = http://example/home/comments/feed/atom
comments_rss2_url = http://example/home/comments/feed
charset = UTF-8
html_type = text/html
language = en-US
text_direction = ltr
version = 2.9.2
bloginfo_rss <?php bloginfo_rss($name); ?>
除该标签将输出结果中的标记删除以供WordPress聚合订阅使用外,其它与bloginfo()完全相同.
get_bloginfo <?php echo get_bloginfo($name); ?>
返回博客信息的值.
get_bloginfo_rss <?php echo get_bloginfo_rss($name); ?>
同上.
3-Lists & Dropdown tags 列表&下拉菜单标签
wp_dropdown_categories <?php wp_dropdown_categories($args); ?>
输出分类的下拉菜单信息,$args变量有参见 http://codex.wordpress.org/Template_Tags/wp_dropdown_categories
wp_dropdown_pages <?php wp_dropdown_pages($args); ?>
输出页面的下拉菜单信息,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_dropdown_pages
wp_dropdown_users <?php echo wp_dropdown_users($args); ?>
输出页面的下拉菜单信息,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_dropdown_users
wp_get_archives <?php wp_get_archives($args); ?>
输出归档的列表,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_get_archives
wp_list_authors <?php wp_list_authors($args); ?>
输出作者的列表,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_list_authors
wp_list_bookmarks <?php wp_list_bookmarks($args); ?>
输出书签(链接)的列表,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_list_bookmarks
wp_list_categories <?php wp_list_categories($args); ?>
输出分类的列表,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_list_categories
wp_list_comments <?php wp_list_comments($args); ?>
输出评论的列表,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_list_comments
wp_list_pages <?php wp_list_pages($args); ?>
输出页面的列表,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_list_pages
wp_page_menu <?php wp_page_menu($name); ?>
输出包含页面的菜单信息,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_page_menu
4-Login/Logout tags 登录/登出 标签
is_user_logged_in <?php if ( is_user_logged_in() ) { … }; ?>
判断是否已登录.
wp_login_form<?php wp_login_form($args); ?>
输出登录的表单,$args变量参见 http://codex.wordpress.org/Template_Tags/wp_login_form(3.0 的新标签?)
wp_login_url <?php echo wp_login_url($redirect); ?>
返回登录的链接,并且返回到$redirect
wp_loginout <?php wp_loginout($redirect); ?>
输出登出的链接,并且返回到$redirect
wp_logout <?php wp_logout(); ?>
输出登出的链接(有问题?)
wp_logout_url <?php echo wp_logout_url($redirect); ?>
返回登出的链接,并且返回到$redirect
wp_lostpassword_url <?php wp_lostpassword_url($redirect); ?>
返回找回密码的链接,并且返回到$redirect
wp_register <?php wp_register( $before, $after ); ?>
输出注册和网站管理的列表
wp_registration_url <?php wp_registration_url($redirect); ?>
返回注册的链接,并且返回到$redirect(3.0的新标签?)
5-Post tags 文章信息标签
body_class <?php body_class( $class ); ?>
针对不同的页面输出class.
next_image_link <?php next_image_link( $size, $text ); ?>
输出当前文章的下一张图片的链接。
next_post_link <?php next_post_link(‘format’, ‘link’, ‘in_same_cat’, ‘excluded_categories’); ?>
输出下一篇文章的链接,’format’用来格式化标签,范例:‘<strong>%link</strong>’,’link’是链接的名称,’in_same_cat  ’ 判断是否同分类,’excluded_categories’是排除的分类。
next_posts_link <?php next_posts_link( $label , $max_pages ); ?>
显示下一页的链接,$label是链接名,$max_pages是大于多少页才显示,默认0.
post_class <?php post_class(); ?>
针对不同的文章输出class.
post_password_required <?php post_password_required(); ?>
要求密码才能发表?(3.0 的新标签?)
posts_nav_link <?php posts_nav_link(‘sep’,’prelabel’,’nxtlabel’); ?>
输出导航的链接,可以使用图片,详情见http://codex.wordpress.org/Template_Tags/posts_nav_link
previous_image_link <?php previous_image_link( $size, $text ); ?>
输出当前文章上一张图片的链接,详情见http://codex.wordpress.org/Template_Tags/previous_image_link
previous_post_link <?php previous_post_link($format, $link, $in_same_cat = false, $excluded_categories = ”); ?>
输出上一篇文章的链接,’format’用来格式化标签,范 例:‘<strong>%link</strong>’,’link’是链接的名称,’in_same_cat’判断是否同分 类,’excluded_categories’是排除的分类。
previous_posts_link <?php previous_posts_link( $label , $max_pages ); ?>
显示上一页的链接,$label是链接名,$max_pages是大于多少页才显示,默认0.
single_post_title <?php single_post_title( $prefix, $display ); ?>
输出当前但文章的标题,$prefix是前缀,如:’当前文章:’, $display为flase的时候,不输出,只返回该值.
sticky_class <?php sticky_class(); ?>
输出置顶文章的class,必须在循环中.
the_category <?php the_category( $separator, $parents, $post_id ); ?>
输出当前文章所属的分类,$separator是分隔符,$parents值为’single’时显示父分类,默认不显示,$post_id为获取指定id的文章的分类名
the_category_rss <?php the_category_rss( $type ) ?>
用来显示循环中分类的链接用于rss使用。
the_content <?php the_content( $more_link_text, $strip_teaser, $more_file ); ?>
输出文章的全部内容,$more_link_text是’更多’的链接名,详情见:http://codex.wordpress.org/Template_Tags/the_content
the_content_rss <?php the_content_rss(‘more_link_text’, strip_teaser, ‘more_file’, cut, encode_html); ?>
用于rss中的内容,详情见:http://codex.wordpress.org/Template_Tags/the_content_rss
the_excerpt <?php the_excerpt(); ?>
输出摘要,即去除所有标签的完整内容.
the_excerpt_rss <?php the_excerpt_rss( $cut, $encode_html ); ?>
输出用于rss中的摘要。
the_ID <?php the_ID(); ?>
输出当前文章的ID
the_meta <?php the_meta(); ?>

the_shortlink <?php the_shortlink( $text, $title, $before, $after ); ?>
输出短链接,详情见:http://codex.wordpress.org/Template_Tags/the_shortlink(3.0的新标签?)
the_tags <?php the_tags( $before, $separator, $after ); ?>
输出该文章的标签.
the_title <?php the_title( $before, $after, $display ); ?>
输出该文章的标题.$display为false的时候,不输出,只返回标题。
the_title_attribute <?php the_title_attribute( $args ); ?>
返回标题的属性,详情见:http://codex.wordpress.org/Template_Tags/the_title_attribute
the_title_rss <?php the_title_rss(); ?>
为rss格式化当前文章的标题。
wp_link_pages <?php wp_link_pages( $args ); ?>
显示当前文章的分页。
6-Comment tags 评论标签
cancel_comment_reply_link <?php cancel_comment_reply_link(‘text’); ?>
输出取消评论回复的链接.
comment_author <?php comment_author( $comment_ID ); ?>
输出评论的作者。
comment_author_email <?php comment_author_email( $comment_ID ); ?>
输出评论的作者邮箱。
comment_author_email_link <?php comment_author_email_link(‘linktext’, ‘before’, ‘after’); ?>
输出评论的作者邮箱地址.
comment_author_IP <?php comment_author_IP($comment_ID); ?>
输出评论的作者IP.
comment_author_link <?php comment_author_link( $comment_ID ); ?>
输出评论的作者链接
comment_author_rss <?php comment_author_rss(); ?>
输出用于rss的评论作者信息.
comment_author_url <?php comment_author_url( $comment_ID ); ?>
输出评论的作者的个人主页地址.
comment_author_url_link <?php comment_author_url_link(‘linktext’, ‘before’, ‘after’); ?>
输出评论的作者的个人主页地址链接。
comment_class <?php php comment_class(); ?>
输出评论的class.
comment_date <?php comment_date( ‘d’, $comment_ID ); ?>
输出评论的日期,d是日期格式字符串.
comment_excerpt <?php comment_excerpt( $comment_ID ); ?>
输出评论的摘要.
comment_form_title <?php comment_form_title(‘noreplytext’, ‘replytext’, ‘linktoparent’ ); ?>
输出评论来自的标题,范例:<div><?php comment_form_title( ‘<h2>Leave a Reply</h2>’, ‘<h2>Leave a Reply to %s</h2>’ ); ?></div>
comment_form <?php comment_form($args, $post_id); ?>
用来在模板中输出文章评论的信息.详情见:http://codex.wordpress.org/Template_Tags/comment_form(3.0 的新标签?)
comment_ID <?php comment_ID(); ?>
输出评论的ID.
comment_id_fields <?php comment_id_fields(); ?>
用于评论id的字段.
comment_reply_link <?php comment_reply_link(array_merge( $args, array(‘reply_text’ => ‘Reply’, ‘add_below’ =>
$add_below, ‘depth’ => $depth, ‘max_depth’ => $args[‘max_depth’]))); ?>
输出回复评论的链接,详情见http://codex.wordpress.org/Template_Tags/comment_reply_link.
comment_text <?php comment_text( $comment_ID ); ?>
输出评论的内容。
comment_text_rss <?php comment_text_rss(); ?>
输出用于rss的评论内容.
comment_time <?php comment_time(‘d’); ?>
输出评论的时间,d是日期格式字符串.
comment_type <?php comment_type(‘comment’, ‘trackback’, ‘pingback’); ?>
输出评论的类型,’评论’,’引用通告’或者’广播’.
comments_link <?php comments_link(); ?>
输出评论的链接.
comments_number <?php comments_number(‘zero’, ‘one’, ‘more’); ?>
输出该文章的评论数,包含三种情况. 范例:<?php comments_number(‘no responses’,’one response’,’% responses’); ?>
comments_popup_link <?php comments_popup_link(‘zero’,’one’,’more’,’CSSclass’,’none’); ?>
输出浮动评论窗口的链接,详情见:http://codex.wordpress.org/Template_Tags/comments_popup_link.有待研究.
comments_popup_script <?php comments_popup_script(width, height, ‘file’); ?>
输出浮动评论窗口的脚本。
comments_rss_link <?php comments_rss_link(‘text’, ‘file’); ?>
输出用于rss的评论链接。
get_avatar <?php echo get_avatar( $id_or_email, $size, $default, $alt ); ?>
返回评论用户的头像,详情见:http://codex.wordpress.org/Function_Reference/get_avatar.
next_comments_link <?php next_comments_link( ‘Label’, ‘Max number of pages (default 0)’ ); ?>
下一页评论的链接。
paginate_comments_links <?php paginate_comments_links(); ?>
输出评论翻页.
permalink_comments_rss <?php permalink_comments_rss(); ?>
输出用于rss的永久评论链接.
previous_comments_link <?php previous_comments_link( ‘Label’ ); ?>
上一页评论的链接。
wp_list_comments <?php wp_list_comments( $args ); ?>
输出评论的列表,详情见:http://codex.wordpress.org/Template_Tags/wp_list_comments

7-Post Thumbnail tags 文章缩略图标签
get_post_thumbnail_id <?php $id = get_post_thumbnail_id(); ?>
返回缩略图的ID.
get_the_post_thumbnail <?php echo get_the_post_thumbnail( $id, $size, $attr ); ?>
返回当前文章的缩略图,$ID是文章的ID,$size是数组,指定输出的缩略图高宽,$attr是缩略图的属性,有’thumbnail’,’medium ’和’large’可选,默认’none’。
has_post_thumbnail <?php has_post_thumbnail( $post_id ); ?>
判断该文章是否有缩略图,默认是当前文章。
the_post_thumbnail <?php the_post_thumbnail( $size, $attr ); ?>
输出当前文章的缩略图,变量同 get_the_post_thumbnail.
 

8-Attachment tags 附件标签
get_attachment_link <?php $url = get_attachment_link($post_id); ?>
返回附件的地址,默认为当前文章的附件地址.
is_attachment <?php is_attachment(); ?>
判断是否为附件.
the_attachment_link <?php the_attachment_link( $id, $fullsize, $max_dims, $permalink); ?>
输出附件的地址,$id是附件的ID,$fullsize判断是否原尺寸,$max_dims是指定高宽的数组,$permalink判断是否输出所属页面的地址,默认否
wp_attachment_is_image <?php wp_attachment_is_image( $post_id ); ?>
判断该文章的附件是否图片.
wp_get_attachment_image <?php echo wp_get_attachment_image($attachment_id, $size , $icon); ?>
返回一个图片附件,$attachment_id 是附件的id,$size是高宽的数组或者大小的字符串 thumbnail, medium, large or full,$icon是用来替代该附件显示的图标地址.
wp_get_attachment_image_src <?php $image = function wp_get_attachment_image_src( $attachment_id, $size , $icon ); ?>
返回改附件的图片地址及高宽的数组
wp_get_attachment_metadata <?php wp_get_attachment_metadata( $post_id, $unfiltered ) ?>
输出图片的元数据,$unfiltered是是否使用滤镜.

9-Category tags 分类标签
category_description <?php echo category_description( $category ); ?>
返回分类的说明,$category是分类ID.
single_cat_title <?php single_cat_title( $prefix, $display ); ?>
输出当前文章所属的分类,$prefix是前缀字符串,$display为false的时候,仅返回值. 不推荐
the_category <?php the_category( $separator, $parents, $post_id ); ?>
输出循环中的文章的所属分类,$separator是分隔符, $parents 为 ‘multiple’ 显示分类父子关系,默认为’single’ 不显示父分类 , $post_id 为文章ID.
the_category_rss <?php the_category_rss( $type ) ?>
该标签以RSS格式显示文章所属分类的名称, $type 的值为rss(默认)或rdf.
wp_dropdown_categories <?php wp_dropdown_categories( $args ); ?>
输出下拉菜单的分类列表,详情见: http://codex.wordpress.org/Template_Tags/wp_dropdown_categories
wp_list_categories <?php wp_list_categories( $args ); ?>
输出分类的列表,详情见: http://codex.wordpress.org/Template_Tags/wp_list_categories

10-Tag tags 标签标签
single_tag_title <?php single_tag_title( $prefix, $display ); ?>
输出当前文章所属的标签,$prefix是前缀字符串,$display为false的时候,仅返回值.
tag_description <?php echo tag_description( $tagID ); ?>
返回标签的说明,$tagID是指定的ID.
the_tags <?php the_tags( $before, $separator, $after ); ?>
输出循环中的文章的所属标签,$separator是分隔符.
wp_generate_tag_cloud <?php wp_generate_tag_cloud( $tags, $args ); ?>
该标签返回一个可生成标签云的HTML字符串,详情见:http://codex.wordpress.org/Template_Tags/wp_generate_tag_cloud.
wp_tag_cloud <?php wp_tag_cloud( $args ); ?>
输出标签云的列表,详情见: http://codex.wordpress.org/Template_Tags/wp_tag_cloud

11-Author tags 作者标签
the_author <?php the_author(); ?>
输出当前文章的作者.
the_author_link <?php the_author_link(); ?>
输出当前文章的作者的链接.
get_the_author_link <?php echo get_the_author_link(); ?>
返回当前文章作者的链接.
the_author_meta <?php the_author_meta( $field, $userID ); ?>
输出作者的元数据,详情见:http://codex.wordpress.org/Template_Tags/the_author_meta
the_author_posts <?php the_author_posts(); ?>
输出当前文章作者的发表文章数.
the_author_posts_link <?php the_author_posts_link(); ?>
输出该作者发表的所有文章.
wp_dropdown_users <?php wp_dropdown_users( $args ); ?>
输出作者的下拉菜单列表,详情见:http://codex.wordpress.org/Template_Tags/wp_dropdown_users
wp_list_authors <?php wp_list_authors( $args ); ?>
输出作者的列表,详情见: http://codex.wordpress.org/Template_Tags/wp_list_authors

12-Date and Time tags 日期和时间标签
get_calendar <?php get_calendar( $initial ); ?>
输出日历,$initial为是否大写判断,默认true.
get_the_date <?php get_the_date( $d ); ?>
返回当前文章的发布日期.(3.0新标签)
single_month_title <?php single_month_title( $prefix, $display ) ?>
输出当前文章的月归档. $prefix是前缀字符串,$display为false的时候,仅返回值.
the_date <?php the_date( $format, $before, $after, $echo ); ?>
输出当前文章的日期,$format是日期格式字符串,$echo 为false时只返回,不输出。
the_date_xml <?php the_date_xml(); ?>
输出YYYY-MM-DD格式的日期.
the_modified_author <?php the_modified_author(); ?>
输出最后修改的作者.
the_modified_date <?php the_modified_date( $d, $before, $after, $echo ); ?>
输出最后修改的日期. $d是日期格式字符串,$echo 为false时只返回,不输出
the_modified_time <?php the_modified_time( $d ); ?>
输出最后修改的时间.$d是日期格式字符串.
the_time <?php the_time( $d ); ?>
输出当前文章的发布时间..$d是日期格式字符串.

13-Permalink tags 永久链接标签
get_permalink <?php $permalink = get_permalink( $id ); ?>
返回文章的永久链接.
get_post_permalink <?php get_post_permalink( $id, $leavename, $sample ); ?>
返回定制文章的永久链接.详情见:http://codex.wordpress.org/Template_Tags/get_post_permalink.(3.0新标签)
permalink_anchor <?php permalink_anchor( $type ); ?>
插入永久链接的锚点,$type是文章ID或文章名Title.
permalink_single_rss <?php permalink_single_rss( $file ); ?>
按 RSS  或Atom  聚合feed形式显示当前文章的永久链接, $file是链接所指向的页面. 默认为当前页面.
post_permalink <?php post_permalink(); ?>
…(3.0 新标签)
the_permalink <?php the_permalink(); ?>
输出当前文章的永久链接.

14-Shortlink tags 短链接标签
the_shortlink <?php the_shortlink(); ?>
…(3.0 新标签)
wp_get_shortlink <?php wp_get_shortlink(); ?>
…(3.0新标签)
wp_shortlink_header <?php wp_shortlink_header(); ?>
…(3.0 新标签)
wp_shortlink_wp_head <?php wp_shortlink_wp_head(); ?>
…(3.0 新标签)

15-Links Manager tags 链接管理标签
get_bookmark <?php get_bookmark( $bookmark, $output, $filter ) ?>
根据链接的ID输出相关信息,$output(字符串)(可选) OBJECT、ARRAY_N或ARRAY_A 常量,默认值:OBJECT.
get_bookmark_field <?php get_bookmark_field(); ?>
…(3.0新标签)
get_bookmarks <?php get_bookmarks( $args ); ?>
返回链接的数组, 详情见:http://codex.wordpress.org/Function_Reference/get_bookmarks.
wp_list_bookmarks <?php wp_list_bookmarks( $args ); ?>
输出链接的列表, 详情见:http://codex.wordpress.org/Template_Tags/wp_list_bookmarks

16-Edit Link tags 编辑链接标签
edit_bookmark_link <?php edit_bookmark_link( $link, $before, $after, $bookmark ); ?>
根据链接的ID输出编辑链接的链接,$link是连接名,$bookmark是链接ID.
edit_comment_link <?php edit_comment_link( $link, $before, $after ); ?>
输出编辑评论的链接.
edit_post_link <?php edit_post_link( $link, $before, $after, $id ); ?>
输出编辑文章的链接.$link是连接名,$id是文章ID.
edit_tag_link <?php edit_tag_link( $link, $before, $after, $tag ); ?>
输出编辑标签的链接.$link是连接名,$tag是标签ID.

17-Title tags 标题标签
single_cat_title <?php single_cat_title( $prefix, $display ); ?>
输出当前的分类标题,$prefix是前缀字符串,$display为false时只返回值,不输出.
single_month_title <?php single_month_title( $prefix, $display ) ?>
输出当前月归档的标题,$prefix是前缀字符串,$display为false时只返回值,不输出.
single_post_title <?php single_post_title( $prefix, $display ); ?>
输出当前文章的标题,$prefix是前缀字符串,$display为false时只返回值,不输出.
single_tag_title <?php single_tag_title( $prefix, $display ); ?>
输出当前标签的标题,$prefix是前缀字符串,$display为false时只返回值,不输出.
the_search_query <?php the_search_query(); ?>
输出当前搜索的关键词.
wp_title <?php wp_title( $sep, $echo, $seplocation ); ?>
输出当前文章的标题,$sep是分隔符,$echo为false时只返回值不输出,$seplocation为’right’时,分隔符在右侧,否则在左侧(常用于当前位置导航).

18-Query tags 查询标签
get_posts <?php get_posts(‘arguments’); ?>
返回查询文章的数组.详情见:http://codex.wordpress.org/Function_Reference/get_posts
query_posts <?php query_posts($query_string ); ?>
仅用于修改主页循环(loop),该函数调用大量的参数,详情见:http://codex.wordpress.org/Function_Reference/query_posts.
rewind_posts <?php rewind_posts(); ?>…(3.0 新标签)
wp_reset_query <?php wp_reset_query(); ?>
配合query_posts使用,销毁自定义的循环,详情见:http://codex.wordpress.org/Function_Reference/wp_reset_query.

19-Navigation Menu tags 导航菜单标签
wp_get_nav_menu <?php wp_get_nav_menu(); ?> …(3.0 新标签)
wp_get_nav_menu_item <?php wp_get_nav_menu_item(); ?> …(3.0 新标签)
wp_nav_menu <?php wp_nav_menu($args); ?>
输出一个导航菜单,详情见:http://codex.wordpress.org/Function_Reference/wp_nav_menu(3.0 新标签)

20-Uncategorize tags 未分类标签 …(3.0 新标签)
get_admin_url <?php get_admin_url(); ?>
get_home_url <?php get_home_url($blog_id, $path, $scheme); ?>
get_search_link <?php get_search_link(); ?>
get_site_url <?php get_site_url(); ?>
home_url <?php home_url($path, $scheme); ?>
wp_ajaxurl <?php wp_ajaxurl(); ?>

赞 (0)
分享到:更多 ()