the_content()

Выводит контент поста (записи, страницы).

 

Так называемый тег шаблона, как правило используется внутри цикла WordPress, а также на страницах ,записях (например, в файлах page.php, single.php и пр.), перед вызовом функции the_post().

 

В отличие от get_the_content, например, хуки the_content используются для фильтрации контента записи (важно понимать: после того как контент получен из Базы Данных, но ! до того как выведен на экран!).

 

Подробнее о функции:

 

 

 

 

 

 

 

 

 

 

 

Описание функции the_content()

 

 

 

 

Если используем функцию на страницах архивов (не страница записи) и при этом в контенте статьи применяем тег <!–more–>, в этом случае функция выведет текст только до тега <!–more–>. После тега морэ как правило выводится ссылка “читать далее…” (параметр $more_link_text меняет текст ссылки).

 

 

Основой функции the_content() можно считать: get_the_content() /ссылка на описание выше/.

 

 

 

Возвратит Null. – отформатированный контент записи.

 

 

 

Использование функции:

 

 

 

<?php the_content( $more_link_text, $strip_teaser ); ?>

 

 

 

$more_link_text (строка).

 

Текст ссылки читать дальее…

 

 

$strip_teaser (логический).

 

Текст до тега <!--more-->. strip_teaser – можно изменить/удалить текст.

 

По умолчанию: false

 

 

Иногда используют параметр true, В этом случае весь контент расположенный до тега <!--more--> – is_single() – будет полностью удален (некоторые подобным образом избавляются от дулей контента).

 

 

Другой пример удалить контент до тега more: добавляем такой тег <!–noteaser–>. Как правило логичнее всего добавлять сразу после тега <!--more-->.

 

 

 

примеры работы с функцией:

 

 

 

<?php the_content( 'Перейти к полному тексту статьи' ); ?>

 

 

 

 

Добавим к ссылке “читать дальше…” заголовок статьи:

 

 

 

Если нам нужно к тексту Читать далее добавить заголовок статьи, то поможет соответственный тег шаблона the_title().

 

 

 

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

 

 

 

итог:

 

Читать далее: такую-то полезную статью

 

 

 

 

как альтернатива использования

 

 

 

Если нам требуется получить и обработать текстовый контент (однако, не выводить на экран), как и говорилось выше, нам в помощь функция get_the_content(): /описание по ссылке выше/.

 

 

$mycontent = get_the_content();

 

 

чтоб отфильтровать контент, поступаем примерно так:

 

 

 

$mycontent = apply_filters( 'the_content', $mycontent );

$mycontent = str_replace( '...действие и т.д. ', $mycontent);

 

 

 

ещё пример фильтра функции:

 

 

 

Когда, например, организуем на сайте микроразметку Schema.org, то работаем, как и говорилось выше, с фильтром the_content:

 

 

 

add_filter('the_content', 'replace_mihalica_recipe');
function replace_mihalica_recipe($recipe) {
$replace = array(
'<li'=> '<li itemprop="recipeIngredient"',
); //
if (in_category(array('2','3','5','6','7','8','9','75'))) { //
$recipe = str_replace(array_keys($replace), $replace, $recipe); //производим замену
}
return $recipe; //возвращаем значение функции
}

 

 

 

Добавляем в маркированный <li itemprop="recipeIngredient" список атрибуты микроразметки.