WP_Customize_Manager::find_changeset_post_id( string $uuid ): int|null

In this article

Finds the changeset post ID for a given changeset UUID.

Parameters

$uuidstringrequired
Changeset UUID.

Return

int|null Returns post ID on success and null on failure.

Source

public function find_changeset_post_id( $uuid ) {
	$cache_group       = 'customize_changeset_post';
	$changeset_post_id = wp_cache_get( $uuid, $cache_group );
	if ( $changeset_post_id && 'customize_changeset' === get_post_type( $changeset_post_id ) ) {
		return $changeset_post_id;
	}

	$changeset_post_query = new WP_Query(
		array(
			'post_type'              => 'customize_changeset',
			'post_status'            => get_post_stati(),
			'name'                   => $uuid,
			'posts_per_page'         => 1,
			'no_found_rows'          => true,
			'cache_results'          => true,
			'update_post_meta_cache' => false,
			'update_post_term_cache' => false,
			'lazy_load_term_meta'    => false,
		)
	);
	if ( ! empty( $changeset_post_query->posts ) ) {
		// Note: 'fields'=>'ids' is not being used in order to cache the post object as it will be needed.
		$changeset_post_id = $changeset_post_query->posts[0]->ID;
		wp_cache_set( $uuid, $changeset_post_id, $cache_group );
		return $changeset_post_id;
	}

	return null;
}

Changelog

VersionDescription
4.7.0Introduced.

User Contributed Notes

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