Yoast_Network_Settings_API::register_setting()publicYoast 1.0

Registers a network setting and its data.

Метод класса: Yoast_Network_Settings_API{}

Хуков нет.

Возвращает

null. Ничего (null).

Использование

$Yoast_Network_Settings_API = new Yoast_Network_Settings_API();
$Yoast_Network_Settings_API->register_setting( $option_group, $option_name, $args );
$option_group(строка) (обязательный)
The group the network option is part of.
$option_name(строка) (обязательный)
The name of the network option to sanitize and save.
$args(массив)

Data used to describe the network setting when registered.

По умолчанию: []

  • sanitize_callback(callable)
    A callback function that sanitizes the network option's value.

  • default(разное)
    Default value when calling get_network_option().

Код Yoast_Network_Settings_API::register_setting() Yoast 24.7

public function register_setting( $option_group, $option_name, $args = [] ) {

	$defaults = [
		'group'             => $option_group,
		'sanitize_callback' => null,
	];
	$args     = wp_parse_args( $args, $defaults );

	if ( ! isset( $this->whitelist_options[ $option_group ] ) ) {
		$this->whitelist_options[ $option_group ] = [];
	}

	$this->whitelist_options[ $option_group ][] = $option_name;

	if ( ! empty( $args['sanitize_callback'] ) ) {
		add_filter( "sanitize_option_{$option_name}", [ $this, 'filter_sanitize_option' ], 10, 2 );
	}

	if ( array_key_exists( 'default', $args ) ) {
		add_filter( "default_site_option_{$option_name}", [ $this, 'filter_default_option' ], 10, 2 );
	}

	$this->registered_settings[ $option_name ] = $args;
}