Разрешить HTML в выдержке

ПОЛНОЕ РУКОВОДСТВО ПО ЭКСПЕРТАМ

Я недавно ответил на несколько вопросов относительно выдержек, поэтому я собираюсь дать подробное объяснение, охватывающее как можно больше.

ПРЕДИСЛОВИЕ

Похоже, из этого ответа возникла пара вопросов о том, куда должен идти код, и ответ таков: это действительно ваше дело и то, как вы считаете нужным. Существует несколько вариантов размещения кода (если это не указано явно):

В вашей теме 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');

РЕДАКТИРОВАТЬ 29-10-2015

Для тех, кому нужен обходной путь, чтобы не отображать ссылку «читать дальше» после выдержки, когда выдержка короче установленного количества слов, см. Следующий вопрос и ответ

Подробнее тег отображается на каждом посту

Питер Гусен
источник

где именно я

function wpse_allowedtags() { // Add custom tags to this string     return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>,<p>,<img>,<video>,<audio>';  }

помещаю

Весь этот код входит в functions.php. Вы можете добавить это чуть выше if ( ! function_exists( 'wpse_custom_wp_trim_excerpt' ) ) :в своемfunctions.php

Питер Гусен

Я пропустил верхнюю часть кода

user32447

если это входит в файл functions.php, не будет ли он перезаписан при обновлении?

Макгрэйм

@mcgrailm да, будет. Вот почему важно добавить это в functions.php ваших дочерних тем . Вы даже можете добавить его в обязательный для использования плагин

Pieter Goosen,

Разрешить HTML в выдержке

Ответы:

РЕДАКТИРОВАТЬ 29-10-2015