码库记事本

码库记事本

WordPress开发中用于标题显示的相关函数分析

小诸哥 0

这篇文章主要介绍了WordPress开发中用于标题显示的相关函数使用解析,讲解了single_cat_title函数和get_the_title函数和the_title函数的用法,需要的朋友可以参考下

single_cat_title()函数

single_cat_title()函数,日常中我们很少会用到,但这个函数会给我们解决很多问题,诸如当前页面的目录、标签,该函数不依附于 WordPress 主循环中,也不能放入主循环中使用。

描述

获取当前页面的分类、标签。

<?php single_cat_title($prefix,$display); ?>

$prefix :用于设置在标题之前显示的内容。

$display :用于设置是直接显示还是返回到变量。

实例

在此摘取 WordPress 2011 默认主题中,category.php 文件 第18行左右位置的代码

  1. <?php 
  2. printf( __( 'Category Archives: %s''twentyeleven' ), '<span>' . single_cat_title( '', false ) . '</span>' ); 
  3. ?> 

get_the_title 和 the_title

get_the_title 和 the_title 两个函数用来在文章页面显示文章标题的函数,之所以将两个函数合并到一篇文章里面去是因为这两个函是一个实现,只不过 the_title 默认直接显示,get_the_title 默认返回字符串,如果你对此心存疑惑,那请你往下看。

函数详解

get_the_title 和 the_title这两个函数主要用于在循环中显示当前文章的标题,请注意 the_title 这个函数必须使用在循环中。

两者的区别在于,get_the_title仅能以字符串形式返回文章标题,而 the_title 可以设置标题前后的自定义字符,以及是显示还是返回字符串。

the_title 函数使用、参数详解

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

$before标题前的字符

$after标题后的字符

$echo显示、还是返回字符串,默认为true

the_title示例

<?php the_title( ‘=>', ‘<=' ); ?>

以本文为例,我们将得到以下这样的标题:

‘=>get_the_title 和 the_title<='

get_the_title 函数使用、参数详解

<?php $myTitle = get_the_title($ID); ?>

以上代码我们将得到文章标题的变量$myTitle;

$ID 用于设置文章 ID ,当然在循环中我们可以省略此参数。

get_the_title 示例

  1. <?php 
  2.  $myTitle = get_the_title($ID);  
  3.  echo $mytitle.'【标题演示】'
  4. ?> 

我们将得到

get_the_title 和 the_title【标题演示】

总结

说了这么多,不知道对您是否有所帮助?

总的来说 the_title 是 get_the_title的更高一级封装。就像在 wp_title中说的那样,更高级封装,虽然使用起来简单,但能折腾花样相对少了点。

下面是该两个函数的源代码

the_title 函数声明

该函数位于 wp-include/post-template.php 文件的 43 – 55行左右的位置

  1. <?php 
  2. /** 
  3.  * Display or retrieve the current post title with optional content. 
  4.  * 
  5.  * @since 0.71 
  6.  * 
  7.  * @param string $before Optional. Content to prepend to the title. 
  8.  * @param string $after Optional. Content to append to the title. 
  9.  * @param bool $echo Optional, default to true.Whether to display or return. 
  10.  * @return null|string Null on no title. String if $echo parameter is false. 
  11.  */ 
  12. function the_title($before = ''$after = ''$echo = true) { 
  13.  $title = get_the_title(); 
  14.    
  15.  if ( strlen($title) == 0 ) 
  16.  return
  17.    
  18.  $title = $before . $title . $after
  19.    
  20.  if ( $echo ) 
  21.  echo $title
  22.  else 
  23.  return $title
  24. ?> 

get_the_title 函数声明

该函数位于 wp-include/post-template.php 文件的 103 – 118行左右的位置

  1. <?php 
  2. /** 
  3.  * Retrieve post title. 
  4.  * 
  5.  * If the post is protected and the visitor is not an admin, then "Protected" 
  6.  * will be displayed before the post title. If the post is private, then 
  7.  * "Private" will be located before the post title. 
  8.  * 
  9.  * @since 0.71 
  10.  * 
  11.  * @param int $id Optional. Post ID. 
  12.  * @return string 
  13.  */ 
  14. function get_the_title( $id = 0 ) { 
  15.  $post = &get_post($id); 
  16.    
  17.  $title = isset($post->post_title) ? $post->post_title : ''
  18.  $id = isset($post->ID) ? $post->ID : (int) $id
  19.    
  20.  if ( !is_admin() ) { 
  21.  if ( !emptyempty($post->post_password) ) { 
  22.   $protected_title_format = apply_filters('protected_title_format', __('Protected: %s')); 
  23.   $title = sprintf($protected_title_format$title); 
  24.  } else if ( isset($post->post_status) && 'private' == $post->post_status ) { 
  25.   $private_title_format = apply_filters('private_title_format', __('Private: %s')); 
  26.   $title = sprintf($private_title_format$title); 
  27.  } 
  28.  } 
  29.  return apply_filters( 'the_title'$title$id ); 
  30. ?>

标签: 开发 标题 函数