有朋自远方来,不亦乐乎。
wordpress调用函数
转载 互联网  发布于 2个月前 ( 10-19 ) 阅读: 337 次 评论: 6 条 A+

虽说不打算写技术类的文章了。但有时候还是会整理一下相关的代码,毕竟leo主题更新也好,站点维护也罢,都是需要一定的基础。

所以,今天整理一下以前就想整理的wordpress常用调用函数。

header头部常用函数

<?php site_url(); ?>站点根链接
<?php wp_title(); ?>文章或者静态页面标题
<?php bloginfo('name'); ?> 网站标题
<?php wp_title(); ?> 日志或页面标题
<?php bloginfo('stylesheet_url'); ?> WordPress主题样式表文件style.css的相对地址
<?php bloginfo('pingback_url'); ?> WordPress博客的Pingback地址
<?php bloginfo('template_url'); ?> WordPress主题文件的相对地址
<?php bloginfo('version'); ?> 博客的WordPress版本
<?php bloginfo('atom_url'); ?> WordPress博客的Atom地址
<?php bloginfo('rss2_url'); ?> WordPress博客的RSS2地址
<?php bloginfo('url'); ?> WordPress博客的绝对地址
<?php bloginfo('name'); ?> WordPress博客的名称
<?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>

主体(index)模板常用函数

<?php the_content(); ?> 日志内容
<?php if(have_posts()) : ?> 确认是否有日志
<?php while(have_posts()) : the_post(); ?> 如果有,则显示全部日志
<?php endwhile; ?> 结束PHP函数"while"
<?php endif; ?> 结束PHP函数"if"
<?php get_header(); ?> header.php文件的内容
<?php get_sidebar(); ?> sidebar.php文件的内容
<?php get_footer(); ?> footer.php文件的内容
<?php the_time('m-d-y') ?> 显示格式为"10-19-18"的日期
<?php comments_popup_link(); ?> 显示一篇日志的留言链接
<?php the_title(); ?> 显示一篇日志或页面的标题
<?php the_permalink() ?> 显示一篇日志或页面的永久链接/URL地址
<?php the_category(', ') ?> 显示一篇日志或页面的所属分类
<?php the_author(); ?> 显示一篇日志或页面的作者
<?php the_ID(); ?> 显示一篇日志或页面的ID
<?php edit_post_link(); ?> 显示一篇日志或页面的编辑链接
<?php get_links_list(); ?> 显示Blogroll中的链接
<?php comments_template(); ?> comments.php文件的内容
<?php wp_list_pages(); ?> 显示一份博客的页面列表
<?php wp_list_cats(); ?> 显示一份博客的分类列表
<?php wp_list_categories(); ?> 显示一份博客的分类列表
<?php next_post_link(' %link ') ?> 下一篇日志的URL地址
<?php previous_post_link('%link') ?> 上一篇日志的URL地址
<?php get_calendar(); ?> 调用文章日历
<?php wp_get_archives() ?> 显示一份博客的日期存档列表
<?php posts_nav_link(); ?> 显示较新日志链接(上一页)和较旧日志链接(下一页)
<?php bloginfo('description'); ?> 显示博客的描述信息
<?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(); ?> 显示登入/登出链接
<!–next page–> 在日志或页面中插入分页
<!–more–> 截断日志
<?php wp_meta(); ?> 显示管理元的相关控制信息
<?php timer_start(); ?>开始计时 (header.php)
<?php timer_stop(1); ?> 显示载入页面的时间,停止计时 (footer.php)
<?php echo get_num_queries(); ?> 显示载入页面查询
最新文章
<?php get_archives('postbypost', 10); ?> (显示10篇最新更新文章)
或者
<?php wp_get_archives('type=postbypost&limit=20&format=custom'); ?>

后面这个代码显示你博客中最新的20篇文章,其中format=custom这里主要用来自定义这份文章列表的显示样式。具体的参数和使用方法你可 以参考官方的使用说明- wp_get_archvies。(fromat=custom也可以不要,默认以UL列表显示文章标题。)

备: 通过WP的query_posts()函数也能调用最新文章列表, 虽然代码会比较多一点,但可以更好的控制Loop的显示,比如你可以设置是否显示摘要。具体的使用方法也可以查看官方的说明。

