WP_Customize_Manager::check_changeset_lock_with_heartbeat( array $response, array $data, string $screen_id ): array

In this article

Checks locked changeset with heartbeat API.

Parameters

$responsearrayrequired
The Heartbeat response.
$dataarrayrequired
The $_POST data sent.
$screen_idstringrequired
The screen id.

Return

array The Heartbeat response.

Source

public function check_changeset_lock_with_heartbeat( $response, $data, $screen_id ) {
	if ( isset( $data['changeset_uuid'] ) ) {
		$changeset_post_id = $this->find_changeset_post_id( $data['changeset_uuid'] );
	} else {
		$changeset_post_id = $this->changeset_post_id();
	}

	if (
		array_key_exists( 'check_changeset_lock', $data )
		&& 'customize' === $screen_id
		&& $changeset_post_id
		&& current_user_can( get_post_type_object( 'customize_changeset' )->cap->edit_post, $changeset_post_id )
	) {
		$lock_user_id = wp_check_post_lock( $changeset_post_id );

		if ( $lock_user_id ) {
			$response['customize_changeset_lock_user'] = $this->get_lock_user_data( $lock_user_id );
		} else {

			// Refreshing time will ensure that the user is sitting on customizer and has not closed the customizer tab.
			$this->refresh_changeset_lock( $changeset_post_id );
		}
	}

	return $response;
}

Changelog

VersionDescription
4.9.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.