the_excerpt()

使用示例

• 示例1

  使用过滤器控制摘要长度，默认情况下，摘录长度设置为55个单词。要使用excerpt_length过滤器将摘录长度更改为20个字，请在functions.php文件中添加以下代码

  /**
   * Filter the except length to 20 words.
   *
   * @param int $length Excerpt length.
   * @return int (Maybe) modified excerpt length.
   */
  function wpdocs_custom_excerpt_length( $length ) {
  	return 20;
  }
  add_filter( 'excerpt_length', 'wpdocs_custom_excerpt_length', 999 );
  

• 示例2

  将“阅读更多”字符串链接到帖子：
  将其放在主题的functions.php中，将“阅读更多”链接到帖子

  /**
   * Filter the "read more" excerpt string link to the post.
   *
   * @param string $more "Read more" excerpt string.
   * @return string (Maybe) modified "read more" excerpt string.
   */
  function wpdocs_excerpt_more( $more ) {
  	if ( ! is_single() ) {
  		$more = sprintf( '<a class="read-more" href="%1$s">%2$s</a>',
  			get_permalink( get_the_ID() ),
  			__( 'Read More', 'textdomain' )
  		);
  	}
  
  	return $more;
  }
  add_filter( 'excerpt_more', 'wpdocs_excerpt_more' );
  

  注意：此链接不会出现在新行上。要实现这一点，请修改.read-more类的CSS。

• 示例3

  对于WordPress 2.9及更高版本，使用过滤器修改[...]字符串

  默认情况下，末尾的摘录“read more”字符串设置为“[…]”。要使用excerpt_more过滤器更改摘录“read more”字符串，请在主题的functions.php文件中添加以下代码：

  /**
   * Filter the excerpt "read more" string.
   *
   * @param string $more "Read more" excerpt string.
   * @return string (Maybe) modified "read more" excerpt string.
   */
  function wpdocs_excerpt_more( $more ) {
  	return '[.....]';
  }
  add_filter( 'excerpt_more', 'wpdocs_excerpt_more' );
  

• 示例4

  摘录excerpt_length示例中的phpdoc在应该说“单词”的地方说“字符”。仅供参考！

• 示例5

  与条件标签一起使用，在存档页或类别页上时，将the_content()标签替换为the_excerpt()。

  以下两个示例都适用于1.5及以上版本。

  <?php if ( is_category() || is_archive() ) {
  	the_excerpt();
  } else {
  	the_content();
  } ?>
  

  此示例意味着只有一个模板文件同时用于类别和归档，例如，archive.php
  而且模板还显示了其他内容，所以这可能只是index.php。

• 示例6

  更改“[…..]”输出的简单函数文本：

  function wpdocs_excerpt_more( $more ) {
      return '<a href="'.get_the_permalink().'" rel="nofollow">Read More...</a>';
  }
  add_filter( 'excerpt_more', 'wpdocs_excerpt_more' );
  

  您可以将“my-class”的CSS更改为您想要的任何内容… 像按钮之类的。

• 示例7

  使用此过滤器最安全的方法是检查is_admin，因为它可能会在管理区域发生如下更改：

  /**
   * Filter the excerpt "read more" string.
   *
   * @param string $more "Read more" excerpt string.
   * @return string (Maybe) modified "read more" excerpt string.
   */
  function wpdocs_excerpt_more( $more ) {
  	if ( is_admin() ) {
  		return $more;
  	}
      return '[.....]';
  }
  add_filter( 'excerpt_more', 'wpdocs_excerpt_more' );

• 示例8

  如何手动添加摘录并限制长度：

  $excerpt = get_the_excerpt(); 
  
  $excerpt = substr( $excerpt, 0, 260 ); // Only display first 260 characters of excerpt
  $result = substr( $excerpt, 0, strrpos( $excerpt, ' ' ) );
  echo $result;
  

• 示例9

  默认用法，显示文章摘要。用于提供索引形式的模板，即主页、类别、标签、存档页。不用于单页视图。对于静态页面没有意义。

  用作the_content()的替代品，以强制在循环中显示摘录。

  <?php the_excerpt(); ?>
  

• 示例10

  经典编辑器：在“摘录”字段底部添加一个单词计数器

  这将在创建新帖子时在“摘录”字段下添加一个单词计数器。如果您想限制手动输入的摘录的时间，请参阅。

  将其添加到您的functions.php文件中：

  /**
   * Use jQuery to add a word counter to the excerpt box
   *
   * Should attach to all post screens and indicate the number of words just below the #excerpt textarea
   */
  function gv_excerpt_word_count_js() {
        echo '
       <script>jQuery(document).ready(function(){
  jQuery("#postexcerpt #excerpt").after("Word Count: ");
       jQuery("#excerpt-word-count").html(jQuery("#excerpt").val().split(/S+b[s,.'-:;]*/).length - 1);
       jQuery("#excerpt").keyup( function() {
       jQuery("#excerpt-word-count").html(jQuery("#excerpt").val().split(/S+b[s,.'-:;]*/).length - 1);
     });
  });</script>
      ';
  }
  add_action( 'admin_head-post.php', 'gv_excerpt_word_count_js');
  add_action( 'admin_head-post-new.php', 'gv_excerpt_word_count_js');