随机文章
<?php
$rand_posts = get_posts('numberposts=10&orderby=rand');
foreach( $rand_posts as $post ) :
?>
<!–下面是你想自定义的Loop–>
<li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
<?php endforeach; ?>
最新留言
<?php
global $wpdb;
$sql = "SELECT DISTINCT ID, post_title, post_password, comment_ID,
comment_post_ID, comment_author, comment_date_gmt, comment_approved,
comment_type,comment_author_url,
SUBSTRING(comment_content,1,30) AS com_excerpt
FROM $wpdb->comments
LEFT OUTER JOIN $wpdb->posts ON ($wpdb->comments.comment_post_ID =
$wpdb->posts.ID)
WHERE comment_approved = '1' AND comment_type = " AND
post_password = "
ORDER BY comment_date_gmt DESC
LIMIT 10";
$comments = $wpdb->get_results($sql);
$output = $pre_HTML;   foreach ($comments as $comment) {
$output .= '<li>".strip_tags($comment->comment_author)
.":" . " <a href="" . get_permalink($comment->ID) .
"#comment-" . $comment->comment_ID . "" title="on " .
$comment->post_title . "">" . strip_tags($comment->com_excerpt)
."</a></li>';
}   
$output .= $post_HTML;
echo $output;?>
相关文章
<?php
$tags = wp_get_post_tags($post->ID);
if ($tags) {
$first_tag = $tags[0]->term_id;
$args=array(
'tag__in' => array($first_tag),
'post__not_in' => array($post->ID),
'showposts'=>10,
'caller_get_posts'=>1
);
$my_query = new WP_Query($args);
if( $my_query->have_posts() ) {
while ($my_query->have_posts()) : $my_query->the_post(); ?>
<li><a href="<?php the_permalink() ?>" rel="bookmark" title="<?php the_title_attribute(); ?>"><?php the_title();?> <?php comments_number(' ','(1)','(%)'); ?></a></li>
<?php
endwhile;
}
}
wp_reset_query();
?>
指定分类文章
<?php $posts = get_posts( "category=4&numberposts=10" ); ?>
<?php if( $posts ) : ?>
<ul><?php foreach( $posts as $post ) : setup_postdata( $post ); ?>
<li>
<a href="<?php the_permalink() ?>" rel="bookmark" title="<?php the_title(); ?>"><?php the_title(); ?></a>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
去评论外链输出
<?php

global $wpdb;

$sql = "SELECT DISTINCT ID, post_title, post_password, comment_ID,

comment_post_ID, comment_author, comment_date_gmt, comment_approved,

comment_type,comment_author_url,

SUBSTRING(comment_content,1,14) AS com_excerpt

FROM $wpdb->comments

LEFT OUTER JOIN $wpdb->posts ON ($wpdb->comments.comment_post_ID =

$wpdb->posts.ID)

WHERE comment_approved = '1' AND comment_type = " AND

post_password = "

ORDER BY comment_date_gmt DESC

LIMIT 10";

$comments = $wpdb->get_results($sql);

$output = $pre_HTML;

foreach ($comments as $comment) {

$output .= "\n<li>".strip_tags($comment->comment_author)

.":" . " <a href=\"" . get_permalink($comment->ID) .

"#comment-" . $comment->comment_ID . "\" title=\"on " .

$comment->post_title . "\">" . strip_tags($comment->com_excerpt)

."</a></li>";

}

$output .= $post_HTML;

echo $output;?>
gravatar头像评论输出
<?php

global $wpdb;

$sql = "SELECT DISTINCT ID, post_title, post_password, comment_ID, comment_post_ID, comment_author, comment_date_gmt, comment_approved,comment_author_email, comment_type,comment_author_url, SUBSTRING(comment_content,1,10) AS com_excerpt FROM $wpdb->comments LEFT OUTER JOIN $wpdb->posts ON ($wpdb->comments.comment_post_ID = $wpdb->posts.ID) WHERE comment_approved = '1' AND comment_type = " AND comment_author != '橘 子书' AND post_password = " ORDER BY comment_date_gmt DESC LIMIT 10";

$comments = $wpdb->get_results($sql);

$output = $pre_HTML;

foreach ($comments as $comment) {

$output .= "\n<li>".get_avatar(get_comment_author_email('comment_author_email'), 18). " <a href=\"" . get_permalink($comment->ID) . "#comment-" . $comment->comment_ID . "\" title=\"" . $comment->post_title . " 上的评论\">". strip_tags($comment->comment_author) .": ". strip_tags($comment->com_excerpt) ."</a></li>";

}

$output .= $post_HTML;

$output = convert_smilies($output);

echo $output;

