Как использовать функцию wp_enqueue_script для удаления и замены скриптов в теме WordPress

Диагностика проблемы с загрузкой скриптов в теме WordPress

Частая проблема при разработке или кастомизации темы — конфликт или избыточная загрузка JavaScript-файлов. Это приводит к медленной загрузке страниц, конфликтам между библиотеками и ошибкам в консоли браузера. Чтобы точно определить, какие скрипты подключаются, воспользуйтесь инструментами разработчика в браузере (вкладка Network и Console). Также можно использовать плагин Query Monitor для подробного анализа подключаемых файлов и хуков.

Пошаговое решение: удаление и замена скриптов через wp_enqueue_script и wp_dequeue_script

1. Удаление ненужного скрипта

Для удаления скрипта, зарегистрированного в WordPress или теме, используйте хук wp_enqueue_scripts с приоритетом не ниже 20 (чтобы вызов шел после регистрации скриптов):

function remove_unwanted_scripts() {
    wp_dequeue_script('handle-скрипта');
    wp_deregister_script('handle-скрипта');
}
add_action('wp_enqueue_scripts', 'remove_unwanted_scripts', 20);

Замените handle-скрипта на идентификатор скрипта, который хотите убрать. Найти handle можно в исходниках темы или плагина.

2. Подключение своего скрипта вместо удалённого

После удаления добавьте свой скрипт с новым handle и нужными зависимостями:

function replace_script_with_custom() {
    wp_dequeue_script('handle-старого-скрипта');
    wp_deregister_script('handle-старого-скрипта');

    wp_enqueue_script(
        'my-custom-script',
        get_template_directory_uri() . '/js/my-custom-script.js',
        array('jquery'),
        '1.0',
        true
    );
}
add_action('wp_enqueue_scripts', 'replace_script_with_custom', 20);

Параметры функции wp_enqueue_script:

• handle — уникальный идентификатор скрипта;
• src — URL файла, обычно в папке темы или child-темы;
• deps — массив зависимостей, например jquery;
• ver — версия скрипта для контроля кеша;
• in_footer — расположение скрипта (true — в футере).

Как проверить, что удаление и замена скриптов сработали

1. Откройте страницу сайта и обновите кеш браузера (Ctrl+F5).
2. В консоли разработчика браузера на вкладке Network найдите подключаемые JS-файлы. Убедитесь, что старый скрипт отсутствует.
3. Проверьте консоль на отсутствие ошибок, связанных с отсутствием скриптов.
4. Убедитесь, что ваш скрипт загрузился и работает корректно (например, с помощью console.log в начале файла).

Частые ошибки и как их исправить

• Скрипт не удаляется: возможно, хук подключён с приоритетом ниже 20, а скрипт регистрируется позже. Попробуйте повысить приоритет до 99.
• Ошибка «handle скрипта не найден»: handle указан неправильно. Проверьте точное имя handle в исходниках или используйте Query Monitor.
• Скрипты конфликтуют друг с другом: проверьте зависимости и порядок подключения, возможно, нужны дополнительные wp_dequeue_script и правильный список зависимостей.
• Ваш скрипт не работает: проверьте, что он подключен в футере (если зависит от DOM), и что все зависимости загружены.

Практические советы по безопасности и производительности

• Используйте wp_register_script для предварительной регистрации скрипта, если он может потребоваться на нескольких страницах.
• Минимизируйте и объединяйте скрипты, чтобы уменьшить количество запросов.
• Подключайте скрипты в футере (in_footer = true), чтобы не блокировать загрузку страницы.
• Для кастомных скриптов используйте уникальные имена handle, чтобы избежать конфликтов.
• Проверяйте наличие jQuery или других зависимостей перед подключением скриптов, чтобы избежать ошибок.

Сравнение способов удаления и замены скриптов

wp_dequeue_script('handle');
wp_deregister_script('handle');