WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Справочник по функциям/add option

Описание

Безопасный способ добавления именованных пар опция/значение в таблицу options базы данных. Если опция уже существует, функция ничего не делает. После того как опция сохранена она может быть получена через get_option(), изменена с помощью update_option(), и удалена с delete_option().

Данные обрабатываются через $wpdb->escape перед INSERT запросом.

Использование для wp 2.3.X или новее

В последних версиях WordPress (2.3.X) параметр $description является запрещенным и удаляет значения из таблицы wp_options Использование такое же, но второй параметр не используется.

Сморите ниже для старых версий этого справочника

<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>

Пример для wp 2.3.X или новее

<?php add_option("myhack_extraction_length", '255', '', 'yes'); ?>

Параметры для wp 2.3.X или новее

$name
(string) (required) Название опции, которая будет добавлена. Используйте подчеркивания чтобы разделить слова и не используйте верхний регистр — все это будет записано в базу данных.
Default: None
$value
(string) (optional) Значение опции. Ограничение до 2^32 байт данных
Default: Empty
$deprecated
(string) (optional) Не используется.
Default: Empty
$autoload
(string) (optional) Должна ли опция быть загружена автоматически функцией wp_load_alloptions (помещает опции в объект в кеше для каждой загрузки страницы)? Верные значения: yes or no.
Default: yes

Использование до того как $description был запрещен

В последних версиях WordPress (2.3.X) параметр $description является запрещенным и удаляет значения из таблицы wp_options
Использование такое же, но второй параметр не используется.
WP 2.3.X или новее 
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>


<?php add_option($name, $value = '', $description = '', $autoload = 'yes'); ?>

Примеры

<?php add_option("myhack_extraction_length", '255', 
'Максимальное количество букв в распакованном тексте.', 'yes'); ?>

Параметры до того как $description был запрещен

$name
(string) (required) Название опции, которая будет добавлена. Используйте подчеркивания чтобы разделить слова и не используйте верхний регистр — все это будет записано в базу данных.
Default: None
$value
(string) (optional) Значение опции.
Default: Empty
$description
(string) (optional) Текст описывающий опцию. Описание может быть использовано в подписях в бекэнде.
Default: Empty
$autoload
(string) (optional) Должна ли опция быть загружена автоматически? Верные значения: yes or no.
Default: yes

Схожее

get_option, add_option, update_option, delete_option

См. также содержание справочника по функциям и список тегов шаблонов.
This article is marked as in need of editing. You can help Codex by editing it.