?>
网站统计函数
1、日志总数:
<?php $count_posts = wp_count_posts(); echo $published_posts = $count_posts->publish;?>
2、草稿数目:
<?php $count_posts = wp_count_posts(); echo $draft_posts = $count_posts->draft; ?>
3、评论总数:
<?php echo $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->comments");?>
4、成立时间:
<?php echo floor((time()-strtotime("2018-10-19"))/86400); ?>
5、标签总数:
<?php echo $count_tags = wp_count_terms('post_tag'); ?>
6、页面总数:
<?php $count_pages = wp_count_posts('page'); echo $page_posts = $count_pages->publish; ?>
7、分类总数:
<?php echo $count_categories = wp_count_terms('category'); ?>
8、链接总数:
<?php $link = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->links WHERE link_visible = 'Y'"); echo $link; ?>
9、用户总数:
<?php $users = $wpdb->get_var("SELECT COUNT(ID) FROM $wpdb->users"); echo $users; ?>
10、最后更新:
<?php $last = $wpdb->get_results("SELECT MAX(post_modified) AS MAX_m FROM $wpdb->posts WHERE (post_type = 'post' OR post_type = 'page') AND (post_status = 'publish' OR post_status = 'private')");$last = date('Y-n-j', strtotime($last[0]->MAX_m));echo $last; ?>
判断函数
判断首页 
is_home()
判断第几页 (当页面为第二页时,?paged=2)
is_paged()
判断是否是具体文章的页面
is_single()
判断是否是具体文章(id=2)的页面
is_single('2')
判断是否是具体文章(标题判断)的页面
is_single('Beef Stew')
判断是否是具体文章(标题判断)的页面
is_single('beef-stew')
是否留言开启
comments_open()
是否开启ping
pings_open()
是否是页面
is_page()
是否是id为2的页面
is_page('2')
判断标题
is_page('About Me')
slug(别名)判断
is_page('about-me')
是否是分类
is_category()
是否是id为6的分类
is_category('6')
分类title判断
is_category('Cheeses')
分类 slug判断
is_category('cheeses')
判断当前的文章是否属于分类5
in_category('5')
将所有的作者的页面显示出来
is_author()
显示author number为7的页面
is_author('7')
通过昵称来显示当前作者的页面
is_author('Elite Hacker')
别名判断作者页面
is_author('elite-hacker')
通过不同的判断实现以年、月、日、时间等方式来显示归档
is_date()
is_year()
is_month()
is_day()
is_time()
判断归档页面
is_archive()
判断搜索页面
is_search()
判断404页面
is_404()

用法举例:

<?php if(is_home())?>  true 为首页,false 为第二页

判断是否翻页,比如当前站点是https://loomob.com 显示https://loomob.com?paged=2的时候,这个判断将返回真,通过这个函数可以配合is_home来控制某些只能在首页显示的界面。

例如:

<?php if(is_single()):?>
//这里写你想显示的内容,包括函数
<?php endif;?>

或者

<?php if(is_home() && !is_paged() ):?>
//这里写你想显示的内容,包括函数
<?php endif;?>
非插件调用评论表情

直接调用wordpress自带的表情

