Codex

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

Contents

Описание

Безопасный способ добавления именованных пар опция/значение в таблицу 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.
Retrieved from "http://codex.wordpress.org/%D0%A1%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA_%D0%BF%D0%BE_%D1%84%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D1%8F%D0%BC/add_option"

Codex Resources