Описание функции add_network_option()
Функция add_network_option() используется для добавления новой опции в базу данных сетевых настроек WordPress Multisite. Эта функция позволяет сохранить значения, уникальные для всей сети сайтов, что полезно для управления общими настройками и конфигурациями.
Функция полезна при разработке плагинов и тем, которые требуют сохранения глобальных настроек для сети
Параметры
$network_id
Тип: int
Обязательный: Да
Описание: ID сети, в которую будет добавлена опция
Возможные значения:
$option
Тип: string
Обязательный: Да
Описание: Имя опции, которую нужно добавить
Возможные значения:
$value
Тип: mixed
Обязательный: Да
Описание: Значение опции, которое будет сохранено
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешном добавлении опции, false в противном случае
Возможные значения:
• true — если опция была успешно добавлена
• false — если опция не была добавлена или произошла ошибка
Примеры использования
Базовый пример добавления опции для сети с ID 1
$result = add_network_option(1, 'site_name', 'My Network Site');
// $result будет true
Опция ‘site_name’ добавлена с значением ‘My Network Site’
Добавление опции с массивом настроек в сеть
$settings = array('color' => 'blue', 'size' => 'large');
$result = add_network_option(1, 'theme_settings', $settings);
Опция ‘theme_settings’ будет содержать массив настроек
Проверка успешности добавления опции
$result = add_network_option(1, 'site_name', 'My Network Site');
if (!$result) {
// Обработка ошибки при добавлении опции
echo 'Ошибка при добавлении опции';
}
Если добавление не удалось, выводится сообщение об ошибке
Безопасность
Валидация входных данных: Функция проверяет корректность ID сети и имени опции
Санитизация: Значение опции автоматически очищается перед добавлением
Рекомендации: Убедитесь, что значения не содержат потенциально опасных данных
— Связанные функции
Получает значение сетевой опции по имени
Обновляет значение существующей сетевой опции
Удаляет сетевую опцию из базы данных
— Примечания
– Ограничения
Функция не работает в одиночном режиме WordPress
– Частые проблемы
- Ошибка при попытке добавить опцию с уже существующим именем
- Некорректный ID сети
