WP_DEQUEUE_SCRIPT() │ WP 3.1.0

Функция wp_dequeue_script() используется для удаления ранее добавленного скрипта на сайт WordPress.

Возвращаемое значение

Функция не возвращает ничего (null).

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

wp_dequeue_script( $handle );

• $handle (строка) (обязательный) — название скрипта, который нужно удалить.

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

Пример 1: Отключение jQuery

Допустим, на вашем сайте подключён скрипт jQuery, но по каким-то причинам он вам не нужен. Это пример того, как отключить скрипт jQuery:

add_action( 'wp_print_scripts', 'de_script', 100 );

function de_script() {
    wp_dequeue_script( 'jquery' );
    wp_deregister_script( 'jquery' ); // Также убрать регистрацию скрипта
}

Пример 2: Удаление jQuery UI

Предположим, у вас на странице подключён скрипт jquery-ui-core, но он вам не нужен. Мы можем его удалить следующим образом:

add_action( 'wp_print_scripts', 'wpdocs_dequeue_script', 100 );

/**
 * Удаляет скрипт jQuery UI.
 *
 * Подключен к действию wp_print_scripts с большим приоритетом (100),
 * чтобы выполнение происходило после того, как скрипт был подключён.
 */
function wpdocs_dequeue_script() {
    wp_dequeue_script( 'jquery-ui-core' );
}

Заметки

• Для подробной информации вы можете ознакомиться с методом WP_Dependencies::dequeue().

Список изменений

• С версии 3.1.0: функция была введена.

Код функции wp_dequeue_script

function wp_dequeue_script( $handle ) {
    _wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );

    wp_scripts()->dequeue( $handle );
}

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

• wp_add_inline_script()
• wp_deregister_script()
• wp_enqueue_media()
• wp_enqueue_script()
• wp_localize_script()
• wp_register_script()
• wp_script_add_data()
• wp_script_is()

Стили и скрипты

• add_editor_style()
• wp_add_inline_style()
• wp_dequeue_style()
• wp_deregister_style()
• wp_enqueue_code_editor()
• wp_enqueue_editor()
• wp_enqueue_style()
• wp_get_custom_css()
• wp_localize_jquery_ui_datepicker()
• wp_register_style()
• wp_resource_hints()
• wp_style_add_data()
• wp_style_is()

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