Удаление всех фильтров в WordPress с помощью функции remove_all_filters()

Функция remove_all_filters() предназначена для удаления всех хуков (обработчиков) из определенного фильтра. Она используется для манипуляций с фильтрами в WordPress.

Возврат значения

Функция всегда возвращает true.

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

Чтобы использовать функцию remove_all_filters(), необходимо передать ей имя фильтра и приоритет:

remove_all_filters( $hook_name, $priority );

Параметры

• $hook_name (string) (обязательный) — имя фильтра, из которого нужно удалить обработчики.
• $priority (int|false) — номер приоритета, с которого нужно удалить обработчики. По умолчанию: false.

Примеры использования

Пример 1: Удаление всех функций (хуков) из фильтра

Чтобы удалить все функции, прикрепленные к фильтру wp_mail_from, используйте следующий код:

remove_all_filters( 'wp_mail_from' );
[input]

Пример 2: Удаление хуков с заданным приоритетом

Если вы хотите удалить только те хуки, которые зарегистрированы с приоритетом 10 для фильтра the_content, используйте такой код:

[sourcecode language="php"]
remove_all_filters( 'the_content', 10 );

Этот код отключит большинство фильтров для текста поста — то есть все фильтры с приоритетом 10 будут отключены. Вот какие функции будут удалены:

add_filter( 'the_content', 'wptexturize'                       );
add_filter( 'the_content', 'wpautop'                           );
add_filter( 'the_content', 'shortcode_unautop'                 );
add_filter( 'the_content', 'prepend_attachment'                );
add_filter( 'the_content', 'wp_make_content_images_responsive' );

Если у вас есть фильтры с нестандартным приоритетом (например, 15), вы можете удалить их так:

remove_all_filters( 'wp_delete_file', 15 );

Заметки

• Функция использует глобальную переменную $wp_filter, которая хранит все фильтры и действия.

Изменения

Функция была добавлена в версию WordPress 2.7.0.

Код функции

Вот код, который реализует функцию remove_all_filters() в WordPress:

function remove_all_filters( $hook_name, $priority = false ) {
global $wp_filter;

if ( isset( $wp_filter[ $hook_name ] ) ) {
    $wp_filter[ $hook_name ]->remove_all_filters( $priority );

    if ( ! $wp_filter[ $hook_name ]->has_filters() ) {
        unset( $wp_filter[ $hook_name ] );
    }
}

return true;

}

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

Вот некоторые другие функции, которые могут быть полезны при работе с фильтрами и хуками:

Фильтры (хуки)

• add_filter()
• apply_filters()
• current_filter()
• doing_filter()
• has_filter()
• remove_filter()

Хуки (действия, фильтры)

• add_action()
• apply_filters_ref_array()
• did_action()
• do_action()
• remove_action()
• remove_all_actions()

Эти функции помогут вам лучше управлять фильтрами и действиями в WordPress, делая процесс разработки более гибким.