Тег шаблона: the_excerpt

27.02.2010
Описание

Выводит анонс текущей записи с символами '[...]' в конце, означающими, что текст записи был обрезан. Если в записи была указана 'Цитата', то анонс записи будет взят из нее, а если нет, то в качестве анонса будут взяты первые 55 слов из записи. В анонсе автоматически вырезаются все картинки и все HTML теги. Тег должен работать в пределах цикла вывода записей The Loop.

Внимание: если текущим постом является вложение (attachment.php и image.php), то в качестве анонса будет показано описание вложения, причем символы '[...]' не будут добавлены к такому анонсу.

Использование
<?php the_excerpt(); ?>
Параметры

В функции нет никаких параметров.

Примеры

1. По умолчанию

<?php the_excerpt(); ?>

Будет показан анонс текущей записи.

2. Использование с условными тегами

<?php if ( is_category() || is_archive() ) {
	the_excerpt();
} else {
	the_content('Читать дальше...');
} ?>

Данный код выведет анонсы записей на страницах рубрик или архивов и полный текст записи (до тега-разделителя <!--more-->, если он был использован) на других страницах (например, на главной странице блога).

3. Изменение длины анонса с помощью фильтра

function new_excerpt_length($length) {
	return 20; }
add_filter('excerpt_length', 'new_excerpt_length');

Данный код, добавленный в файл functions.php шаблона уменьшит длину анонса с 55 слов до 20 слов.

4. Удаление символов '[...]' в конце анонса с помощью фильтра

function new_excerpt_more($excerpt) {
	return str_replace('[...]', '...', $excerpt); }
add_filter('wp_trim_excerpt', 'new_excerpt_more');

Данный код, добавленный в файл functions.php заменит символы '[...]' в конце анонса на символы '...'.

function new_excerpt_more($post) {
	return ' <a href="'. get_permalink($post->ID) . '">'
	. 'читать дальше...' . '</a>'; }
add_filter('excerpt_more', 'new_excerpt_more');

А этот код не только заменит символы '[...]' в конце анонса на текст 'читать дальше...', но и сделает этот текст ссылкой на полную запись.

Внимание! При заполненном поле 'Цитата' в записи никакие фильтры не будут работать - в качестве анонса записи будет выведена 'Цитата' в том виде, как она была заполнена.

Лог изменений

Функция добавлена в версии 0.71

Исходный файл

Функция the_excerpt() находится в wp-includes/post-template.php

Связанные теги|функции
Рубрики: Теги шаблоновФункции WordPressУсловные теги

Понравился пост? Подпишись на обновления по Обновления блога по RSSRSS или Обновления блога на TwitterTwitter !

Комментарии (всего 58 комментариев)
Написать комментарий

(обязательно)

(обязательно, не публикуется)

Для вставки кода используйте кнопку "Код", по умолчанию используется синтаксис подсветки языка "php", вы можете поменять его на любой другой поддерживаемый GeSHi язык, например "javascript", "css", "html4strict", "sql" и тд. Используйте предпросмотр!
 


Подписаться на уведомления без комментирования.