• Главная
• Карта сайта
• О сайте
• Ссылки

Описание

Выводит анонс текущей записи с символами '[...]' в конце, означающими, что текст записи был обрезан. Если в записи была указана 'Цитата', то анонс записи будет взят из нее, а если нет, то в качестве анонса будут взяты первые 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

Связанные теги\функции

the_ID, the_title, the_title_rss, the_title_attribute, single_post_title, the_content, the_content_feed, the_excerpt, the_excerpt_rss, [[wp_link_pages]], posts_nav_link, next_post_link, next_posts_link, previous_post_link, previous_posts_link, next_image_link, previous_image_link, sticky_class, the_category, the_category_rss, the_tags, the_meta

Комментарии

Комментариев пока еще нет.

Написать комментарий