问题描述
这是我的摘录代码。
// Generate custom excerpt length
function wpbx_excerpt_length($length) {
return 300;
}
add_filter('excerpt_length', 'wpbx_excerpt_length');
如何允许 html 像<a> <b> <i> <br>
最佳解决方案
完整的指南
我最近回答了一些有关摘录的问题,所以我将尽可能详细的说明。
前言
这个答案似乎有几个问题,代码应该在哪里,答案是,这取决于你和你如何看待合适。有几个选项可以放置代码 (如果没有明确说明):
- 在你的主题的 functions.php 或任何文件中用作函数文件。只要记住,当您执行此操作时,如果主题不是您自己的,则升级主题时,所有更改都将丢失
- 更好的方法是使用子主题中的代码。如上所述,在 functions.php 或函数相关的文件中
- 使用插件中的代码。这是首选的方式,因为这使得代码可用于所有主题。如果您切换主题,则不用担心重写相同的代码。
我希望这样清理一下:-)
HTML 标签/格式化
the_excerpt()
首先不接受任何参数,所以没有什么可以传递给它。事实上,the_excerpt()
将内容修剪为 55 个字,所有 HTML 标签在返回文本之前都被剥离。 the_excerpt()
位于 wp-includes/post-template.php 。要允许摘录中的某些或所有 HTML 标签,必须创建一个新的摘录。
首先,原来的功能需要先删除,然后新功能需要挂接到 get_the_excerpt
。请注意,这个新的摘录仍然可以作为 the_excerpt()
在模板文件中被调用,不需要改变。 get_the_excerpt()
位于 wp-includes/post-template.php 。
摘录使用 wp_trim_excerpt
返回修剪的文本,因此我们需要先从摘录过滤器中删除 wp_trim_excerpt
。 wp_trim_excerpt()
位于 wp-includes/formatting.php,第 2355 行。这是如何:
remove_filter('get_the_excerpt', 'wp_trim_excerpt');
您现在可以将您的新摘录添加到 get_the_excerpt
add_filter('get_the_excerpt', 'wpse_custom_wp_trim_excerpt');
为了允许 html 标签/格式化,我们需要指定你需要允许的标签。您可以使用以下 strip_tags
语句来实现
$wpse_excerpt = strip_tags($wpse_excerpt, wpse_allowedtags());
第二个参数 wpse_allowedtags()
是一个小功能,用于添加标签 the_excerpt()
将允许。有关 HTML 5 标签的完整列表,请查看 here 。这里是功能,添加任何你需要允许/保持的 html 标签
function wpse_allowedtags() {
// Add custom tags to this string
return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>,<p>,<img>,<video>,<audio>';
}
如果您需要允许所有 HTML 标签,即不剥离任何标签,则可以完全省略/删除 strips_tags()
功能。
然而,要注意的是,当允许 html 标签时,这些标签被算作字词,所以您的字数与片段和标签的摘录将不一样。要纠正这一点,您需要首先从实际的字数中删除这些标签,以便仅对单词进行计数。
我写了一个摘录,将允许所有的标签,仅计数单词作为单词,并在设定的单词数量之后完成一个句子 (所以文本不会被修剪 mid-sentence),并在最后一个单词之后添加一个阅读更多的文本。
这是完整的代码
function wpse_allowedtags() {
// Add custom tags to this string
return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>,<p>,<img>,<video>,<audio>';
}
if ( ! function_exists( 'wpse_custom_wp_trim_excerpt' ) ) :
function wpse_custom_wp_trim_excerpt($wpse_excerpt) {
$raw_excerpt = $wpse_excerpt;
if ( '' == $wpse_excerpt ) {
$wpse_excerpt = get_the_content('');
$wpse_excerpt = strip_shortcodes( $wpse_excerpt );
$wpse_excerpt = apply_filters('the_content', $wpse_excerpt);
$wpse_excerpt = str_replace(']]>', ']]>', $wpse_excerpt);
$wpse_excerpt = strip_tags($wpse_excerpt, wpse_allowedtags()); /*IF you need to allow just certain tags. Delete if all tags are allowed */
//Set the excerpt word count and only break after sentence is complete.
$excerpt_word_count = 75;
$excerpt_length = apply_filters('excerpt_length', $excerpt_word_count);
$tokens = array();
$excerptOutput = '';
$count = 0;
// Divide the string into tokens; HTML tags, or words, followed by any whitespace
preg_match_all('/(<[^>]+>|[^<>s]+)s*/u', $wpse_excerpt, $tokens);
foreach ($tokens[0] as $token) {
if ($count >= $excerpt_length && preg_match('/[,;?.!]s*$/uS', $token)) {
// Limit reached, continue until , ; ? . or ! occur at the end
$excerptOutput .= trim($token);
break;
}
// Add words to complete sentence
$count++;
// Append what's left of the token
$excerptOutput .= $token;
}
$wpse_excerpt = trim(force_balance_tags($excerptOutput));
$excerpt_end = ' <a href="'.%20esc_url(%20get_permalink()%20)%20.%20'">' . ' » ' . sprintf(__( 'Read more about: %s »', 'wpse' ), get_the_title()) . '</a>';
$excerpt_more = apply_filters('excerpt_more', ' ' . $excerpt_end);
//$pos = strrpos($wpse_excerpt, '</');
//if ($pos !== false)
// Inside last HTML tag
//$wpse_excerpt = substr_replace($wpse_excerpt, $excerpt_end, $pos, 0); /* Add read more next to last word */
//else
// After the content
$wpse_excerpt .= $excerpt_more; /*Add read more in new paragraph */
return $wpse_excerpt;
}
return apply_filters('wpse_custom_wp_trim_excerpt', $wpse_excerpt, $raw_excerpt);
}
endif;
remove_filter('get_the_excerpt', 'wp_trim_excerpt');
add_filter('get_the_excerpt', 'wpse_custom_wp_trim_excerpt');
您可以从需要额外的功能中删除’//’ 。
自定义长度
有时您需要显示不同长度的简单摘录,并且为每个帖子/功能/页面撰写摘录是不可行的。这是一个很好的小功能使用 wp_trim_words
function wpse_custom_excerpts($limit) {
return wp_trim_words(get_the_excerpt(), $limit, '<a href="'.%20esc_url(%20get_permalink()%20)%20.%20'">' . ' …' . __( 'Read more »', 'wpse' ) . '</a>');
}
这个小功能是采用 get_the_excerpt
,将其修剪为用户设置的 $limit
,并在结束时以更多的链接返回文本。
你可以按照你的模板来调用这个摘录
echo wpse_custom_excerpts($limit);
其中 $limit
将是您的字数,所以 30 个词的摘录将
echo wpse_custom_excerpts(30);
只要一件事要记住,如果你将限制设置为更多的 55 个字,只有 55 个字将被归还,因为摘录长度只有 55 个字。如果需要更长的摘录,请改用 get_the_content
。
自定义长度
如果只需要更改 the_excerpt()
的长度,可以使用以下功能
function wpse_excerpt_length( $length ) {
return 20;
}
add_filter( 'excerpt_length', 'wpse_excerpt_length', 999 );
记住,您将需要设置大于 10 的优先级,以便在默认情况下执行自定义功能。
添加阅读更多链接
摘录中返回的所有文本都有可疑的 [...]
。要在 hellips 的地方添加一个阅读更多的文本,请使用此功能
function wpse_excerpt_more( $more ) {
return ' <a class="read-more" href="'.%20get_permalink(%20get_the_ID()%20)%20.%20'">' . __('Read More', 'your-text-domain') . '</a>';
}
add_filter( 'excerpt_more', 'wpse_excerpt_more' );
编辑
摘录第一段
我想保持这个完整,所以这是在第一段之后修剪的摘录
这是一个保持 HTML 标签的功能,在摘录末尾添加了一个 “阅读更多” 链接,并在第一段之后修剪了摘录。
if ( ! function_exists( 'wpse0001_custom_wp_trim_excerpt' ) ) :
function wpse0001_custom_wp_trim_excerpt($wpse0001_excerpt) {
global $post;
$raw_excerpt = $wpse0001_excerpt;
if ( '' == $wpse0001_excerpt ) {
$wpse0001_excerpt = get_the_content('');
$wpse0001_excerpt = strip_shortcodes( $wpse0001_excerpt );
$wpse0001_excerpt = apply_filters('the_content', $wpse0001_excerpt);
$wpse0001_excerpt = substr( $wpse0001_excerpt, 0, strpos( $wpse0001_excerpt, '</p>' ) + 4 );
$wpse0001_excerpt = str_replace(']]>', ']]>', $wpse0001_excerpt);
$excerpt_end = ' <a href="'.%20esc_url(%20get_permalink()%20)%20.%20'">' . ' » ' . sprintf(__( 'Read more about: %s »', 'pietergoosen' ), get_the_title()) . '</a>';
$excerpt_more = apply_filters('excerpt_more', ' ' . $excerpt_end);
//$pos = strrpos($wpse0001_excerpt, '</');
//if ($pos !== false)
// Inside last HTML tag
//$wpse0001_excerpt = substr_replace($wpse0001_excerpt, $excerpt_end, $pos, 0);
//else
// After the content
$wpse0001_excerpt .= $excerpt_end;
return $wpse0001_excerpt;
}
return apply_filters('wpse0001_custom_wp_trim_excerpt', $wpse0001_excerpt, $raw_excerpt);
}
endif;
remove_filter('get_the_excerpt', 'wp_trim_excerpt');
add_filter('get_the_excerpt', 'wpse0001_custom_wp_trim_excerpt');
编辑 29-10-2015
对于任何需要解决方法的人,如果节选时间短于设置的字数,则在摘录后不显示阅读更多链接,请参阅以下问题和答案
参考文献
注:本文内容整合自 Google/Baidu/Bing 辅助翻译的英文资料结果。如果您对结果不满意,可以加入我们改善翻译效果:薇晓朵技术论坛。