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

时间:2014-06-10 21:29:04

标签: php wordpress function filter strip

我正在使用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 = __( '&hellip;' );
    $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 );
}

3 个答案:

答案 0 :(得分:27)

EXECERPTS完整指南

我最近回答了一些关于节选的问题,所以我&#39;我将尽可能详细地解释。

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_excerptwp_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'); 

您只需删除&#39; //&#39;来自你需要额外的功能。

CUSTOM EXCERPT LENGTHS

有时您需要显示不同长度的简单摘录,并且为每个帖子/功能/页面编写摘录是不可行的。这是一个使用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

CUSTOM EXCERPT LENGTH

如果您只需要更改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标签的功能,添加了一个&#34; Read More&#34;链接在摘录的末尾,并修改第一段之后的摘录。

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');

答案 1 :(得分:0)

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

答案 2 :(得分:-1)

尝试将此添加到您的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>'; 
}