get_the_content()
Отримує вміст поточного запису (поста). Використовується всередині циклу WordPress.
Коли функція використовується на сторінках архівів (не окрема сторінка запису) і якщо в контенті використовується тег-розділювач <!--more-->
, то ця функція виведе не весь контент, а лише текст до тега <!--more-->
з наступним посиланням “читати далі” (текст посилання можна змінити через $more_link_text ).
Чи не фільтрує контент, як це робить the_content , використовуйте конструкцію:
$content = apply_filters( 'the_content', get_the_content() );
(дуже повільно) | 50000 разів – 3.32 сек
(швидко) |
PHP 7.2.5, WP 4.9.6
Хуки з функції
-
$more_link_text
(рядок) -
Текст посилання для місця урвища статті (читати далі).
Типово: null -
$strip_teaser
(логічний) Під словом teaser розуміється текст, що приваблює, до тега more. strip_teaser – означає видалити цей текст. Тобто, якщо встановити параметр у true, то контент до тега <!–more–> на is_single() сторінці буде видалено.
За замовчуванням параметр вимкнено. Його також можна увімкнути, вказавши в будь-якому місці тексту запису
<!--noteaser-->
(прийнято вказувати відразу після тега <!–more–> ).
Типово: null-
$post
(WP_Post/Об’єкт/число) (з версії 5.2) -
Запис (пост), контент якого потрібно отримати.
Типово: null
Приклади
#1 Отримаємо контент посту
Майте на увазі, що ця функція не повертає те саме, що відображає the_content() :
$content = apply_filters( 'the_content', get_the_content() ); echo $content;
#2 Виведемо контент посту, тільки якщо він не порожній
$the_content = apply_filters( 'the_content', get_the_content() ); if ( ! empty( $the_content ) ) { echo $the_content; }
Для окремого поста з ID 12:
$post = get_post(12); // specific post $the_content = apply_filters( 'the_content', $post->post_content ); if ( ! empty( $the_content ) ) { echo $the_content; }
нотатки
- Global. int. $page Page number of a single post/page.
- Global. int. $more Boolean indicador для будь-якого одного post/page is being viewed.
- Global. true | false. $preview Whether post/page is in preview mode.
- Global. Масив. $pages Array of all pages in post/page. Котрий array елемент містить частину вмісту , що відокремлюється від <!–nextpage–> tag.
- Global. int. $multipage Boolean indicator для яких багаторазових сторінок є в play.
список змін
З версії 0.71 | Введено. |
З версії 5.2.0 | Added $post parameter. |