get_the_excerpt() │ WP 0.71

Отримує цитату (уривок) посту. Використовується усередині циклу WP.

Щоб одразу вивести на екран цитату, можна використовувати функцію the_excerpt() , яка до того ж додає параграф HTML ( <p></p>) до цитати.

Текст обрізається функцією wp_trim_excerpt()

Основа для:
the_excerpt_rss() ,
the_excerpt()

Хуки з функції

has_excerpt() .

Якщо вказана «цитата» (уривок), отримає значення поля «цитата».

Для постів захищених паролем, завжди повертає рядок із текстом: “Немає цитати, тому що пост захищений паролем.”.

Використання

$ excerpt = get_the_excerpt ($ post);

$post (число/WP_Post): ID або об’єкт запису, цитату якого потрібно отримати. З версії 4.5.

Типово: null (поточний пост)

Приклади

#1 Висновок цитати з обмеженням символів

Використовуємо функцію get_the_excerpt(), щоб вивести на екран цитату обмежену максимум символів:

the_excerpt_max_charlength(140);

function the_excerpt_max_charlength( $charlength ){
	$excerpt = get_the_excerpt();
	$ Charlength ++;

	if ( mb_strlen ( $ excerpt ) > $ charlength ) {
		$ subex = mb_substr ($ excerpt, 0, $ charlength - 5);
		$exwords = explode('', $subex);
		$excut = - (mb_strlen ($ exwords [count ($ exwords) - 1])));
		if ($ excut < 0) {
			echo mb_substr ($ subex, 0, $ excut);
		} else {
			echo $ subex;
		}
		echo '[...]';
	} else {
		echo $excerpt;
	}
}

Дивіться також нотатку щодо заміни цієї функції на свою: Обрізка тексту та/або заміна стандартної функції the_excerpt()

#2 Приклад перевірки наявності цитати.

Якщо цитата не вказана, виводимо свій текст:

$my_excerpt = get_the_excerpt();
if ($ my_excerpt) {
	echo wpautop($ my_excerpt);
}
else {
	echo wpautop('Цитата не встановлена.');
}

список змін

З версії 0.71	Введено.
З версії 4.5.0	Introduced `$post` parameter.

Код `get_the_excerpt() get the excerpt` ^{WP 6.0.2}

wp-includes/post-template.php

function get_the_excerpt( $post = null ) {
	if ( is_bool( $post ) ) {
		_deprecated_argument( __FUNCTION__, '2.3.0');
	}

	$post = get_post($post);
	if (empty($post)) {
		return '';
	}

	if (post_password_required($post)) {
		return __( 'There is no excerpt because this is a protected post.' );
	}

	/**
	 * Filters retrieved post excerpt.
	 *
	 * @ Since 1.2.0
	 * @since 4.5.0 Introduced the `$post` parameter.
	 *
	 * @param string $post_excerpt The post excerpt.
	 * @param WP_Post $post Post об'єкт.
	 */
	return apply_filters( 'get_the_excerpt', $post->post_excerpt, $post);
}

get_the_excerpt() │ WP 0.71

Хуки з функції

Використання

Приклади

#1 Висновок цитати з обмеженням символів

#2 Приклад перевірки наявності цитати.

список змін

Код get_the_excerpt() get the excerpt WP 6.0.2

Зв’язані функції

excerpt (цитата уривок фрагмент)

loop (Цикл WP)

Записи: пости, сторінки, …

Залишити відповідь Скасувати коментар

Код `get_the_excerpt() get the excerpt` ^{WP 6.0.2}