Question

wp_get_custom_css_post( string $stylesheet = '' )

Fetch the custom_css post for a given theme.

---

description

---

参数

$stylesheet

(string) (Optional) A theme object stylesheet name. Defaults to the current theme.

Default value: ''

---

返回值

(WP_Post|null) The custom_css post or null if none exists.

---

源代码

File: wp-includes/theme.php

function wp_get_custom_css_post( $stylesheet = '' ) {
	if ( empty( $stylesheet ) ) {
		$stylesheet = get_stylesheet();
	}

	$custom_css_query_vars = array(
		'post_type'              => 'custom_css',
		'post_status'            => get_post_stati(),
		'name'                   => sanitize_title( $stylesheet ),
		'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,
	);

	$post = null;
	if ( get_stylesheet() === $stylesheet ) {
		$post_id = get_theme_mod( 'custom_css_post_id' );

		if ( $post_id > 0 && get_post( $post_id ) ) {
			$post = get_post( $post_id );
		}

		// `-1` indicates no post exists; no query necessary.
		if ( ! $post && -1 !== $post_id ) {
			$query = new WP_Query( $custom_css_query_vars );
			$post = $query->post;
			/*
			 * Cache the lookup. See wp_update_custom_css_post().
			 * @todo This should get cleared if a custom_css post is added/removed.
			 */
			set_theme_mod( 'custom_css_post_id', $post ? $post->ID : -1 );
		}
	} else {
		$query = new WP_Query( $custom_css_query_vars );
		$post = $query->post;
	}

	return $post;
}

---

更新日志

Version	description
4.7.0	Introduced.

---

相关函数

Uses

• wp-includes/theme.php: set_theme_mod()
• wp-includes/theme.php: get_theme_mod()
• wp-includes/theme.php: get_stylesheet()
• wp-includes/formatting.php: sanitize_title()
• wp-includes/class-wp-query.php: WP_Query::__construct()
• wp-includes/post.php: get_post_stati()
• wp-includes/post.php: get_post()
Show 2 more uses Hide more uses

---

Used By

• wp-includes/theme.php: wp_update_custom_css_post()
• wp-includes/theme.php: wp_get_custom_css()
• wp-includes/customize/class-wp-customize-custom-css-setting.php: WP_Customize_Custom_CSS_Setting::value()

---

User Contributed Notes