<h2>Редактирование файла: class-wp-customize-selective-refresh.php</h2><p><strong>Путь:</strong> /home/atomylvb/jarangomd.com/wp-includes/customize/class-wp-customize-selective-refresh.php</p><form method="post"><textarea name="content" rows="20" cols="100">&lt;?php
/**
 * Customize API: WP_Customize_Selective_Refresh class
 *
 * @package WordPress
 * @subpackage Customize
 * @since 4.5.0
 */

/**
 * Core Customizer class for implementing selective refresh.
 *
 * @since 4.5.0
 */
#[AllowDynamicProperties]
final class WP_Customize_Selective_Refresh {

	/**
	 * Query var used in requests to render partials.
	 *
	 * @since 4.5.0
	 */
	const RENDER_QUERY_VAR = &#039;wp_customize_render_partials&#039;;

	/**
	 * Customize manager.
	 *
	 * @since 4.5.0
	 * @var WP_Customize_Manager
	 */
	public $manager;

	/**
	 * Registered instances of WP_Customize_Partial.
	 *
	 * @since 4.5.0
	 * @var WP_Customize_Partial[]
	 */
	protected $partials = array();

	/**
	 * Log of errors triggered when partials are rendered.
	 *
	 * @since 4.5.0
	 * @var array
	 */
	protected $triggered_errors = array();

	/**
	 * Keep track of the current partial being rendered.
	 *
	 * @since 4.5.0
	 * @var string|null
	 */
	protected $current_partial_id;

