add_blog_option

The timeline below displays how wordpress function add_blog_option has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.2

/**
 * Adds a new option for a given blog ID.
 *
 * You do not need to serialize values. If the value needs to be serialized, then
 * it will be serialized before it is inserted into the database. Remember,
 * resources can not be serialized or added as an option.
 *
 * You can create options without values and then update the values later.
 * Existing options will not be updated and checks are performed to ensure that you
 * aren't adding a protected WordPress option. Care should be taken to not name
 * options the same as the ones which are protected.
 *
 * @since MU (3.0.0)
 *
 * @param int    $id     A blog ID. Can be null to refer to the current blog.
 * @param string $option Name of option to add. Expected to not be SQL-escaped.
 * @param mixed  $value  Option value, can be anything. Expected to not be SQL-escaped.
 * @return bool True if the option was added, false otherwise.
 */
function add_blog_option($id, $option, $value)
{
    $id = (int) $id;
    if (empty($id)) {
        $id = get_current_blog_id();
    }
    if (get_current_blog_id() == $id) {
        return add_option($option, $value);
    }
    switch_to_blog($id);
    $return = add_option($option, $value);
    restore_current_blog();
    return $return;
}

WordPress Version: 5.5

/**
 * Add a new option for a given blog ID.
 *
 * You do not need to serialize values. If the value needs to be serialized, then
 * it will be serialized before it is inserted into the database. Remember,
 * resources can not be serialized or added as an option.
 *
 * You can create options without values and then update the values later.
 * Existing options will not be updated and checks are performed to ensure that you
 * aren't adding a protected WordPress option. Care should be taken to not name
 * options the same as the ones which are protected.
 *
 * @since MU (3.0.0)
 *
 * @param int    $id     A blog ID. Can be null to refer to the current blog.
 * @param string $option Name of option to add. Expected to not be SQL-escaped.
 * @param mixed  $value  Optional. Option value, can be anything. Expected to not be SQL-escaped.
 * @return bool True if the option was added, false otherwise.
 */
function add_blog_option($id, $option, $value)
{
    $id = (int) $id;
    if (empty($id)) {
        $id = get_current_blog_id();
    }
    if (get_current_blog_id() == $id) {
        return add_option($option, $value);
    }
    switch_to_blog($id);
    $return = add_option($option, $value);
    restore_current_blog();
    return $return;
}

WordPress Version: 4.9

/**
 * Add a new option for a given blog id.
 *
 * You do not need to serialize values. If the value needs to be serialized, then
 * it will be serialized before it is inserted into the database. Remember,
 * resources can not be serialized or added as an option.
 *
 * You can create options without values and then update the values later.
 * Existing options will not be updated and checks are performed to ensure that you
 * aren't adding a protected WordPress option. Care should be taken to not name
 * options the same as the ones which are protected.
 *
 * @since MU (3.0.0)
 *
 * @param int    $id     A blog ID. Can be null to refer to the current blog.
 * @param string $option Name of option to add. Expected to not be SQL-escaped.
 * @param mixed  $value  Optional. Option value, can be anything. Expected to not be SQL-escaped.
 * @return bool False if option was not added and true if option was added.
 */
function add_blog_option($id, $option, $value)
{
    $id = (int) $id;
    if (empty($id)) {
        $id = get_current_blog_id();
    }
    if (get_current_blog_id() == $id) {
        return add_option($option, $value);
    }
    switch_to_blog($id);
    $return = add_option($option, $value);
    restore_current_blog();
    return $return;
}

WordPress Version: 4.3

/**
 * Add a new option for a given blog id.
 *
 * You do not need to serialize values. If the value needs to be serialized, then
 * it will be serialized before it is inserted into the database. Remember,
 * resources can not be serialized or added as an option.
 *
 * You can create options without values and then update the values later.
 * Existing options will not be updated and checks are performed to ensure that you
 * aren't adding a protected WordPress option. Care should be taken to not name
 * options the same as the ones which are protected.
 *
 * @since MU
 *
 * @param int    $id     A blog ID. Can be null to refer to the current blog.
 * @param string $option Name of option to add. Expected to not be SQL-escaped.
 * @param mixed  $value  Optional. Option value, can be anything. Expected to not be SQL-escaped.
 * @return bool False if option was not added and true if option was added.
 */
function add_blog_option($id, $option, $value)
{
    $id = (int) $id;
    if (empty($id)) {
        $id = get_current_blog_id();
    }
    if (get_current_blog_id() == $id) {
        return add_option($option, $value);
    }
    switch_to_blog($id);
    $return = add_option($option, $value);
    restore_current_blog();
    return $return;
}

WordPress Version: 3.7

/**
 * Add a new option for a given blog id.
 *
 * You do not need to serialize values. If the value needs to be serialized, then
 * it will be serialized before it is inserted into the database. Remember,
 * resources can not be serialized or added as an option.
 *
 * You can create options without values and then update the values later.
 * Existing options will not be updated and checks are performed to ensure that you
 * aren't adding a protected WordPress option. Care should be taken to not name
 * options the same as the ones which are protected.
 *
 * @since MU
 *
 * @param int $id A blog ID. Can be null to refer to the current blog.
 * @param string $option Name of option to add. Expected to not be SQL-escaped.
 * @param mixed $value Optional. Option value, can be anything. Expected to not be SQL-escaped.
 * @return bool False if option was not added and true if option was added.
 */
function add_blog_option($id, $option, $value)
{
    $id = (int) $id;
    if (empty($id)) {
        $id = get_current_blog_id();
    }
    if (get_current_blog_id() == $id) {
        return add_option($option, $value);
    }
    switch_to_blog($id);
    $return = add_option($option, $value);
    restore_current_blog();
    return $return;
}