允许HTML摘要 - 薇晓朵文档中心

问题描述

这是我的摘录代码。

// 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(']]>', ']]&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_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'">' . '&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_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'">' . '&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="'.%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(']]>', ']]&gt;', $wpse0001_excerpt);

            $excerpt_end = ' <a href="'.%20esc_url(%20get_permalink()%20)%20.%20'">' . '&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');