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

Posted 2023-02-24

【中文标题】如何防止 Wordpress 在摘录中剥离 HTML 标签

【英文标题】：How to Prevent Wordpress from Stripping HTML Tags in Excerpt

【发布时间】：2014-07-31 19:35:29

【问题描述】：

我正在使用 wp_trim_words 来修剪我主页上的一些摘录。它工作正常，只是它从摘录中剥离了 html 标记。我需要能够将摘录的某些部分加粗（使用<strong>）。按照说明 here，我尝试删除 wp_trim_words 函数并使用以下代码将其替换为新函数，该代码将原始 WP 函数中的 $text = wp_strip_all_tags( $text ); 替换为 $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 );

【问题讨论】：

网站是如何崩溃的？

@PhoenixWing156 它只是显示一个完全空白的白页。完全没有内容。

【参考方案1】：

摘录完整指南

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

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() 允许的标签。有关有效 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，以便您的自定义函数在默认值之后执行。

添加阅读链接

摘录返回的所有文本的末尾都带有讨厌的[...]，无法点击。要在 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(']]>', ']]&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');

【讨论】：

非常感谢！我正在使用您提供的第一段代码，它运行良好。我非常感谢您花时间解释所有这些。你是最棒的！

如果我只想允许html标签，我是在functions.php中挂钩函数，还是应该改变post-template.php和formatting.php？

@AlanKis 是的，除非另有说明，否则所有这些代码都进入 functions.php :-)

对不起，但它对我不起作用我将它添加到 wp-includes/formatting.php 中的代码我只想显示我在帖子的 EXCERPT 字段中添加的链接，但总是清理一个 html元素

从 WordPress 5.0 开始，您应该在最新完整代码的第 9 行的 $wpse_excerpt = strip_shortcodes( $wpse_excerpt ); 之后添加 $wpse_excerpt = excerpt_remove_blocks( $wpse_excerpt );。除了短代码之外，这还将从内容中删除块以进行处理。

【参考方案2】：

您不能允许在摘录中设置 html 格式，就好像在标签关闭之前剪切的文本会在页面的其余部分创建不需要的格式一样。考虑从第 20 个字符到第 1000 个字符应用粗体。如果使用格式，它将应用开始的粗体标记，但不会应用结尾，因为文本限制仅限于第 55 个字符。

【参考方案3】：

尝试将此添加到您的functions.php

add_filter( 'get_the_content_limit_allowedtags',
    'get_the_content_limit_custom_allowedtags' ); 
    function get_the_content_limit_custom_allowedtags() 
    // Add custom tags to this string
    return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>';