Как добавить переносы строк в the_excerpt?

Аналогично решению Johannes Pille, представленное ниже решение должно быть более адаптивным.

Подробности:

• переопределение функции wp_trim_excerpt
• удаление старого фильтра и добавление нового пользовательского фильтра

Полный код:

// добавить в themes/{ваша_тема}/functions.php

define('EXCERPT_RARELY', '{[}]');
define('EXCERPT_BR', nl2br(PHP_EOL));

function so306588_trim_excerpt_custom($text = '')
{
    add_filter('the_content', 'so306588_trim_excerpt_custom_mark', 6);

    // пропустить через оригинальный фильтр
    $text = wp_trim_excerpt($text);

    remove_filter('the_content', 'so306588_trim_excerpt_custom_mark', 6);

    return so306588_trim_excerpt_custom_restore($text);
}

function so306588_trim_excerpt_custom_mark($text)
{
    $text = nl2br($text);
    return str_replace(EXCERPT_BR, EXCERPT_RARELY, $text);
}

function so306588_trim_excerpt_custom_restore($text)
{
    return str_replace(EXCERPT_RARELY, EXCERPT_BR, $text);
}

// удалить стандартный фильтр
remove_filter('get_the_excerpt', 'wp_trim_excerpt');

// добавить пользовательский фильтр
add_filter('get_the_excerpt', 'so306588_trim_excerpt_custom');

В WordPress нет фильтра, который позволял бы задавать разрешённые теги, чтобы они не удалялись функцией the_excerpt(). Можно считать это недоработкой ядра.

В любом случае, фактическое формирование цитат происходит не в этом шаблонном теге, а совсем в другом месте:

Цитаты генерируются функцией wp_trim_excerpt(), внутри которой применяются уже используемые вами фильтры цитат (excerpt_length и excerpt_more), и которая вызывает wp_trim_words(), а та, в свою очередь, обращается к wp_strip_all_tags(). Все три функции находятся в файле wp-includes/formatting.php.

Таким образом, в отсутствие фильтра для данного случая и неизбежности прохождения вашей цитаты через wp_strip_all_tags(), единственная возможность сохранить некоторые теги — это добавить пользовательскую функцию-заменитель для wp_trim_excerpt():

function wpse67498_wp_trim_excerpt( $text = '' ) {
    $raw_excerpt = $text;

    if ( '' == $text ) {
        $text = get_the_content( '' );
        $text = strip_shortcodes( $text );
        $text = apply_filters( 'the_content', $text );
        $text = str_replace( ']]>', ']]>', $text );
        $excerpt_length = apply_filters( 'excerpt_length', 55 );
        $excerpt_more = apply_filters( 'excerpt_more', ' ' . '[...]' );

        $allowable = '<br>';
        $text = preg_replace( '@<(script|style)[^>]*?>.*?</\\1>@si', '', $text );
        $text = trim( strip_tags( $text, $allowable ) );

        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 ) > $excerpt_length ) {
            array_pop( $words_array );
            $text = implode( $sep, $words_array );
            $text = $text . $excerpt_more;
        } else {
            $text = implode( $sep, $words_array );
        }
    }

    return apply_filters( 'wp_trim_excerpt', $text, $raw_excerpt );
}

remove_filter( 'get_the_excerpt', 'wp_trim_excerpt');
add_filter( 'get_the_excerpt', 'wpse67498_wp_trim_excerpt' );

не проще ли применить фильтр the_content к отрывку?

я использую это лишь изредка, прямо в файле шаблона:

$excerpt = apply_filters('the_content',  ( get_post(get_the_ID())->post_excerpt) );
echo $excerpt;

В данный момент можно использовать функцию the_excerpt() для вывода отрывка с переносами строк. Но если вам нужно вернуть результат, а не выводить его напрямую, можно воспользоваться такой функцией:

function get_the_excerpt_theme() {
    $excerpt = get_the_excerpt(); // Получаем отрывок
    $excerpt = apply_filters( 'the_excerpt', $excerpt ); // Применяем фильтры, как в функции the_excerpt()
    return $excerpt; // Возвращаем отрывок
}

Она применяет фильтры к отрывку через apply_filters('the_excerpt', $excerpt ), как в функции WordPress the_excerpt(), но возвращает строку вместо её вывода.

Также, если вам нужно разрешить только переносы строк в отрывке, вы можете добавить $excerpt = strip_tags($excerpt,'<br>') после строки с apply_filters.

Надеюсь, это поможет!

Простое решение — заменить переносы строк до того, как WordPress их обработает. Я использовал произвольно выбранный символ из частной зоны Unicode, так как он вряд ли встретится в контенте, а если и появится, то эта зона предназначена для частного использования, что означает нестандартную обработку.

add_filter('wp_trim_words', function($text, $num_words, $more, $original_text) {
    static $filtering;
    if ( $filtering ) {
        return $text;
    }
    $filtering = true;
    
    // Случайный символ из частной зоны Unicode
    $private_use_char = "\u{101425}";
    
    $text = str_replace( ["\n\r", "\n", "\r"], $private_use_char, $original_text);
    $text = wp_trim_words($text, $num_words, $more);
    $text = str_replace($private_use_char, "\n", $text); // или str_replace($private_use_char, "<br>", $text)
    
    $filtering = false;
    return $text;
}, 10, 4);

Обратите внимание, что это приведёт к появлению символов "\n" в выводе функций the_excerpt() и get_the_excerpt(), поэтому, вероятно, перед использованием в HTML стоит применить wpautop(). Альтернативно можно просто заменить $private_use_char на <br> вместо \n, как указано в комментарии.

также можно использовать функцию nl2br() в PHP:

echo nl2br(get_the_excerpt());

-- или --

nl2br(the_excerpt());