<!–smilies–>
<?php
function wp_smilies() {
global $wpsmiliestrans;
if ( !get_option('use_smilies') or (empty($wpsmiliestrans))) return;
$smilies = array_unique($wpsmiliestrans);
$link=";
foreach ($smilies as $key => $smile) {
$file = get_bloginfo('wpurl').'/wp-includes/images/smilies/'.$smile;
$value = " ".$key." ";
$img = "<img src=\"{$file}\" alt=\"{$smile}\" />";
$imglink = htmlspecialchars($img);
$link .= "<a href=\"#commentform\" title=\"{$smile}\" onclick=\"document.getElementById('comment').value += '{$value}'\">{$img}</a> ";
}
echo '<div>'.$link.'</div>';
}
?>
<?php wp_smilies();?>
<!–smilies—>
作者相关函数
<?php the_author(); ?> 显示文章的作者
<?php the_author_description(); ?> 显示文章作者的描述(作者个人资料中的描述)
<?php the_author_login(); ?> 显示文章作者的登录名
<?php the_author_firstname(); ?> 显示文章作者的firstname(名)
<?php the_author_lastname(); ?> 显示文章作者的lastname(姓)
<?php the_author_nickname(); ?> 显示文章作者的昵称
<?php the_author_ID(); ?> 显示文章作者的ID号
<?php the_author_email(); ?> 显示文章作者的电子邮箱
<?php the_author_url(); ?> 显示文章作者的网站地址
<?php the_author_link(); ?>(添加于2.1版本) 显示一个以文章作者名为链接名,链接地址为文章作者的网址的链接。
<?php the_author_icq(); ?> (不推荐使用) 显示文章作者的icq
<?php the_author_aim(); ?> 显示文章作者的aim
<?php the_author_yim(); ?> 显示文章作者的yim
<?php the_author_msn(); ?> (不推荐使用) 显示文章作者的msn
<?php the_author_posts(); ?> 显示文章作者已发表文章的篇数
<?php the_author_posts_link(); ?> 显示一个链接到文章作者已发表文章列表的链接
<?php list_authors(); ?> (不推荐使用) 显示blog所有作者和他们的相关信息。
参数:
optioncount:是否显示各作者已发表文章的篇数,可选值为:TRUE 和 FALSE(默认值)
exclude_admin:是否不列出管理员,可选值为:TRUE(默认值) 和 FALSE
show_fullname :是否显示各作者的全名,可选值为:TRUE 和 FALSE(默认值)
hide_empty:是否不显示发表文章数为0的作者,可选值为:TRUE(默认值) 和 FALSE
feed:链接到各个作者发表文章的RSS供稿种子链接名,默认为空,不显示RSS供稿种子
feed_image:供稿种子的图片地址,如果提供此项,则覆盖上面的feed,默认为空
<?php wp_list_authors(); ?> 显示blog作者列表,如果作者发表过文章,则他的名字将链接到他发表的文章列表中。可定义是否显示其他信息。
参数:
optioncount:是否显示各个作者发表文章数,可选值:true 和 false(默认值)
exclude_admin:是否不显示"admin"用户,可选值:true(默认值) 和 false
show_fullname:是否显示各个作者的全名,如果不显示,将显示昵称。可选值:true 和 false(默认值)
hide_empty:是否不显示发表文章数为0的作者,可选值:true(默认值) 和 false
feed:链接到各个作者发表文章的RSS供稿种子链接名,默认为空,不显示RSS供稿种子
feed_image:供稿种子的图片地址,如果提供此项,则覆盖上面的feed,默认为空。
 时间函数
  1. 参数z:    描述:天数                  示例:365
  2. 参数Y:    描述:年份                  示例:2015
  3. 参数y:    描述:年份                  示例:15
  4. 参数W:    描述:周数                  示例:22
  5. 参数w:    描述:星期                  示例:2
  6. 参数T:    描述:时区                  示例:CST
  7. 参数S:    描述:序列型数字的后缀      示例:st/th
  8. 参数r:    描述:完整的日期时间        示例:Wed,25 Mar 2015 20:30:10 +0800
  9. 参数O:    描述:时区                  示例:+0800
  10. 参数n:    描述:月份                  示例:6
  11. 参数M:    描述:月份                  示例:Jan
  12. 参数m:    描述:月份                  示例:01
  13. 参数l:    描述:星期                  示例:星期一
  14. 参数A:    描述:上下午                示例:AM/PM
  15. 参数a:    描述:上下午                示例:am/pm
  16. 参数H:    描述:分钟                  示例:06
  17. 参数h:    描述:分钟                  示例:6
  18. 参数G:    描述:小时                  示例:06
  19. 参数g:    描述:小时                  示例:6
  20. 参数F:    描述:月份                  示例:一月
  21. 参数D:    描述:星期                  示例:一
  22. 参数j:    描述:日期                  示例:6
  23. 参数d:    描述:日期                  示例:06
//输出时间:年 月 日 
<?php the_time('Y年n月j日'); ?>
//输出时分秒时间:
<?php the_time('G:i:s');?>
//输出星期几:
<?php the_time('Y年n月j日l') ;?>
//wordpress中文版,参数会直接智能输出中文,比如这个
<?php the_time('M');?>
//中文版wordpress,如何输出阿拉伯数字
<?php echo date('M',get_the_time('U'));?>

备注:在网页中直接输出时间请用the_time(),如果需要调用时间,比如把它传给一个变量,写进数据库等等,就要使用data()。

 庭说

任何一个wordpress主题,都离不开一些基本的常用函数跟文件。二开或者从0写的时候,需要很熟悉它们。

基本模板文件
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	分类存档模板文件

 

 

Principle Team
龙砚庭官方QQ群,一个坚持强怼的7P成员群!
10人已关注

目前评论:6   其中:访客  3   博主  3

发表评论

莫慌,小狮子正在努力加载评论...
  1. boke112导航
    boke112导航3 ( 2018.10.23 15:00:35 )  地板

    非常有用的基础教程,弄懂这篇文章之后,折腾或DIYWordPress主题更加容易

  2. 西枫里博客
    西枫里博客3 ( 2018.10.20 19:31:29 )  板凳

    臃肿的WP :cool: :cool:

  3. 沈唁志
    沈唁志2 ( 2018.10.20 10:21:57 )  沙发

    快看,大佬又更文了!

    • 橘子书
      橘子书渣渣橘 ( 2018.10.20 11:35:59 )

      @沈唁志 不,这不是更文。而是Ctrl C+V 模式的搬运,是小萌新从很多大佬的文章里,汲取了有用的代码,汇总而成!