php - 如何防止 Wordpress 在摘录中剥离 HTML 标签

Question

我正在使用 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. &hellip;.
     * @param string $original_text The text before it was trimmed.
     */
    return apply_filters( 'oakwood_trim_words', $text, $num_words, $more, $original_text );
}

Answer 1

完整的摘录指南

我最近回答了几个关于摘录的问题，所以我将尽可能详细地解释一下。

HTML 标签/格式

the_excerpt() 首先除了任何参数都没有，所以什么都不能传递给它。事实是the_excerpt()将内容修剪为 55 个字，并在返回文本之前剥离所有 html 标签。 the_excerpt()位于wp-includes/post-template.php .要允许摘录中的某些或所有 html 标记，必须创建新的摘录。

首先需要先把原来的函数去掉，然后新的函数需要hook到 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()将会允许。如需有效 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(']]>', ']]&gt;', $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() ) . '">' . '&nbsp;&raquo;&nbsp;' . sprintf(__( 'Read more about: %s &nbsp;&raquo;', '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() ) . '">' . '&nbsp;&hellip;' . __( 'Read more &nbsp;&raquo;', '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 的优先级，以便您的自定义函数在默认值之后执行。

添加阅读更多链接

摘录返回的所有文本都带有讨厌的 [...]最后是不可点击的。要在 helips 的位置添加阅读更多文本，请使用此功能

 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(']]>', ']]&gt;', $wpse0001_excerpt);

$excerpt_end = ' <a href="'. esc_url( get_permalink() ) . '">' . '&nbsp;&raquo;&nbsp;' . sprintf(__( 'Read more about: %s &nbsp;&raquo;', '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');