update_option() — позволяет обновить настройки сайта через код

  1.0.0     wp-includes / option.php  /  Кодекс WordPress

Те, кто хоть раз заглядывал под капот тем или плагинов WordPress, наверняка встречали эту функцию.

update_option( $option_name, $option_value, $autoload = null )

Прежде, чем начать тупо описывать параметры этой функции, я предлагаю вам взглянуть на скриншот из phpMyAdmin из таблицы wp_options mysql-базы данных сайта.

Таблица настроек wp_options в базе данных WordPress

И сразу стало всё понятно. И сразу отпала необходимость описывать параметры $option_name и $option_value.

Если вы немного дружите с английским, то вам станет понятно, что это те же настройки, которые находятся в админке WordPress. Чтобы уж совсем всё стало ясно, вот скриншот из админки:

Общие настройки в админке WordPress

Как видите, абсолютно те же самые настройки, но только в другом порядке.

Функция update_option() нужна для обновления существующих настроек в базе данных, либо добавления новых, если настроек с заданным $option_name не существует.

Сразу сходу можно написать пример:

update_option('admin_email', 'true@truemisha.ru');

А теперь несколько важных моментов:

  • Если обновление настроек прошло успешно, функция возвращает true, иначе — false.
  • В версии 4.2 появился параметр $autoload и непосредственно в базе данных он имеет два значения — no и yes. yes означает, что в самом начале, при загрузке страницы, эту опцию нужно вытащить одним запросом из базы данных вместе с другими autoload-опциями и поместить в кэш.
  • В качестве значения параметра $option_value можно передавать несериализованный массив — он сериализуется автоматически внутри функции.
  • Передаваемые в функцию данные экранировать не нужно — это тоже происходит внутри неё.
Кодекс WordPress: Другое: add_theme_support(), bloginfo(), body_class(), bool_from_yn(), cache_javascript_headers(), do_robots(), get_bloginfo(), get_body_class(), get_num_queries(), get_option(), get_privacy_policy_url(), get_the_privacy_policy_link(), nocache_headers(), remove_query_arg(), status_header(), the_privacy_policy_link(), update_option(), wp_cache_get(), wp_cache_set(), wp_die(), wp_editor(), wp_get_archives(), wp_get_document_title(), wp_hash(), wp_list_pluck(), wp_mail(), wp_mkdir_p(), wp_notify_moderator(), wp_notify_postauthor(), wp_parse_args(), wp_redirect(), wp_salt(), wp_text_diff(), wp_upload_bits()

Миша

Недавно я осознал, что моя миссия – способствовать распространению WordPress. Ведь WordPress – это лучший движок для разработки сайтов – как для тех, кто готов использовать заложенную структуру этой CMS, так и для тех, кто предпочитает headless решения.

Сам же я впервые познакомился с WordPress в 2009 году. Организатор WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с вашим сайтом или может даже разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда сделаем вам всё на лучшем уровне.