Описание функции get_user_option()
Функция get_user_option() используется для получения значений пользовательских опций, которые сохраняются в базе данных. Она позволяет разработчикам получать настройки, специфичные для каждого пользователя, например, настройки внешнего вида или предпочтения. Это особенно полезно для создания персонализированного опыта для пользователей в WordPress.
Функция возвращает опции, сохраненные с помощью функции update_user_option() или add_user_option()
Параметры
$option
Тип: string
Обязательный: Да
По умолчанию: null
Описание: Название опции, которую нужно получить
$user_id
Тип: int
Обязательный: Нет
По умолчанию: get_current_user_id()
Описание: ID пользователя, для которого нужно получить опцию. Если не указан, используется текущий пользователь
Возвращаемое значение
Тип: mixed
Описание: Возвращает значение пользовательской опции или false, если опция не найдена
Возможные значения:
• Значение опции при успешном выполнении
• false, если опция не существует
Примеры использования
$color = get_user_option('admin_color');
// Вывод значения опции
echo $color; // Возможно, 'fresh'
$user_id = 1;
$show_admin_bar = get_user_option('show_admin_bar', $user_id);
// Вывод значения опции
echo $show_admin_bar; // true или false
Проверка на существование опции и обработка случая, когда она отсутствует
$value = get_user_option('non_existent_option');
if ($value === false) {
echo 'Опция не найдена';
}
Пример использования в контексте плагина для получения пользовательской опции
$user_id = get_current_user_id();
$my_option = get_user_option('my_custom_option', $user_id);
if ($my_option) {
// Действия с опцией
}
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Функция автоматически обрабатывает пользовательский ввод
Рекомендации: При выводе данных используйте esc_html() для опций, чтобы избежать XSS-уязвимостей
— Связанные функции
Обновляет значение пользовательской опции
Получает метаданные пользователя
— Примечания
– Ограничения
Функция возвращает только пользовательские опции, которые существуют в базе данных
– Частые проблемы
- Возврат false при запросе несуществующей опции
- Неверный ID пользователя может привести к получению опции текущего пользователя
