W3cubDocs

/WordPress

WP_Customize_Selective_Refresh::add_partial( WP_Customize_Partial|string $id, array $args = array() ): WP_Customize_Partial

Adds a partial.

Description

See also

Parameters

$idWP_Customize_Partial|stringrequired
Customize Partial object, or Partial ID.
$argsarrayoptional
Array of properties for the new Partials object.
See WP_Customize_Partial::__construct() for information on accepted arguments.

Default:array()

Return

WP_Customize_Partial The instance of the partial that was added.

Source

public function add_partial( $id, $args = array() ) {
	if ( $id instanceof WP_Customize_Partial ) {
		$partial = $id;
	} else {
		$class = 'WP_Customize_Partial';

		/** This filter is documented in wp-includes/customize/class-wp-customize-selective-refresh.php */
		$args = apply_filters( 'customize_dynamic_partial_args', $args, $id );

		/** This filter is documented in wp-includes/customize/class-wp-customize-selective-refresh.php */
		$class = apply_filters( 'customize_dynamic_partial_class', $class, $id, $args );

		$partial = new $class( $this, $id, $args );
	}

	$this->partials[ $partial->id ] = $partial;
	return $partial;
}

Hooks

apply_filters( ‘customize_dynamic_partial_args’, false|array $partial_args, string $partial_id )

Filters a dynamic partial’s constructor arguments.

apply_filters( ‘customize_dynamic_partial_class’, string $partial_class, string $partial_id, array $partial_args )

Filters the class used to construct partials.

Changelog

Version Description
4.5.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_selective_refresh/add_partial