WordPress.org

Ready to get started?Download WordPress

Codex

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

Function Reference/add option

Description

A safe way of adding a named option/value pair to the options database table. It does nothing if the option already exists. The data is escaped with $wpdb->escape before the INSERT statement.

Usage

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

Example

Usage

<?php add_option("myhack_extraction_length", '255', 
'Max length of extracted text in characters.', 'yes'); ?>

Parameters

$name
(string) (required) Name of the option to be added. Use underscores to separate words, and do not use uppercase—this is going to be placed into the database.
Default: None
$value
(string) (optional) Value for this option name.
Default: Empty
$description
(string) (optional) Descriptive text for the option. The description can be used in backend labels.
Default: Empty
$autoload
(string) (optional) Should this option be automatically loaded? Valid values: yes or no.
Default: yes
This article is marked as in need of editing. You can help Codex by editing it.