WordPress как на ладони
Наставник Трепачёв Д.П., phphtml.net wordpress jino

wp_trim_words() WP 3.3.0

Обрезает переданный текст до указанного количества слов.

Вспомогательная функция WordPress, которую можно использовать вместо the_excerpt(), чтобы вывести часть контента обрезанную до нужного количества слов.

Используется в: wp_trim_excerpt().
Хуки из функции:
Возвращает

Строку. Обрезанный текст.

Использование

wp_trim_words( $text, $num_words, $more );
$text(строка) (обязательный)
Текст, который нужно обрезать.
$num_words(число)
Количество слов. Указывается, сколько слов с начала строки нужно оставить.
По умолчанию: 55
$more(строка)
Текст, заканчивающий строку, если строка была обрезана. По умолчанию, знак троеточия - , чтобы показать что это обрезанный текст.
По умолчанию: '…'

Примеры

#1 Демонстрация работы

Пример показывает как функция работает с кириллическими знаками:

$text = "«Познер» — еженедельная авторская программа Владимира Познера, которая выходит с ноября 2008 года в ночном эфире Первого канала.";

echo wp_trim_words( $text, 5, ' ...' );

# Вернет: «Познер» — еженедельная авторская программа ...

#2 Аналог the_excerpt()

Пример, показывает как получить текущий контент поста и обрезать его до 40-ка слов и в конце, если нужно, добавить ссылку Читать дальше...:

$content = get_the_content();
$trimmed_content = wp_trim_words( $content, 40, '<a href="'. get_permalink() .'"> ...Read More</a>' );
echo $trimmed_content;

Код wp trim words: wp-includes/formatting.php WP 4.8.1

<?php
function wp_trim_words( $text, $num_words = 55, $more = null ) {
	if ( null === $more ) {
		$more = __( '&hellip;' );
	}

	$original_text = $text;
	$text = wp_strip_all_tags( $text );

	/*
	 * translators: If your word count is based on single characters (e.g. East Asian characters),
	 * enter 'characters_excluding_spaces' or 'characters_including_spaces'. Otherwise, enter 'words'.
	 * Do not translate into your own language.
	 */
	if ( strpos( _x( 'words', 'Word count type. Do not translate!' ), 'characters' ) === 0 && preg_match( '/^utf\-?8$/i', get_option( 'blog_charset' ) ) ) {
		$text = trim( preg_replace( "/[\n\r\t ]+/", ' ', $text ), ' ' );
		preg_match_all( '/./u', $text, $words_array );
		$words_array = array_slice( $words_array[0], 0, $num_words + 1 );
		$sep = '';
	} else {
		$words_array = preg_split( "/[\n\r\t ]+/", $text, $num_words + 1, PREG_SPLIT_NO_EMPTY );
		$sep = ' ';
	}

	if ( count( $words_array ) > $num_words ) {
		array_pop( $words_array );
		$text = implode( $sep, $words_array );
		$text = $text . $more;
	} else {
		$text = implode( $sep, $words_array );
	}

	/**
	 * Filters the text content after words have been trimmed.
	 *
	 * @since 3.3.0
	 *
	 * @param string $text          The trimmed text.
	 * @param int    $num_words     The number of words to trim the text to. Default 55.
	 * @param string $more          An optional string to append to the end of the trimmed text, e.g. &hellip;.
	 * @param string $original_text The text before it was trimmed.
	 */
	return apply_filters( 'wp_trim_words', $text, $num_words, $more, $original_text );
}

Cвязанные функции

Из метки: Вспомогательные

Еще из раздела: Форматирование

wp_trim_words 1 комментарий

Здравствуйте, !

Ваш комментарий