wp_trim_excerpt() — создает анонс записи

Возвращает анонс записи в виде содержимого поста, обрезанного до 55 символов (длину можно изменить через фильтр), тег <!--more--> в данном случае проигнорируется.

wp_trim_excerpt($text = '')
$text
(строка) текст, который вы хотите использовать в качестве анонса, по умолчанию будет использоваться часть содержимого поста. Текст, переданный через эту переменную, обрезаться не будет.

Примеры

В этом примере функция выведет несколько первых предложений из содержимого поста и ссылку на сам пост:

echo wp_trim_excerpt();

Если мы используем следующий код, то содержимое записи будет выведено полностью, как есть:

echo wp_trim_excerpt( get_the_content() );

Фильтр excerpt_length

Появился в версии WordPress 2.8. Этот фильтр позволяет корректировать длину анонса.

$excerpt_length = apply_filters('excerpt_length', 55);

Давайте попробуем увеличить длину анонса до 75, для этого вставим следующий код в functions.php вашей текущей темы:

function true_excerpt_length( $length ){
	return 75;
}
 
add_filter( 'excerpt_length', 'true_excerpt_length', 10, 1);

Фильтр excerpt_more

Появился в версии WordPress 2.9.
По умолчанию, там где заканчивается анонс, добавляется символ многоточия, вы можете его заменить, используя этот фильтр.

$excerpt_more = apply_filters('excerpt_more', ' ' . '[…]');

Пример:

function true_excerpt_more( $more ){
	return str_replace('…', '[...]', $more);
}
 
add_filter( 'excerpt_more', 'true_excerpt_more', 10, 1);

Миша

В последние годы я долго не знал, что мне делать с сайтом misha.blog, ведь он практически не приносит никакого профита, но недавно я осознал, что моя миссия – способствовать распространению WordPress. Ведь WordPress – это лучший движок для разработки сайтов – как для тех, кто готов использовать заложенную структуру этой CMS, так и для тех, кто предпочитает headless решения.

Сам же я впервые познакомился с WordPress в 2009 году. Организатор WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с вашим сайтом или может даже разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда сделаем вам всё на лучшем уровне.

Комментарии — 5

Комментирование этого поста более не доступно.
  • Сергей 3 декабря 2013 #

    В чем разница the excerpt()

    • Миша 3 декабря 2013 #

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

  • Артем 27 октября 2014 #

    Мишь, а как можно обрезать часть цитаты у Сusom Pos Type? Допустим:

    function custom_excerpt_length($length) {
    		global $post;
    		if ($post->post_type == 'kraski');
    	    return 6;
    	  }
    	add_filter('excerpt_length', 'custom_excerpt_length');

    Почему то не работает 🙁 а, через

    wp_trim_words

    — как-то не кошерно.

    • Миша 27 октября 2014 #

      Ну wp_trim_excerpt() как раз и работает на основе wp_trim_words() 🙂

      • Артем 28 октября 2014 #

        O_o , это все меняет. Спасибо за ответ.