参数
- $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 | 开始引入 |
使用示例
覆盖存档/单页行为
如果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();
置顶文章忽略 “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' ) ); }
在“More”链接中加入标题
当使用时,显示 “Continue reading ACTUAL POST TITLE”<?php the_content( 'Continue reading ' . get_the_title() ); ?>
指定 “More” 链接文本
当使用快速标记时,显示文章的内容并使用 "Read more …"作为更多链接文本。<?php the_content( 'Read more ...' ); ?>