Описание customize_allowed_urls
— Filter
Хук customize_allowed_urls позволяет изменить список допустимых URL-адресов в настройках кастомайзера WordPress. Он срабатывает при загрузке кастомайзера и позволяет добавлять или удалять URL, которые могут быть использованы для настройки различных параметров сайта
Примеры использования
Пример добавления нового допустимого URL:
add_filter('customize_allowed_urls', function($allowed_urls) {
$allowed_urls[] = 'https://example.com';
return $allowed_urls;
});
В этом примере мы добавляем новый допустимый URL ‘https://example.com’ в настройки кастомайзера
Пример удаления существующего допустимого URL:
add_filter('customize_allowed_urls', function($allowed_urls) {
$key = array_search('https://old-url.com', $allowed_urls);
if ($key !== false) {
unset($allowed_urls[$key]);
}
return $allowed_urls;
});
Здесь мы удаляем URL ‘https://old-url.com’ из списка допустимых URL
Пример изменения списка допустимых URL в зависимости от условий:
add_filter('customize_allowed_urls', function($allowed_urls) {
if (is_user_logged_in()) {
$allowed_urls[] = 'https://admin-url.com';
}
return $allowed_urls;
});
В этом примере мы добавляем URL ‘https://admin-url.com’ только для зарегистрированных пользователей
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо контролировать, какие URL могут быть использованы в кастомайзере
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются лишь списка URL
– Предупреждения
Следите за тем, чтобы разрешенные URL были безопасными и не содержали вредоносного контента
Альтернативы
Тип: action
Этот хук позволяет добавлять собственные настройки в кастомайзер, что может быть использовано для управления URL
Используйте его, если необходимо создать собственные настройки, которые зависят от URL
