WordPress at a glance
filter is not described

customize_render_partials_response filter-hook . WP 4.5.0

Filters the response from rendering the partials.

Plugins may use this filter to inject $scripts and $styles, which are dependencies for the partials being rendered. The response data will be available to the client via the render-partials-response JS event, so the client can then inject the scripts and styles into the DOM if they have not already been enqueued there.

If plugins do this, they'll need to take care for any scripts that do document.write() and make sure that these are not injected, or else to override the function to no-op, or else the page will be destroyed.

Plugins should be aware that $scripts and $styles may eventually be included by default in the response.

Usage

add_filter( 'customize_render_partials_response', 'filter_function_name_4621', 10, 3 );
function filter_function_name_4621( $response, $this, $partials ){
	// filter...

	return $response;
}
$response(array)

Response.

  • $contents (array)
    Associative array mapping a partial ID its corresponding array of contents for the containers requested.

  • $errors (array)
    List of errors triggered during rendering of partials, if WP_DEBUG_DISPLAY is enabled.
$this(WP_Customize_Selective_Refresh)
Selective refresh component.
$partials(array)
Placements' context data for the partials rendered in the request. The array is keyed by partial ID, with each item being an array of the placements' context data.

Where the hook is called

WP_Customize_Selective_Refresh::handle_render_partials_request()
customize_render_partials_response
wp-includes/customize/class-wp-customize-selective-refresh.php 452
$response = apply_filters( 'customize_render_partials_response', $response, $this, $partials );

Where the hook is used (in WP core)

wp-includes/class-wp-customize-nav-menus.php 1181
add_filter( 'customize_render_partials_response', array( $this, 'export_partial_rendered_nav_menu_instances' ) );
wp-includes/class-wp-customize-manager.php 398
add_filter( 'customize_render_partials_response', array( $this, 'export_header_video_settings' ), 10, 3 );