Что на самом деле делает apply

123

Я пытаюсь понять некоторые функции WordPress, но не могу понять, что на самом деле делает apply_filters (...) .

Может ли кто-нибудь прояснить мне это на нескольких примерах?

wordpress function

— Тим
источник

12

Отлично: dev.themeblvd.com/tutorial/filters

— Набиль Кадими

Примечание, которое apply_filters()является невероятно вводящим в заблуждение названием для функции, поскольку она применяет как фильтры, так и действия, привязанные к целевой функции

— cameronjonesweb

@NabilKadimi, отличное предложение, dev.themeblvd.com/tutorial/filters/#highlighter_604585 , но если эта функция не принимает никаких аргументов (щелкните ссылку, чтобы узнать, о какой функции я говорю), как изменяется переменная $ output , как он описывает в следующем разделе кода?

— Рамеш Парик

@RameshPareek Кажется, ваша ссылка работает не так, как ожидалось, используйте Github gist.

— Nabil Kadimi

Прости! Прокрутите вниз до раздела Пример 1: Основы на этой странице.

— Ramesh Pareek

104

apply_filters($tag, $value)передает аргумент «значение» каждой из функций, «подключенных» (использующих add_filter) к указанному «тегу» фильтра. Каждая функция выполняет некоторую обработку значения и возвращает измененное значение для передачи следующей функции в последовательности.

Например, по умолчанию (в WordPress 2.9) the_contentфильтр передает значение через следующую последовательность функций:

wptexturize
convert_smilies
convert_chars
wpautop
shortcode_unautop
prepend_attachment
do_shortcode

— Ричард М
источник

Также не забудьте повторить все, что вы не используете, значение, если кажется, что apply_filters($value)оно стирает значение ...

— MrMesees

32

поздний ответ

Краткое объяснение

apply_filters()взаимодействует с global $wp_filtersмассивом. По сути, он просто проверяет массив, если текущий фильтр (или ловушка) имеет прикрепленное действие (/ функцию обратного вызова), а затем вызывает его.

Длинное объяснение

Когда вы прикрепляете обратный вызов / действие к фильтру или ловушке, вы просто добавляете имя обратного вызова в массив глобальных фильтров. Когда затем в коде (например, в шаблоне, ядре или файле плагина) происходит вызов do_action()или apply_filters()происходит, тогда WordPress выполняет поиск по массиву и вызывает обратный вызов. Единственное, что делает фильтры более особенными, чем хуки, это то, что они возвращают значение (для дальнейшей обработки) вместо того, чтобы просто запускать обратный вызов. Итак, резюмируем: ловушки предназначены для вставки данных, а фильтры - для изменения данных.

— кайзер
источник

19

Вот что я понял, учитывая наиболее популярный ответ и дополнительные ресурсы:

$ tag кажется синонимом названия хука. (Для меня это не особенно интуитивно.)
the_content - это пример ловушки типа "фильтр".
Хук the_content состоит из нескольких фильтров.
Фильтры изменяют данные. Они в основном фильтруют базу данных, изменяя данные до того, как пользователи их увидят.
Например, обычно применяется apply_filters (), чтобы применить фильтры the_content к $ content. В этом случае двойные возвраты будут преобразованы в <p>теги, смайлы - в значки и т. Д.
the_content - это ловушка, а the_content () - функция.

— Марджори Розуэлл
источник

1

В самых общих чертах, apply_filters используется для инициализации ловушки фильтра ... add_filter назначает новую функцию хукам, которые уже были созданы.

— Стив
источник

3

Извините, это не так: apply_filters () вызывает уже инициализированные перехватчики фильтра, а add_filter () - вызов, который создает перехватчик фильтра. Я знаю, что вы на самом деле имели это в виду, но у вас неправильные функции!

— Brian C

apply_filters ($ тегов, значение $); позволяет вам создать место в вашем коде, где вы можете разрешить привязку и изменение передаваемого вами значения $ с помощью add_filter ();

— Styledev

Что на самом деле делает apply_filters (…) в WordPress?

Краткое объяснение

Длинное объяснение