You appear to be a bot. Output may be restricted

Description

Register a setting and its data.

Usage

register_setting( $option_group, $option_name, $args );

Parameters

$option_group

( string ) required – A settings group name. Should correspond to a whitelisted option key name. Default whitelisted option key names include "general," "discussion," and "reading," among others.

$option_name

( string ) required – The name of an option to sanitize and save.

$args

( array ) optional – { Data used to describe the setting when registered.

$type

( string ) optional – The type of data associated with this setting. Valid values are 'string', 'boolean', 'integer', and 'number'.

$description

( string ) optional – A description of the data attached to this setting.

$sanitize_callback

( callable ) optional – A callback function that sanitizes the option's value.

$show_in_rest

( bool ) optional – Whether data associated with this setting should be included in the REST API.

$default

( mixed ) optional – Default value when calling `get_option()`. }

Returns

void

Source

File name: wordpress/wp-includes/option.php
Lines:

function register_setting( $option_group, $option_name, $args = array() ) {
  global $new_whitelist_options, $wp_registered_settings;

  $defaults = array(
    'type'              => 'string',
    'group'             => $option_group,
    'description'       => '',
    'sanitize_callback' => null,
    'show_in_rest'      => false,
  );

  // Back-compat: old sanitize callback is added.
  if ( is_callable( $args ) ) {
    $args = array(
      'sanitize_callback' => $args,
    );
  }

  
/**
 * Filters the registration arguments when registering a setting.
 *
 * @since 4.7.0
 *
 * @param array  $args         Array of setting registration arguments.
 * @param array  $defaults     Array of default arguments.
 * @param string $option_group Setting group.
 * @param string $option_name  Setting name.
 */
  $args = apply_filters( 'register_setting_args', $args, $defaults, $option_group, $option_name );
  $args = wp_parse_args( $args, $defaults );

  if ( ! is_array( $wp_registered_settings ) ) {
    $wp_registered_settings = array();
  }

  if ( 'misc' == $option_group ) {
    _deprecated_argument(
      register_setting,
      '3.0.0',
      sprintf(
        /* translators: %s: misc */
        __( 'The "%s" options group has been removed. Use another settings group.' ),
        'misc'
      )
    );
    $option_group = 'general';
  }

  if ( 'privacy' == $option_group ) {
    _deprecated_argument(
      register_setting,
      '3.5.0',
      sprintf(
        /* translators: %s: privacy */
        __( 'The "%s" options group has been removed. Use another settings group.' ),
        'privacy'
      )
    );
    $option_group = 'reading';
  }

  $new_whitelist_options[ $option_group ][] = $option_name;
  if ( ! empty( $args['sanitize_callback'] ) ) {
    add_filter( "sanitize_option_{$option_name}", $args['sanitize_callback'] );
  }
  if ( array_key_exists( 'default', $args ) ) {
    add_filter( "default_option_{$option_name}", 'filter_default_option',  < 10, 3 );
  }

  $wp_registered_settings[ $option_name ] = $args;
}
 

 View on GitHub View on Trac