Описание функции wp_register()
Функция wp_register() используется для регистрации пользовательских стилей и скриптов в WordPress. Она позволяет указать зависимости, версию и состояние загрузки скрипта или стиля. Это важно для того, чтобы обеспечить правильное взаимодействие и загрузку ресурсов на страницах сайта.
Функция должна быть вызвана перед использованием wp_enqueue_script() или wp_enqueue_style() для фактической загрузки зарегистрированных ресурсов.
Параметры
$handle
Тип: string
Обязательный: Да
Описание: Уникальный идентификатор для скрипта или стиля
Возможные значения:
$src
Тип: string
Обязательный: Да
Описание: URL к файлу скрипта или стиля
Возможные значения:
$deps
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив идентификаторов зависимых скриптов или стилей
Возможные значения:
$ver
Тип: string|bool
Обязательный: Нет
По умолчанию: false
Описание: Версия скрипта или стиля. Укажите false, чтобы отключить версию
Возможные значения:
$in_footer
Тип: bool
Обязательный: Нет
По умолчанию: false
Описание: Если true, загрузить скрипт перед закрывающим тегом body
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
Примеры использования
Регистрация скрипта без зависимостей и версии
wp_register_script('my-script', 'https://example.com/script.js');
Регистрация стиля с указанием зависимости и версии
wp_register_style('my-style', 'https://example.com/style.css', array('some-dependency'), '1.0.0');
Регистрация и загрузка скрипта в теме
function my_theme_scripts() {
wp_register_script('my-script', get_template_directory_uri() . '/js/my-script.js', array('jquery'), '1.0.0', true);
wp_enqueue_script('my-script');
}
add_action('wp_enqueue_scripts', 'my_theme_scripts');
Безопасность
Валидация входных данных: Параметры handle и src должны быть проверены на корректность
Санитизация: WordPress автоматически очищает URL-адреса
Рекомендации: При использовании внешних URL-адресов убедитесь в их безопасности
— Связанные функции
Загрузка зарегистрированного скрипта на страницу
Загрузка зарегистрированного стиля на страницу
— Примечания
– Ограничения
Не позволяет загружать ресурсы из локальных файлов без регистрации
– Частые проблемы
- Скрипт не загружается, если он не зарегистрирован
- Ошибки в URL-адресах могут привести к неработающим ресурсам
