Плагин для WordPress the_excerpt Reloaded — умные анонсы
[ ←Вернуться к стандартному виду ]
Плагин для 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 просто букв не нашел :)
[…] повторять ее статью, а просто отправлю вас к ней – читайте если надо. Здесь я скажу только несколько слов. […]