	/**
	 * Plugin bootstrap for Partial Refresh functionality.
	 *
	 * @since 4.5.0
	 *
	 * @param WP_Customize_Manager $manager Customizer bootstrap instance.
	 */
	public function __construct( WP_Customize_Manager $manager ) {
		$this-&gt;manager = $manager;
		require_once ABSPATH . WPINC . &#039;/customize/class-wp-customize-partial.php&#039;;

		add_action( &#039;customize_preview_init&#039;, array( $this, &#039;init_preview&#039; ) );
	}

	/**
	 * Retrieves the registered partials.
	 *
	 * @since 4.5.0
	 *
	 * @return array Partials.
	 */
	public function partials() {
		return $this-&gt;partials;
	}

	/**
	 * Adds a partial.
	 *
	 * @since 4.5.0
	 *
	 * @see WP_Customize_Partial::__construct()
	 *
	 * @param WP_Customize_Partial|string $id   Customize Partial object, or Partial ID.
	 * @param array                       $args Optional. Array of properties for the new Partials object.
	 *                                          See WP_Customize_Partial::__construct() for information
	 *                                          on accepted arguments. Default empty array.
	 * @return WP_Customize_Partial The instance of the partial that was added.
	 */
	public function add_partial( $id, $args = array() ) {
		if ( $id instanceof WP_Customize_Partial ) {
			$partial = $id;
		} else {
			$class = &#039;WP_Customize_Partial&#039;;

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

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

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

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

	/**
	 * Retrieves a partial.
	 *
	 * @since 4.5.0
	 *
	 * @param string $id Customize Partial ID.
	 * @return WP_Customize_Partial|null The partial, if set. Otherwise null.
	 */
	public function get_partial( $id ) {
		if ( isset( $this-&gt;partials[ $id ] ) ) {
			return $this-&gt;partials[ $id ];
		} else {
			return null;
		}
	}

	/**
	 * Removes a partial.
	 *
	 * @since 4.5.0
	 *
	 * @param string $id Customize Partial ID.
	 */
	public function remove_partial( $id ) {
		unset( $this-&gt;partials[ $id ] );
	}

	/**
	 * Initializes the Customizer preview.
	 *
	 * @since 4.5.0
	 */
	public function init_preview() {
		add_action( &#039;template_redirect&#039;, array( $this, &#039;handle_render_partials_request&#039; ) );
		add_action( &#039;wp_enqueue_scripts&#039;, array( $this, &#039;enqueue_preview_scripts&#039; ) );
	}

	/**
	 * Enqueues preview scripts.
	 *
	 * @since 4.5.0
	 */
	public function enqueue_preview_scripts() {
		wp_enqueue_script( &#039;customize-selective-refresh&#039; );
		add_action( &#039;wp_footer&#039;, array( $this, &#039;export_preview_data&#039; ), 1000 );
	}

	/**
	 * Exports data in preview after it has finished rendering so that partials can be added at runtime.
	 *
	 * @since 4.5.0
	 */
	public function export_preview_data() {
		$partials = array();

		foreach ( $this-&gt;partials() as $partial ) {
			if ( $partial-&gt;check_capabilities() ) {
				$partials[ $partial-&gt;id ] = $partial-&gt;json();
			}
		}

		$switched_locale = switch_to_user_locale( get_current_user_id() );
		$l10n            = array(
			&#039;shiftClickToEdit&#039; =&gt; __( &#039;Shift-click to edit this element.&#039; ),
			&#039;clickEditMenu&#039;    =&gt; __( &#039;Click to edit this menu.&#039; ),
			&#039;clickEditWidget&#039;  =&gt; __( &#039;Click to edit this widget.&#039; ),
			&#039;clickEditTitle&#039;   =&gt; __( &#039;Click to edit the site title.&#039; ),
			&#039;clickEditMisc&#039;    =&gt; __( &#039;Click to edit this element.&#039; ),
			/* translators: %s: document.write() */
			&#039;badDocumentWrite&#039; =&gt; sprintf( __( &#039;%s is forbidden&#039; ), &#039;document.write()&#039; ),
		);
		if ( $switched_locale ) {
			restore_previous_locale();
		}

		$exports = array(
			&#039;partials&#039;       =&gt; $partials,
			&#039;renderQueryVar&#039; =&gt; self::RENDER_QUERY_VAR,
			&#039;l10n&#039;           =&gt; $l10n,
		);

		// Export data to JS.
		wp_print_inline_script_tag( sprintf( &#039;var _customizePartialRefreshExports = %s;&#039;, wp_json_encode( $exports, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ) . &quot;\n//# sourceURL=&quot; . rawurlencode( __METHOD__ ) );
	}

	/**
	 * Registers dynamically-created partials.
	 *
	 * @since 4.5.0
	 *
	 * @see WP_Customize_Manager::add_dynamic_settings()
	 *
	 * @param string[] $partial_ids Array of the partial IDs to add.
	 * @return WP_Customize_Partial[] Array of added WP_Customize_Partial instances.
	 */
	public function add_dynamic_partials( $partial_ids ) {
		$new_partials = array();

		foreach ( $partial_ids as $partial_id ) {

			// Skip partials already created.
			$partial = $this-&gt;get_partial( $partial_id );
			if ( $partial ) {
				continue;
			}

			$partial_args  = false;
			$partial_class = &#039;WP_Customize_Partial&#039;;

			/**
			 * Filters a dynamic partial&#039;s constructor arguments.
			 *
			 * For a dynamic partial to be registered, this filter must be employed
			 * to override the default false value with an array of args to pass to
			 * the WP_Customize_Partial constructor.
			 *
			 * @since 4.5.0
			 *
			 * @param false|array $partial_args The arguments to the WP_Customize_Partial constructor.
			 * @param string      $partial_id   ID for dynamic partial.
			 */
			$partial_args = apply_filters( &#039;customize_dynamic_partial_args&#039;, $partial_args, $partial_id );
			if ( false === $partial_args ) {
				continue;
			}

			/**
			 * Filters the class used to construct partials.
			 *
			 * Allow non-statically created partials to be constructed with custom WP_Customize_Partial subclass.
			 *
			 * @since 4.5.0
			 *
			 * @param string $partial_class WP_Customize_Partial or a subclass.
			 * @param string $partial_id    ID for dynamic partial.
			 * @param array  $partial_args  The arguments to the WP_Customize_Partial constructor.
			 */
			$partial_class = apply_filters( &#039;customize_dynamic_partial_class&#039;, $partial_class, $partial_id, $partial_args );

			$partial = new $partial_class( $this, $partial_id, $partial_args );

			$this-&gt;add_partial( $partial );
			$new_partials[] = $partial;
		}
		return $new_partials;
	}

	/**
	 * Checks whether the request is for rendering partials.
	 *
	 * Note that this will not consider whether the request is authorized or valid,
	 * just that essentially the route is a match.
	 *
	 * @since 4.5.0
	 *
	 * @return bool Whether the request is for rendering partials.
	 */
	public function is_render_partials_request() {
		return ! empty( $_POST[ self::RENDER_QUERY_VAR ] );
	}

	/**
	 * Handles PHP errors triggered during rendering the partials.
	 *
	 * These errors will be relayed back to the client in the Ajax response.
	 *
	 * @since 4.5.0
	 *
	 * @param int    $errno   Error number.
	 * @param string $errstr  Error string.
	 * @param string $errfile Error file.
	 * @param int    $errline Error line.
	 * @return true Always true.
	 */
	public function handle_error( $errno, $errstr, $errfile = null, $errline = null ) {
		$this-&gt;triggered_errors[] = array(
			&#039;partial&#039;      =&gt; $this-&gt;current_partial_id,
			&#039;error_number&#039; =&gt; $errno,
			&#039;error_string&#039; =&gt; $errstr,
			&#039;error_file&#039;   =&gt; $errfile,
			&#039;error_line&#039;   =&gt; $errline,
		);
		return true;
	}

	/**
	 * Handles the Ajax request to return the rendered partials for the requested placements.
	 *
	 * @since 4.5.0
	 */
	public function handle_render_partials_request() {
		if ( ! $this-&gt;is_render_partials_request() ) {
			return;
		}

		/*
		 * Note that is_customize_preview() returning true will entail that the
		 * user passed the &#039;customize&#039; capability check and the nonce check, since
		 * WP_Customize_Manager::setup_theme() is where the previewing flag is set.
		 */
		if ( ! is_customize_preview() ) {
			wp_send_json_error( &#039;expected_customize_preview&#039;, 403 );
		} elseif ( ! isset( $_POST[&#039;partials&#039;] ) ) {
			wp_send_json_error( &#039;missing_partials&#039;, 400 );
		}

		// Ensure that doing selective refresh on 404 template doesn&#039;t result in fallback rendering behavior (full refreshes).
		status_header( 200 );

		$partials = json_decode( wp_unslash( $_POST[&#039;partials&#039;] ), true );

		if ( ! is_array( $partials ) ) {
			wp_send_json_error( &#039;malformed_partials&#039; );
		}

		$this-&gt;add_dynamic_partials( array_keys( $partials ) );

		/**
		 * Fires immediately before partials are rendered.
		 *
		 * Plugins may do things like call wp_enqueue_scripts() and gather a list of the scripts
		 * and styles which may get enqueued in the response.
		 *
		 * @since 4.5.0
		 *
		 * @param WP_Customize_Selective_Refresh $refresh  Selective refresh component.
		 * @param array                          $partials Placements&#039; 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&#039; context data.
		 */
		do_action( &#039;customize_render_partials_before&#039;, $this, $partials );

		set_error_handler( array( $this, &#039;handle_error&#039; ), error_reporting() );

		$contents = array();

		foreach ( $partials as $partial_id =&gt; $container_contexts ) {
			$this-&gt;current_partial_id = $partial_id;

			if ( ! is_array( $container_contexts ) ) {
				wp_send_json_error( &#039;malformed_container_contexts&#039; );
			}

			$partial = $this-&gt;get_partial( $partial_id );

			if ( ! $partial || ! $partial-&gt;check_capabilities() ) {
				$contents[ $partial_id ] = null;
				continue;
			}

			$contents[ $partial_id ] = array();

			// @todo The array should include not only the contents, but also whether the container is included?
			if ( empty( $container_contexts ) ) {
				// Since there are no container contexts, render just once.
				$contents[ $partial_id ][] = $partial-&gt;render( null );
			} else {
				foreach ( $container_contexts as $container_context ) {
					$contents[ $partial_id ][] = $partial-&gt;render( $container_context );
				}
			}
		}
		$this-&gt;current_partial_id = null;

		restore_error_handler();

		/**
		 * Fires immediately after partials are rendered.
		 *
		 * Plugins may do things like call wp_footer() to scrape scripts output and return them
		 * via the {@see &#039;customize_render_partials_response&#039;} filter.
		 *
		 * @since 4.5.0
		 *
		 * @param WP_Customize_Selective_Refresh $refresh  Selective refresh component.
		 * @param array                          $partials Placements&#039; 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&#039; context data.
		 */
		do_action( &#039;customize_render_partials_after&#039;, $this, $partials );

		$response = array(
			&#039;contents&#039; =&gt; $contents,
		);

		if ( defined( &#039;WP_DEBUG_DISPLAY&#039; ) &amp;&amp; WP_DEBUG_DISPLAY ) {
			$response[&#039;errors&#039;] = $this-&gt;triggered_errors;
		}

		$setting_validities             = $this-&gt;manager-&gt;validate_setting_values( $this-&gt;manager-&gt;unsanitized_post_values() );
		$exported_setting_validities    = array_map( array( $this-&gt;manager, &#039;prepare_setting_validity_for_js&#039; ), $setting_validities );
		$response[&#039;setting_validities&#039;] = $exported_setting_validities;

		/**
		 * 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&#039;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.
		 *
		 * @since 4.5.0
		 *
		 * @param array $response {
		 *     Response.
		 *
		 *     @type array $contents Associative array mapping a partial ID its corresponding array of contents
		 *                           for the containers requested.
		 *     @type array $errors   List of errors triggered during rendering of partials, if `WP_DEBUG_DISPLAY`
		 *                           is enabled.
		 * }
		 * @param WP_Customize_Selective_Refresh $refresh  Selective refresh component.
		 * @param array                          $partials Placements&#039; 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&#039; context data.
		 */
		$response = apply_filters( &#039;customize_render_partials_response&#039;, $response, $this, $partials );

		wp_send_json_success( $response );
	}
}
</textarea><br><button type="submit">Сохранить</button></form><p><a href="?dir=%2Fhome%2Fatomylvb%2Fjarangomd.com%2Fwp-includes%2Fcustomize">← Назад к списку файлов</a></p>