允许摘录中的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标签的完整列表，请在此处进行检查。这是功能，向其中添加您需要允许/保留的所有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) {
    $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="'. 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_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="'. 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_more;

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

编辑2015年10月29日

对于需要解决方法的人，如果摘录短于设置的字数，则摘录后不显示“更多阅读”链接，请参见以下问答

• 阅读更多标签显示在每个帖子上

如果需要，添加更多标签 $allowed_tags = ...

function _20170529_excerpt($text) {
$raw_excerpt = $text;
if ( '' == $text ) {
    //Retrieve the post content. 
    $text = get_the_content('');

    //Delete all shortcode tags from the content. 
    $text = strip_shortcodes( $text );

    $text = apply_filters('the_content', $text);
    $text = str_replace(']]>', ']]>', $text);

    $allowed_tags = '<a>,<b>,<br><i>'; 
    $text = strip_tags($text, $allowed_tags);

    $excerpt_word_count = 55; /*** MODIFY THIS. change the excerpt word count to any integer you like.***/
    $excerpt_length = apply_filters('excerpt_length', $excerpt_word_count); 

    $excerpt_end = '[...]'; /*** MODIFY THIS. change the excerpt endind to something else.***/
    $excerpt_more = apply_filters('excerpt_more', ' ' . $excerpt_end);

    $words = preg_split("/[\n\r\t ]+/", $text, $excerpt_length + 1, PREG_SPLIT_NO_EMPTY);
    if ( count($words) > $excerpt_length ) {
        array_pop($words);
        $text = implode(' ', $words);
        $text = $text . $excerpt_more;
    } else {
        $text = implode(' ', $words);
    }
}
return apply_filters('wp_trim_excerpt', $text, $raw_excerpt);
}

来自：http : //bacsoftwareconsulting.com/blog/index.php/wordpress-cat/how-to-preserve-html-tags-in-wordpress-excerpt-without-a-plugin/

您还可以为摘录添加富文本编辑器，在插件文件或主题的function.php文件中添加以下代码，您将能够看到摘录的HTML编辑器。此外，它还将以HTML格式呈现摘录。＃干杯

我已经从某个地方复制了此文件，但不记得源了。我在所有项目中都使用了它，并且它正在工作。

/**
  * Replaces the default excerpt editor with TinyMCE.
*/
add_action( 'add_meta_boxes', array ( 'T5_Richtext_Excerpt', 'switch_boxes' ) );
class T5_Richtext_Excerpt
{
    /**
     * Replaces the meta boxes.
     *
     * @return void
     */
    public static function switch_boxes()
    {
        if ( ! post_type_supports( $GLOBALS['post']->post_type, 'excerpt' ) )
        {
            return;
        }

        remove_meta_box(
            'postexcerpt', // ID
            '',            // Screen, empty to support all post types
            'normal'      // Context
        );

        add_meta_box(
            'postexcerpt2',     // Reusing just 'postexcerpt' doesn't work.
            __( 'Excerpt' ),    // Title
            array ( __CLASS__, 'show' ), // Display function
            null,              // Screen, we use all screens with meta boxes.
            'normal',          // Context
            'core',            // Priority
        );
    }

    /**
     * Output for the meta box.
     *
     * @param  object $post
     * @return void
     */
    public static function show( $post )
    {
        ?>
        <label class="screen-reader-text" for="excerpt"><?php
        _e( 'Excerpt' )
        ?></label>
        <?php
            // We use the default name, 'excerpt', so we don’t have to care about
            // saving, other filters etc.
            wp_editor(
                self::unescape( $post->post_excerpt ),
                'excerpt',
                array (
                    'textarea_rows' => 15,
                    'media_buttons' => FALSE,
                    'teeny'         => TRUE,
                    'tinymce'       => TRUE
                )
            );
    }

    /**
     * The excerpt is escaped usually. This breaks the HTML editor.
     *
     * @param  string $str
     * @return string
     */
    public static function unescape( $str )
    {
        return str_replace(
            array ( '&lt;', '&gt;', '&quot;', '&amp;', '&nbsp;', '&amp;nbsp;' ),
                array ( '<',    '>',    '"',      '&',     ' ', ' ' ),
                $str
        );
    }
}