Описание функции wp_enqueue_script()
Функция wp_enqueue_script() позволяет добавлять JavaScript-файлы в очередь для подключения к сайту WordPress. Она обеспечивает правильный порядок загрузки скриптов и предотвращает дублирование. Используется в темах и плагинах для подключения пользовательских и сторонних скриптов.
Функция обрабатывает зависимости, версии скриптов и их интеграцию с другими компонентами.
Параметры
$handle
Тип: string
Обязательный: Да
Описание: Уникальный идентификатор скрипта
Возможные значения:
$src
Тип: string
Обязательный: Да
Описание: URL-адрес скрипта для подключения
Возможные значения:
$deps
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив зависимостей для скрипта
Возможные значения:
$ver
Тип: string|bool
Обязательный: Нет
По умолчанию: false
Описание: Версия скрипта
Возможные значения:
$in_footer
Тип: bool
Обязательный: Нет
По умолчанию: false
Описание: Загружать скрипт в футере или в хедере
Возможные значения:
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
Примеры использования
Подключение скрипта без зависимостей и версии
wp_enqueue_script('my_custom_script', 'https://example.com/my-script.js');
Скрипт будет загружен в хедере по умолчанию
Скрипт зависит от jQuery и имеет указанную версию
wp_enqueue_script('my_custom_script', 'https://example.com/my-script.js', array('jquery'), '1.0.0');
jQuery будет загружен перед my_custom_script
Скрипт будет загружен в футере страницы
wp_enqueue_script('my_custom_script', 'https://example.com/my-script.js', array(), null, true);
Это улучшает производительность загрузки страницы
Безопасность
Валидация входных данных: Параметры проходят базовую валидацию внутри функции
Санитизация: URL-адреса должны быть валидными
Рекомендации: Используйте esc_url() для очистки URL-адресов скриптов
— Связанные функции
Удаляет скрипт из очереди
Регистрирует скрипт без его немедленной загрузки
— Примечания
– Ограничения
Не работает внутри функций, вызванных до wp_enqueue_scripts
– Частые проблемы
- Ошибки с дублированием скриптов
- Не загружается скрипт, если неправильно указаны зависимости
