WordPress主题开发：数据调用

记录在开发过程中常用的

引入标签：在一个模板文件里引用另外一个文件

• get_header()
• get_footer()
• get_sidebar()
• get_template_part()
• get_search_form()
• comments_template()      ----引入评论框

<?php
//调用header.php
get_header();

//调用header-one.php
get_header('one');

?>

<?php
//调用header.php
get_template_part('header');

//调用header-one.php
get_template_part('header','one');
?>

<?php
get_search_form();
//等同
get_search_form(true);

//为false时是赋值，需要另外输出
$form=get_search_form(false);
echo $form;
?>

 模版标签：

• bloginfo()
• wp_title()
• the_title()
• the_permalink()
• the_content()
• the_excerpt()
• the_category()
• the_tags()
• the_time()
• comments_popup_link()  ----评论条数
• edit_post_link()
• next_post_link()
• previous_post_link()

bloginfo() 显示博客信息,用法：

<h1><?php bloginfo( 'name' ); ?></h1>
<p><?php bloginfo('description'); ?> </p>

参数：

admin_email          = admin@example.com
atom_url             = http://www.example.com/home/feed/atom
charset              = UTF-8
comments_atom_url    = http://www.example.com/home/comments/feed/atom
comments_rss2_url    = http://www.example.com/home/comments/feed
description          = Just another WordPress blog
home                 = http://www.example.com/home (DEPRECATED! use url option instead)
html_type            = text/html
language             = en-US
name                 = Testpilot
pingback_url         = http://www.example.com/home/wp/xmlrpc.php
rdf_url              = http://www.example.com/home/feed/rdf
rss2_url             = http://www.example.com/home/feed
rss_url              = http://www.example.com/home/feed/rss
siteurl              = http://www.example.com/home (DEPRECATED! use url option instead)
stylesheet_directory = http://www.example.com/home/wp/wp-content/themes/largo
stylesheet_url       = http://www.example.com/home/wp/wp-content/themes/largo/style.css
template_directory   = http://www.example.com/home/wp/wp-content/themes/largo
template_url         = http://www.example.com/home/wp/wp-content/themes/largo
text_direction       = ltr
url                  = http://www.example.com/home
version              = 3.5
wpurl                = http://www.example.com/home/wp

wp_title()

用途：通常用在页面头部的<title>元素中，在不同文件里，返回的值不一样，具体如下：

文章页->文章标题
日期页->日期
分类页->分类标题
作者页->作者名字

用法：

 <?php wp_title( $sep, $display, $seplocation ); ?> 

$sep--分隔符，$display--是否直接显示(不直接显示需要echo才出来)，$seplocation--分隔符所在位置

the_title()

 <?php the_title( $before, $after, $echo ); ?>

参数说明：$before 标题前，$after标题后， $echo是否直接输出

用途：需放主循环内，调用发布信息的标题，在不同文件里，返回的值不一样。

<?php if( have_posts() ) : while( have_posts() ) : the_post(); ?>
<!-- 在这里调用数据 -->
<?php the_title();?>
<?php endwhile; ?>
<?php endif; ?>

the_permalink()

用途：调用当前信息的网址，必须在主循环内使用

<?php the_permalink(); ?> 

the_content()

用途：显示内容，

如果文章插入了more标签

<?php the_content( 'Read more ...' ); ?>

有参数的情况下：

the_excerpt()

用途：调用摘要，如果没有填写摘要则截取文章前55个字符

<?php the_excerpt(); ?>

 the_category()

用途：调用当前文章所属分类，必须在主循环内使用

<?php the_category( $separator, $parents, $post_id ); ?> 

参数说明：$separator--分隔符，$parents---父目录控制，$post_id---文章编号

只输出当前文章目录：

 <?php  the_category(); ?> 

去格式化输出当前文章目录：

<?php  the_category('|'); ?> 

子目录和父目录一起调出：

<?php  the_category('|','multiple'); ?> 

the_tags()

用途：调用当前分类所用的标签

<?php the_tags( $before, $sep, $after ); ?> 

参数说明：$before---标签前，$sep--分隔符，$after---标签后

the_time()

用途：调用发表时间，*需放在主循环内

<?php the_time( $d ); ?> 

参数说明：$d---时间显示格式

<?php the_time('Y-m-d h:i'); ?>

输出：2017-01-28 12:09

comments_popup_link()

用途：调用评论条数，并带跳转到该文章的评论框的链接，必须在主循环内使用

<?php comments_popup_link( $zero, $one, $more, $css_class, $none ); ?> 

参数说明：$zero--没评论的时候显示什么，$one---一条评论的时候显示什么，$more---更多评论的时候显示什么，$css_class---链接的css类，$none---文章不允许评论时显示什么

edit_post_link()

用途：有权限编辑文章时显示的编辑链接，必须在主循环内使用

<?php edit_post_link( $link, $before, $after, $id, $class ); ?> 

参数说明：$link---链接文本，$before---链接文本前的文本，$after---链接文本后的文本，$id---文章ID，$class---链接样式

next_post_link()，previous_post_link()

用途：必须在主循环内使用

<?php next_post_link("上一篇: %link") ?>
<?php previous_post_link("下一篇: %link") ?>

更多请参考文档，推荐英文版

wordpress函数参考：
英文官方参考网页：http://codex.wordpress.org/Function_Reference/
中文官方参考网页：http://codex.wordpress.org.cn/%E5%87%BD%E6%95%B0%E5%8F%82%E8%80%83

wordpress模版标签：
英文官方参考网页：http://codex.wordpress.org/Template_Tags/
中文官方参考网页：http://codex.wordpress.org.cn/%E6%A8%A1%E6%9D%BF%E6%A0%87%E7%AD%BE

wordpress引入标签：
英文官方参考网页：http://codex.wordpress.org/Include_Tags
中文官方参考网页：http://codex.wordpress.org.cn/Include_Tags

wordpress条件标签：
英文官方参考网页：http://codex.wordpress.org/Conditional_Tags
中文官方参考网页：http://codex.wordpress.org.cn/%E6%9D%A1%E4%BB%B6%E6%A0%87%E7%AD%BE