我正在使用wp_trim_words修剪我主页上的一些摘录.它工作正常,除了它从摘录中剥离HTML标签.我需要能够使摘录的某些部分变为粗体(使用< strong>).按照here的说明,我尝试删除wp_trim_words函数并使用以下代码将其替换为新函数,该函数替换$text = wp_strip_all_tags($text);来自原始的WP函数与$text = strip_tags($text,’< strong>‘,);.但这打破了网站.我究竟做错了什么？
// Remove Reverie Trim Words
function remove_trim_words() {
remove_filter('get_the_excerpt', 'wp_trim_words');
add_filter('get_the_excerpt', 'oakwood_trim_words');
}
// Replace Reverie Trim Words
function oakwood_trim_words( $text, $num_words = 55, $more = null ) {
if ( null === $more )
$more = __( '…' );
$original_text = $text;
$text = strip_tags($text, '<strong>',);
/* translators: If your word count is based on single characters (East Asian characters),
enter 'characters'. Otherwise, enter 'words'. Do not translate into your own language. */
if ( 'characters' == _x( 'words', 'word count: words or characters?' ) && preg_match( '/^utf\-?8$/i', get_option( 'blog_charset' ) ) ) {
$text = trim( preg_replace( "/[\n\r\t ]+/", ' ', $text ), ' ' );
preg_match_all( '/./u', $text, $words_array );
$words_array = array_slice( $words_array[0], 0, $num_words + 1 );
$sep = '';
} else {
$words_array = preg_split( "/[\n\r\t ]+/", $text, $num_words + 1, PREG_SPLIT_NO_EMPTY );
$sep = ' ';
}
if ( count( $words_array ) > $num_words ) {
array_pop( $words_array );
$text = implode( $sep, $words_array );
$text = $text . $more;
} else {
$text = implode( $sep, $words_array );
}
/**
* Filter the text content after words have been trimmed.
*
* @since 3.3.0
*
* @param string $text The trimmed text.
* @param int $num_words The number of words to trim the text to. Default 5.
* @param string $more An optional string to append to the end of the trimmed text, e.g. ….
* @param string $original_text The text before it was trimmed.
*/
return apply_filters( 'oakwood_trim_words', $text, $num_words, $more, $original_text );
}
解决方法:
EXECERPTS完整指南
我最近回答了一些关于摘录的问题,所以我将尽可能详细地解释.
HTML标签/格式
the_excerpt()首先不会有任何参数,所以没有任何东西可以传递给它.事实上,the_excerpt()将内容修剪为55个单词,并且在返回文本之前删除所有html标记. the_excerpt()位于wp-includes/post-template.php.要在摘录中允许某些或所有html标记,必须创建一个新的摘录.
首先,需要首先删除原始函数,然后需要将新函数挂钩到get_the_excerpt.请注意,这个新的摘录仍然可以作为模板文件中的__cercer()调用,无需更改. 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()允许的标记.有关有效HTML5标记的完整列表,请查看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标签时,这些标签会被计为单词,因此带有标签和没有标签的摘录的单词计数将不相同.要更正这一点,您需要先从实际字数中删除这些标记,以便只计算字数.
我写了一个摘录,允许所有标签,只计算单词作为单词,并在设定数量的单词后完成一个句子(不会修剪文本中间句子)并在最后一个单词后添加更多的文本.
这是完整的代码
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) {
global $post;
$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_word_count && 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="'. esc_url( get_permalink() ) . '">' . ' » ' . 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_end; /*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="'. esc_url( get_permalink() ) . '">' . ' …' . __( 'Read more »', 'wpse' ) . '</a>');
}
这个小函数做的是将get_the_excerpt修剪为用户设置的$limit,并在结尾处返回带有read more链接的文本.
您可以在模板中将此摘录称为以下内容
echo wpse_custom_excerpts($limit);
$limit将是你的字数,因此30字的摘录将是
echo wpse_custom_excerpts(30);
这里要记住的一件事是,如果你将限制设置为超过55个单词,则只返回55个单词,因为摘录长度只有55个单词.如果需要更长的摘录,请改用get_the_content.
定制加速度
如果只需要更改__cercer()的长度,可以使用以下函数
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="'. get_permalink( get_the_ID() ) . '">' . __('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="'. esc_url( get_permalink() ) . '">' . ' » ' . 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');