取得文章标题,函数

来源:互联网 发布:淘宝网短裤套装 编辑:程序博客网 时间:2024/06/06 03:14

WORDPRESS之wp_title函数  

2012-07-02 15:20:27|  分类: wordpress|字号 订阅

wp_title()
该函数用来显示页面的标题,如在文章页面,则显示文章标题;在分类页面,则显示分类名称;等等。

wp_title()函数可以跟三个参数,即wp_title('separator',echo,seplocation),其中 separator是title和其余部分之间的分割符号,默认是>>;echo是个bool变量,取true显示标题,取false则将标题作为一个PHP参量返回;seplocation定义分隔符的位置,取right定义分隔符在标题后面,取其他任何值,都表示将分隔符放在标题前面。

比如形如主题文件夹下header.php中的一段代码:

在博客首页可以显示这样的效果“酷码资源 - 分享网络知识·享受快乐生活”;在文章页,可以显示这样的效果“用好WordPress不可不知的50个函数 | 酷码资源 - 分享网络知识·享受快乐生活”;而在分类页面,则可以显示这样的效果“网站相关 | 酷码资源 - 分享网络知识·享受快乐生活”;等等。


wp_title()


wp_title 函数在 WordPress 中是用来显示文章、页面、分类等等等等标题的一个函数,但在首页索引,该函数将不显示任何的东西。该函数在 WordPress 官方主题中一直被使用,但目前很多定制的主题中这个函数总是为忽视。

函数意义详解

wp_title 函数用来显示页面的标题,如在文章页面,则显示文章标题;在分类页面,则显示分类名称,但在首页索引,该函数将不显示任何的东西。
有点像 WordPress 中的 get_the_title 和 single_cat_title()这两个函数的自适应用法(自动判断是页面、文章还是分类、归档、标签)。

函数声明

有点长,希望您能耐心看一遍,哪怕只有那么一遍。

/**  * Display or retrieve page title for all areas of blog.  *  * By default, the page title will display the separator before the page title,  * so that the blog title will be before the page title. This is not good for  * title display, since the blog title shows up on most tabs and not what is  * important, which is the page that the user is looking at.  *  * There are also SEO benefits to having the blog title after or to the 'right'  * or the page title. However, it is mostly common sense to have the blog title  * to the right with most browsers supporting tabs. You can achieve this by  * using the seplocation parameter and setting the value to 'right'. This change  * was introduced around 2.5.0, in case backwards compatibility of themes is  * important.  *  * @since 1.0.0  *  * @param string $sep Optional, default is '»'. How to separate the various items within the page title.  * @param bool $display Optional, default is true. Whether to display or retrieve title.  * @param string $seplocation Optional. Direction to display title, 'right'.  * @return string|null String on retrieve, null when displaying.  */ function wp_title($sep = '»', $display = true, $seplocation = '') { global $wpdb, $wp_locale;   $m = get_query_var('m'); $year = get_query_var('year'); $monthnum = get_query_var('monthnum'); $day = get_query_var('day'); $search = get_query_var('s'); $title = '';   $t_sep = '%WP_TITILE_SEP%'; // Temporary separator, for accurate flipping, if necessary   // If there is a post if ( is_single() || ( is_home() && !is_front_page() ) || ( is_page() && !is_front_page() ) ) {  $title = single_post_title( '', false ); }   // If there's a category or tag if ( is_category() || is_tag() ) {  $title = single_term_title( '', false ); }   // If there's a taxonomy if ( is_tax() ) {  $term = get_queried_object();  $tax = get_taxonomy( $term->taxonomy );  $title = single_term_title( $tax->labels->name . $t_sep, false ); }   // If there's an author if ( is_author() ) {  $author = get_queried_object();  $title = $author->display_name; }   // If there's a post type archive if ( is_post_type_archive() )  $title = post_type_archive_title( '', false );   // If there's a month if ( is_archive() && !empty($m) ) {  $my_year = substr($m, 0, 4);  $my_month = $wp_locale->get_month(substr($m, 4, 2));  $my_day = intval(substr($m, 6, 2));  $title = $my_year . ( $my_month ? $t_sep . $my_month : '' ) . ( $my_day ? $t_sep . $my_day : '' ); }   // If there's a year if ( is_archive() && !empty($year) ) {  $title = $year;  if ( !empty($monthnum) )   $title .= $t_sep . $wp_locale->get_month($monthnum);  if ( !empty($day) )   $title .= $t_sep . zeroise($day, 2); }   // If it's a search if ( is_search() ) {  /* translators: 1: separator, 2: search phrase */ $title = sprintf(__('Search Results %1$s %2$s'), $t_sep, strip_tags($search)); }   // If it's a 404 page if ( is_404() ) {  $title = __('Page not found'); }   $prefix = ''; if ( !empty($title) )  $prefix = " $sep ";   // Determines position of the separator and direction of the breadcrumb if ( 'right' == $seplocation ) { // sep on right, so reverse the order $title_array = explode( $t_sep, $title ); $title_array = array_reverse( $title_array ); $title = implode( " $sep ", $title_array ) . $prefix; } else {  $title_array = explode( $t_sep, $title );  $title = $prefix . implode( " $sep ", $title_array ); }   $title = apply_filters('wp_title', $title, $sep, $seplocation);   // Send it out  if ( $display )   echo $title;  else   return $title;   }

用法

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

参数详解

  1. $sep:分隔符;
  2. $echo:是否显示;
  3. $seplocation:分隔符所在位置(左还是右,只接受’right’,如果不是right自动判定为左)

总结

WordPress 中相同功能的函数有很多,都是从基层到高级不断的经过封装最后到达使用层的,当然如果我们需要一些灵活用法的话,我们可以直接用中间那层的函数,如果我们懒的话我们可以直接使用最高级的那层函数,诸如本函数 wp_title ,其实这个函数我们从源代码来看, wp 替我们针对 分类、标签、文章、归档、作者、页面等多种类型的页面进行了判断,并根据不同页面调用不同的标题函数来达到目的。
如果有时间,您可以对下面几个函数进行深入研究一下,一遍更灵活的进行seo
single_post_title 文章页面提取标题的函数
single_term_title tag(标签)、cat(分类)、日期、提取标题的函数 类似于 single_cat_title()函数
get_queried_object 作者页面提取对象的函数(对象中有作者名)
post_type_archive_title()规档等等提取标题的函数
还等什么?
GO GO GO !





原创粉丝点击