当前浏览:首页 / WordPress函数 / the_content()

the_content( string $more_link_text = null, bool $strip_teaser = false )

显示文章内容

content

themore...


参数

$more_link_text

(string) (可选) “更多”链接的文本

默认值: null

$strip_teaser

(bool) (可选) 删除“更多”文本前面的前导内容

默认值: false


说明

如果在帖子中使用快速标记<!--more-->来指定要摘录的文章的“截取点”,the_content()函数将仅在非单页文章页面上显示<!--more-->快速标记点的摘录。根据设计,<!--more-->标记包含一个用于格式化the_content()内容和外观的参数,该参数创建了一个“继续阅读”全文的链接。

<!--more--> 注意事项:

  • 在 <!--more--> 快速标记的“more”前面不允许有空格,比如 <!-- more --> 将不会起作用!
  • 在只显示单个文章的模板页 <!--more--> 快速标记将无效,比如 single.php.
  • 阅读 Customizing the Read More 了解更多。


源码

查看源码 官方文档


更新日志

版本描述
0.71开始引入

使用示例

  • 示例1

    覆盖存档/单页行为
    如果 the_content() 没有预期结果 (例如,你只想显示 <!--more--> 前面的内容,而不是全文) 你可以使用全局 $more 来覆盖

    // Declare global $more (before the loop).
    global $more;
    
    // Set (inside the loop) to display content above the more tag.
    $more = 0;
    
    the_content( 'More ...' );
    ?>
    

    如果你需要显示全文

    // Declare global $more (before the loop).
    global $more;
    
    // Set (inside the loop) to display all content, including text below more.
    $more = 1;
    
    the_content();
    
  • 示例2

    置顶文章忽略 “More”

    这将会显示置顶文章的全文而忽略more,即使文中有 <!--more--> 标记,其他文章则正常

    // Declare global $more (before the loop).
    global $more;
    
    if ( is_sticky() ) {
    	// Set (inside the loop) to display all content, including text below more.
    	$more = 1;
    
    	the_content();
    } else {
    	$more = 0;
    
    	the_content( __( 'Read the rest of this entry »', 'textdomain' ) );
    }
    
  • 示例3

    在“More”链接中加入标题
    当使用时,显示 “Continue reading ACTUAL POST TITLE” 

    <?php the_content( 'Continue reading ' . get_the_title() ); ?>
    
  • 示例4

    指定 “More” 链接文本
    当使用快速标记时,显示文章的内容并使用 "Read more …"作为更多链接文本。

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