next_posts_link

Описание

Выводит ссылку на страницу с предыдущими записями (из-за того, что записи в блоге выводятся в обратном хронологическом порядке страница 'следующих' (по времени) записей становится именно страницей 'предыдущих' записей).

Читать дальше..

the_excerpt_rss

Описание

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

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

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

Примеры

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

<description><?php the_excerpt_rss(); ?></description>

Данный код выведет отформатированный для использования в RSS анонс текущей записи в тегах <description> и </description>.

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

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

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

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

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

the_excerpt

Описание

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

Описание

Функция заменила устаревший тег the_content_rss(). Выводит текст текущей записи, отформатированный для использования в RSS лентах. Функция должна использоваться в цикле вывода записей The Loop.

Читать дальше..

the_content

Описание

Выводит содержимое текущего поста (запись или страница). Этот тег должен работать в пределах цикла The Loop. При использовании тега <!--more--> в содержимом поста весь его дальнейший текст игнорируется и не выводится. Тег <!--more--> не будет работать на страницах одиночного поста (как правило, это single.php и page.php).

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

$more_link_text

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

По умолчанию: '(more...)' (в русской локализации '(далее…)').

$strip_teaser

(boolean) (необязательный) - указывает должен ли скрываться текст до тега-разделителя <!--more--> (true) или нет (false) на страницах одиночного поста.

  • true
  • false - по умолчанию
Примеры

1. Анкор ссылки на просмотр полной записи

<?php the_content('Читать дальше..'); ?>

Будет выведена ссылка на просмотр полной записи с анкором 'Читать дальше..'.

2. Включение заголовка поста в текст анкора ссылки

<?php the_content('Читать дальше запись ' . the_title('"', '"', false)); ?>

Анкором ссылки на просмотр полной записи в данном случае будут слова 'Читать дальше запись ' и заголовок этой записи, взятой в кавычки (символы &quot;).

3. Использование глобальной переменной $more

<?php 
global $more;                       // объявление до цикла вывода записей.
$more = 1;                          // установка переменной в цикле.
the_content('Читать дальше...');    // запись будет выведена полностью,
                                    // игнорируя тег <!--more-->
<?php 
global $more;                       // объявление до цикла вывода записей.
$more = 0;                          // установка переменной в цикле.
the_content('Читать дальше...');    // запись будет выведена до <!--more-->
?>

Глобальная переменная $more указывает тегу the_content учитывать или нет в записи тег-разделитель <!--more-->. Объявлять переменную $more необходимо до цикла вывода записей, а присваивать ей значение в цикле.

4. Использование функции [[get_the_content]]

<?php 
$content = get_the_content('Читать дальше...'); 
$content = apply_filters('the_content', $content);
$content = str_replace('Привет', 'Hello', $content);
echo $content;
?>

Функция [[get_the_content]] позволяет получить содержимое записи в переменную PHP. Но, в отличие от результата работы тега the_content текст записи не будет автоматически обработан фильтром the_content, а следовательно это надо сделать вручную. Данный код получает содержимое записи в переменную $content, обрабатывает эту переменную фильтром the_content, заменяет в ней слова 'Привет' на 'Hello', а затем выводит ее.

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

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

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

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

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