Плагин для WordPress: the_excerpt Reloaded — умные анонсы the_excerpt

Сайт плагина: the_excerpt Reloaded

О терминах: цитата = анонс = excerpt

Для чего этот плагин может понадобится:
Например, на главной странице блога выводятся посты, «обрезанные» до тега <!--more-->, а в категориях мы хотим выводить краткие анонсы. Для этого в шаблоне category.php (или archive.php) обычно заменяют <?php the_content('Далее…'); ?> на <?php the_excerpt(); ?>. Про шаблоны Тем WordPress.

UPD 21.03.2009

• нашелся плагин No Excerpt P Plugin, который убирает <p> вокруг the_excerpt
http://benpartch.org/downloads/no-excerpt-p-plugin/
• а также см. этот топик (анг. яз.) http://wordpress.org/support/topic/201948

WordPress автоматически создает анонсы длиной 120 слов, обрезая их в произвольном месте, к примеру, посередине предложения. При этом форматирование не сохраняется: только текст без ссылок и картинок. Если при создании или редактировании записи заполнить поле «цитата (опционально)», то WordPress будет выводить этот текст — кстати, удобный способ создать краткое резюме записи. При ручном заполнении этого поля теги могут сохраниться, вернее, вам прийдется их вставить самостоятельно:

<p><strong>Комбайнеры</strong> выполнили и перевыполнили план 5-й пятилетки</p>

Скажем, если нас не устраивает длина анонса в 120 слов, то чтобы это изменить, нужно залезть в код движка и править там. Не очень удобный способ, особенно если вы любите обновлять WordPress (можно и забыть, что и где вы там правили). К тому же WordPress заключает всю цитату в тег <p> — такое маленькое самоуправство :)

Плагин the_excerpt Reloaded автоматически создает цитаты нужной длины и настраивается по вкусу легким движением руки. Гибкая настройка этого плагина позволяет в любой момент изменить количество выводимых букв, а также «сохраняет» в цитатах теги, например <img>, <a>, вставлять ссылку «Читать далее» и т.п.

Просто активируйте плагин и замените <?php the_excerpt (); ?> на <?php the_excerpt_reloaded(); ?> в нужном шаблоне вашей Темы.

В функции <?php the_excerpt_reloaded(); ?> возможны несколько аргументов.

Мой перевод по использованию плагина the_excerpt Reloaded

Некоторые фразы я оставила на английском, чтобы не потерять при переводе нюансы, которые я не поняла до конца.

шспользование:

<?php the_excerpt_reloaded(excerpt_length, 'allowedtags', 'filter_type', use_more_link, 'more_link_text', force_more_link, fakeit, fix_tags); ?>

Параметры:

excerpt_length

(integer) Количество выводимых слов, по умолчанию 120.

allowedtags

(string) Определяет, какие HTML теги «сохранить» в анонсах. Пример: '<img>' или '<a><img>'. По умолчанию «сохраняется» только тег '<a>'.

filter_type

(string) Defines how WordPress should filter/format an excerpt’s content. Options are based on content/excerpt tags: 'content', 'content_rss', 'excerpt', 'excerpt_rss'. Set to 'none' to display raw content. Default is 'excerpt'.

use_more_link

(boolean) шспользовать ссылку «Далее» (TRUE) или нет (FALSE). Если этот параметр установить в false, то в месте обрезания цитаты будет многоточие (…). По умолчанию — TRUE.

more_link_text

(string) Если параметр use_more_link установлен в TRUE, можно определить анкор ссылки, по умолчанию — '(more...)'.

force_more_link

(boolean) Выводить ссылку «Далле» (TRUE) или нет (FALSE), даже когда анонс меньше, чем заданная длина excerpt_length. По умолчанию — FALSE.

fakeit

(integer) Если в посте заполнено поле поле «цитата (опционально)», то выводить это содержимое в качестве анонса (1) или обрезать функцией the_excerpt_reloaded (0). Можете установить этот параметр в 2 (строгое условие использовать заполненное поле «цитата (опционально)»). По умолчанию 1.

fix_tags

(boolean) “Repair” HTML tag elements (TRUE) or don’t (FALSE). This is implemented to deal with improperly closed tags which may be caused by excerpt_length. If fix_tags is set to FALSE, the plugin will not attempt XHTML validation and repair on improperly closed tags (due to excerpt_length breaking them in mid-element). Defaults to TRUE.

Примеры:

<?php the_excerpt_reloaded(); ?>

Выводит параметры по умолчанию: 120 первых слов; сохранять тег (<a>); ш?excerpt’ as filter type, использовать "(more…)" как ссылку на продолжение поста if excerpt less than content; fake content as excerpt unless post has an excerpt.

<php the_excerpt_reloaded(25, '<img>', 'content_rss', FALSE); ?>

Выводит: 25 первых слов; сохраняет тег (<img>); ш?content_rss’ as filter type; не использовать ссылку (more…); fake content as excerpt.

<?php the_excerpt_reloaded(50, '', 'none', TRUE, 'Keep reading >>', FALSE, 2); ?>

Выводит: 50 первых слов; все теги вырезаются; raw content output; ссылка на полный текст поста — “Keep reading >>” as more link if excerpt less than content; даже если поле «цитата (опционально)» заполнена, обрезать анонсы функцией.

Дополнительная информация:

Впишите класс .more-link в свой style.css для ссылки (more…), пример:

.more-link {
font-style: italic;
text-align: right;
}

UPD 2 июня 2007:
Только что случайно заметила, что если запись принадлежит нескольким рубрикам одновременно, то плагин the_excerpt Reloaded «теряется» и выводит вместо анонса троеточие. Оказалось, дело не в плагине, в этой записи в самом начале было много картинок и анонс вывелся троеточием, поскольку WordPress просто букв не нашел :)