apply_filters с версии 0.71

Описание

Вызывает функцию, прикрепленную к указанному фильтру.

Используется в плагинах и темах, для создания новых фильтров (точек зацепки пользовательских функций). Новые фильтры, соответственно, имею новые названия и не должны совпадать с уже имеющимися в ВП фильтрами.

Функция возвращает отфильтрованное значение $value, которое передается функции-обработчику хука.

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

<?php apply_filters( $tag, $value, $var ... ); ?>

Параметры

$tag (строка) (обязательный)

Название фильтра.
По умолчанию: нет

$value (строка/массив/число/объект/логический) (обязательный)

Значение, которое будет передаваться функции в её первом аргументе, другими словами - значение, которое нужно отфильтровать.
По умолчанию: нет

$var (строка/массив/число/объект/логический)

Дополнительные значения, которые будет передавать фильтр функции.
По умолчанию: нет

Примеры

1. Вывод на экран после фильтрации:

echo apply_filters( $tag, $value );

2. Получение отфильтрованного занчения:

$myvar = apply_filters( $tag, $value );

3. Дополнительные аргументы:

$myvar = apply_filters( $tag, $value, $param, $otherparam );

4. Пример вывода отформатированного контента записи через фильтр. Альтернатива функции the_content():

global $post;
echo apply_filters( 'the_content', $post->post_content );

apply_filters()

function apply_filters($tag, $value) {
	global $wp_filter, $merged_filters, $wp_current_filter;

	$args = array();

	// Do 'all' actions first
	if ( isset($wp_filter['all']) ) {
		$wp_current_filter[] = $tag;
		$args = func_get_args();
		_wp_call_all_hook($args);
	}

	if ( !isset($wp_filter[$tag]) ) {
		if ( isset($wp_filter['all']) )
			array_pop($wp_current_filter);
		return $value;
	}

	if ( !isset($wp_filter['all']) )
		$wp_current_filter[] = $tag;

	// Sort
	if ( !isset( $merged_filters[ $tag ] ) ) {
		ksort($wp_filter[$tag]);
		$merged_filters[ $tag ] = true;
	}

	reset( $wp_filter[ $tag ] );

	if ( empty($args) )
		$args = func_get_args();

	do {
		foreach( (array) current($wp_filter[$tag]) as $the_ )
			if ( !is_null($the_['function']) ){
				$args[1] = $value;
				$value = call_user_func_array($the_['function'], array_slice($args, 1, (int) $the_['accepted_args']));
			}

	} while ( next($wp_filter[$tag]) !== false );

	array_pop( $wp_current_filter );

	return $value;
}

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.

Привычное дело - заказать такси и доехать до места назначения, а что делать если таким вот образом нужно перевезти, например, мебель или строительные материалы, или что-то еще объемное и тяжелое, какое такси выбрать в этом случае. Есть такое понятие как - грузовое такси, которые предлагают услуги подобного рода. Грузовые такси это машины моделей: газель, камаз, зил и современные модели грузовых машин.