Описание функции get_site_option()
Функция get_site_option() используется для получения значений глобальных настроек сайта в WordPress Multisite. Она позволяет извлекать параметры, установленные для всего сайта, что особенно полезно в контексте многоуровневых сетей сайтов.
Функция поддерживает кэширование и возвращает значение настройки, если оно существует, или значение по умолчанию, если настройки нет
Параметры
$option
Тип: string
Обязательный: Да
Описание: Имя настройки, которую необходимо получить
Возможные значения:
$default
Тип: mixed
Обязательный: Нет
Описание: Значение по умолчанию, если настройка не найдена
Возможные значения:
Возвращаемое значение
Тип: mixed
Описание: Возвращает значение настройки или значение по умолчанию
Возможные значения:
• Значение настройки, если оно существует
• Значение по умолчанию, если настройки нет
• null, если опция не была установлена
Примеры использования
Базовый пример получения имени сайта
$site_name = get_site_option('site_name');
// Вывод имени сайта
echo $site_name;
Выводит имя текущего сайта
Получение временной зоны с значением по умолчанию
$timezone = get_site_option('timezone_string', 'UTC');
// Вывод временной зоны
echo $timezone;
Возвращает ‘UTC’, если настройка не найдена
Проверка наличия настройки и использование значения по умолчанию
$custom_setting = get_site_option('custom_setting', 'default_value');
if ($custom_setting === 'default_value') {
// Настройка отсутствует, используем значение по умолчанию
}
Позволяет избежать ошибок при отсутствии настройки
Безопасность
Валидация входных данных: Проверка имени настройки происходит внутри функции
Санитизация: Функция не требует дополнительной очистки, но лучше использовать sanitisers при выводе
Рекомендации: При выводе данных используйте esc_html() для предотвращения XSS
— Связанные функции
Обновляет значение настройки для сайта
Удаляет настройку сайта
— Хуки
Фильтрует значение опции перед ее возвратом
— Примечания
– Ограничения
Работает только в контексте сети сайтов (Multisite)
– Частые проблемы
- Возвращение null, если опция не установлена
- Некорректное имя опции приводит к отсутствию значения
