19

var/www/html/wordpress_bak/wp-includes | uid:33

post-thumbnail-template.php [X]

<?php
/**
 * WordPress Post Thumbnail Template Functions.
 *
 * Support for post thumbnails.
 * Theme's functions.php must call add_theme_support( 'post-thumbnails' ) to use these.
 *
 * @package WordPress
 * @subpackage Template
 */

/**
 * Determines whether a post has an image attached.
 *
 * For more information on this and similar theme functions, check out
 * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
 * Conditional Tags} article in the Theme Developer Handbook.
 *
 * @since 2.9.0
 * @since 4.4.0 `$post` can be a post ID or WP_Post object.
 *
 * @param int|WP_Post|null $post Optional. Post ID or WP_Post object. Default is global `$post`.
 * @return bool Whether the post has an image attached.
 */
function has_post_thumbnail( $post = null ) {
	$thumbnail_id  = get_post_thumbnail_id( $post );
	$has_thumbnail = (bool) $thumbnail_id;

/**
	 * Filters whether a post has a post thumbnail.
	 *
	 * @since 5.1.0
	 *
	 * @param bool             $has_thumbnail true if the post has a post thumbnail, otherwise false.
	 * @param int|WP_Post|null $post          Post ID or WP_Post object. Default is global `$post`.
	 * @param int|false        $thumbnail_id  Post thumbnail ID or false if the post does not exist.
	 */
	return (bool) apply_filters( 'has_post_thumbnail', $has_thumbnail, $post, $thumbnail_id );
}

/**
 * Retrieves the post thumbnail ID.
 *
 * @since 2.9.0
 * @since 4.4.0 `$post` can be a post ID or WP_Post object.
 * @since 5.5.0 The return value for a non-existing post
 *              was changed to false instead of an empty string.
 *
 * @param int|WP_Post|null $post Optional. Post ID or WP_Post object. Default is global `$post`.
 * @return int|false Post thumbnail ID (which can be 0 if the thumbnail is not set),
 *                   or false if the post does not exist.
 */
function get_post_thumbnail_id( $post = null ) {
	$post = get_post( $post );

if ( ! $post ) {
		return false;
	}

$thumbnail_id = (int) get_post_meta( $post->ID, '_thumbnail_id', true );

/**
	 * Filters the post thumbnail ID.
	 *
	 * @since 5.9.0
	 *
	 * @param int|false        $thumbnail_id Post thumbnail ID or false if the post does not exist.
	 * @param int|WP_Post|null $post         Post ID or WP_Post object. Default is global `$post`.
	 */
	return (int) apply_filters( 'post_thumbnail_id', $thumbnail_id, $post );
}

/**
 * Displays the post thumbnail.
 *
 * When a theme adds 'post-thumbnail' support, a special 'post-thumbnail' image size
 * is registered, which differs from the 'thumbnail' image size managed via the
 * Settings > Media screen.
 *
 * When using the_post_thumbnail() or related functions, the 'post-thumbnail' image
 * size is used by default, though a different size can be specified instead as needed.
 *
 * @since 2.9.0
 *
 * @see get_the_post_thumbnail()
 *
 * @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array of
 *                           width and height values in pixels (in that order). Default 'post-thumbnail'.
 * @param string|array $attr Optional. Query string or array of attributes. Default empty.
 */
function the_post_thumbnail( $size = 'post-thumbnail', $attr = '' ) {
	echo get_the_post_thumbnail( null, $size, $attr );
}

/**
 * Updates cache for thumbnails in the current loop.
 *
 * @since 3.2.0
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param WP_Query|null $wp_query Optional. A WP_Query instance. Defaults to the $wp_query global.
 */
function update_post_thumbnail_cache( $wp_query = null ) {
	if ( ! $wp_query ) {
		$wp_query = $GLOBALS['wp_query'];
	}

if ( $wp_query->thumbnails_cached ) {
		return;
	}

$thumb_ids = array();

/*
	 * $wp_query may contain an array of post objects or post IDs.
	 *
	 * This ensures the cache is primed for all post objects to avoid
	 * `get_post()` calls in `get_the_post_thumbnail()` triggering an
	 * additional database call for each post.
	 */
	$parent_post_ids = array();
	foreach ( $wp_query->posts as $post ) {
		if ( $post instanceof WP_Post ) {
			$parent_post_ids[] = $post->ID;
		} elseif ( is_int( $post ) ) {
			$parent_post_ids[] = $post;
		}
	}
	_prime_post_caches( $parent_post_ids, false, true );

foreach ( $wp_query->posts as $post ) {
		$id = get_post_thumbnail_id( $post );
		if ( $id ) {
			$thumb_ids[] = $id;
		}
	}

if ( ! empty( $thumb_ids ) ) {
		_prime_post_caches( $thumb_ids, false, true );
	}

$wp_query->thumbnails_cached = true;
}

/**
 * Retrieves the post thumbnail.
 *
 * When a theme adds 'post-thumbnail' support, a special 'post-thumbnail' image size
 * is registered, which differs from the 'thumbnail' image size managed via the
 * Settings > Media screen.
 *
 * When using the_post_thumbnail() or related functions, the 'post-thumbnail' image
 * size is used by default, though a different size can be specified instead as needed.
 *
 * @since 2.9.0
 * @since 4.4.0 `$post` can be a post ID or WP_Post object.
 *
 * @param int|WP_Post|null $post Optional. Post ID or WP_Post object.  Default is global `$post`.
 * @param string|int[]     $size Optional. Image size. Accepts any registered image size name, or an array of
 *                               width and height values in pixels (in that order). Default 'post-thumbnail'.
 * @param string|array     $attr Optional. Query string or array of attributes. Default empty.
 * @return string The post thumbnail image tag.
 */
function get_the_post_thumbnail( $post = null, $size = 'post-thumbnail', $attr = '' ) {
	$post = get_post( $post );

if ( ! $post ) {
		return '';
	}

$post_thumbnail_id = get_post_thumbnail_id( $post );

/**
	 * Filters the post thumbnail size.
	 *
	 * @since 2.9.0
	 * @since 4.9.0 Added the `$post_id` parameter.
	 *
	 * @param string|int[] $size    Requested image size. Can be any registered image size name, or
	 *                              an array of width and height values in pixels (in that order).
	 * @param int          $post_id The post ID.
	 */
	$size = apply_filters( 'post_thumbnail_size', $size, $post->ID );

if ( $post_thumbnail_id ) {

/**
		 * Fires before fetching the post thumbnail HTML.
		 *
		 * Provides "just in time" filtering of all filters in wp_get_attachment_image().
		 *
		 * @since 2.9.0
		 *
		 * @param int          $post_id           The post ID.
		 * @param int          $post_thumbnail_id The post thumbnail ID.
		 * @param string|int[] $size              Requested image size. Can be any registered image size name, or
		 *                                        an array of width and height values in pixels (in that order).
		 */
		do_action( 'begin_fetch_post_thumbnail_html', $post->ID, $post_thumbnail_id, $size );

if ( in_the_loop() ) {
			update_post_thumbnail_cache();
		}

$html = wp_get_attachment_image( $post_thumbnail_id, $size, false, $attr );

/**
		 * Fires after fetching the post thumbnail HTML.
		 *
		 * @since 2.9.0
		 *
		 * @param int          $post_id           The post ID.
		 * @param int          $post_thumbnail_id The post thumbnail ID.
		 * @param string|int[] $size              Requested image size. Can be any registered image size name, or
		 *                                        an array of width and height values in pixels (in that order).
		 */
		do_action( 'end_fetch_post_thumbnail_html', $post->ID, $post_thumbnail_id, $size );

} else {
		$html = '';
	}

/**
	 * Filters the post thumbnail HTML.
	 *
	 * @since 2.9.0
	 *
	 * @param string       $html              The post thumbnail HTML.
	 * @param int          $post_id           The post ID.
	 * @param int          $post_thumbnail_id The post thumbnail ID, or 0 if there isn't one.
	 * @param string|int[] $size              Requested image size. Can be any registered image size name, or
	 *                                        an array of width and height values in pixels (in that order).
	 * @param string|array $attr              Query string or array of attributes.
	 */
	return apply_filters( 'post_thumbnail_html', $html, $post->ID, $post_thumbnail_id, $size, $attr );
}

/**
 * Returns the post thumbnail URL.
 *
 * @since 4.4.0
 *
 * @param int|WP_Post|null $post Optional. Post ID or WP_Post object.  Default is global `$post`.
 * @param string|int[]     $size Optional. Registered image size to retrieve the source for or a flat array
 *                               of height and width dimensions. Default 'post-thumbnail'.
 * @return string|false Post thumbnail URL or false if no image is available. If `$size` does not match
 *                      any registered image size, the original image URL will be returned.
 */
function get_the_post_thumbnail_url( $post = null, $size = 'post-thumbnail' ) {
	$post_thumbnail_id = get_post_thumbnail_id( $post );

if ( ! $post_thumbnail_id ) {
		return false;
	}

$thumbnail_url = wp_get_attachment_image_url( $post_thumbnail_id, $size );

/**
	 * Filters the post thumbnail URL.
	 *
	 * @since 5.9.0
	 *
	 * @param string|false     $thumbnail_url Post thumbnail URL or false if the post does not exist.
	 * @param int|WP_Post|null $post          Post ID or WP_Post object. Default is global `$post`.
	 * @param string|int[]     $size          Registered image size to retrieve the source for or a flat array
	 *                                        of height and width dimensions. Default 'post-thumbnail'.
	 */
	return apply_filters( 'post_thumbnail_url', $thumbnail_url, $post, $size );
}

/**
 * Displays the post thumbnail URL.
 *
 * @since 4.4.0
 *
 * @param string|int[] $size Optional. Image size to use. Accepts any valid image size,
 *                           or an array of width and height values in pixels (in that order).
 *                           Default 'post-thumbnail'.
 */
function the_post_thumbnail_url( $size = 'post-thumbnail' ) {
	$url = get_the_post_thumbnail_url( null, $size );

if ( $url ) {
		echo esc_url( $url );
	}
}

/**
 * Returns the post thumbnail caption.
 *
 * @since 4.6.0
 *
 * @param int|WP_Post|null $post Optional. Post ID or WP_Post object. Default is global `$post`.
 * @return string Post thumbnail caption.
 */
function get_the_post_thumbnail_caption( $post = null ) {
	$post_thumbnail_id = get_post_thumbnail_id( $post );

if ( ! $post_thumbnail_id ) {
		return '';
	}

$caption = wp_get_attachment_caption( $post_thumbnail_id );

if ( ! $caption ) {
		$caption = '';
	}

return $caption;
}

/**
 * Displays the post thumbnail caption.
 *
 * @since 4.6.0
 *
 * @param int|WP_Post|null $post Optional. Post ID or WP_Post object. Default is global `$post`.
 */
function the_post_thumbnail_caption( $post = null ) {
	/**
	 * Filters the displayed post thumbnail caption.
	 *
	 * @since 4.6.0
	 *
	 * @param string $caption Caption for the given attachment.
	 */
	echo apply_filters( 'the_post_thumbnail_caption', get_the_post_thumbnail_caption( $post ) );
}

abilities-api/	-	O R D
assets/	-	O R D
block-bindings/	-	O R D
block-patterns/	-	O R D
block-supports/	-	O R D
blocks/	-	O R D
certificates/	-	O R D
css/	-	O R D
customize/	-	O R D
fonts/	-	O R D
html-api/	-	O R D
ID3/	-	O R D
images/	-	O R D
interactivity-api/	-	O R D
IXR/	-	O R D
js/	-	O R D
l10n/	-	O R D
php-compat/	-	O R D
PHPMailer/	-	O R D
pomo/	-	O R D
Requests/	-	O R D
rest-api/	-	O R D
SimplePie/	-	O R D
sitemaps/	-	O R D
sodium_compat/	-	O R D
style-engine/	-	O R D
Text/	-	O R D
theme-compat/	-	O R D
widgets/	-	O R D
abilities-api.php	23.8K	V E R D
abilities.php	7.8K	V E R D
admin-bar.php	36.1K	V E R D
atomlib.php	11.9K	V E R D
author-template.php	18.9K	V E R D
block-bindings.php	7.3K	V E R D
block-editor.php	28.6K	V E R D
block-i18n.json	316	V E R D
block-patterns.php	12.9K	V E R D
block-template-utils.php	61K	V E R D
block-template.php	15K	V E R D
blocks.php	112K	V E R D
bookmark-template.php	12.5K	V E R D
bookmark.php	15.1K	V E R D
cache-compat.php	9.8K	V E R D
cache.php	13.2K	V E R D
canonical.php	33.8K	V E R D
capabilities.php	42.6K	V E R D
category-template.php	55.7K	V E R D
category.php	12.5K	V E R D
class-avif-info.php	28.9K	V E R D
class-feed.php	539	V E R D
class-http.php	367	V E R D
class-IXR.php	2.6K	V E R D
class-json.php	42.7K	V E R D
class-oembed.php	401	V E R D
class-phpass.php	6.6K	V E R D
class-phpmailer.php	664	V E R D
class-pop3.php	20.6K	V E R D
class-requests.php	2.2K	V E R D
class-simplepie.php	453	V E R D
class-smtp.php	457	V E R D
class-snoopy.php	36.8K	V E R D
class-walker-category-dropdown.php	2.4K	V E R D
class-walker-category.php	8.3K	V E R D
class-walker-comment.php	13.9K	V E R D
class-walker-nav-menu.php	11.8K	V E R D
class-walker-page-dropdown.php	2.6K	V E R D
class-walker-page.php	7.4K	V E R D
class-wp-admin-bar.php	17.5K	V E R D
class-wp-ajax-response.php	5.1K	V E R D
class-wp-application-passwords.php	16.7K	V E R D
class-wp-block-bindings-registry.php	8.3K	V E R D
class-wp-block-bindings-source.php	2.9K	V E R D
class-wp-block-editor-context.php	1.3K	V E R D
class-wp-block-list.php	4.6K	V E R D
class-wp-block-metadata-registry.php	11.6K	V E R D
class-wp-block-parser-block.php	2.5K	V E R D
class-wp-block-parser-frame.php	2K	V E R D
class-wp-block-parser.php	11.2K	V E R D
class-wp-block-pattern-categories-registry.php	5.3K	V E R D
class-wp-block-patterns-registry.php	11K	V E R D
class-wp-block-processor.php	68.3K	V E R D
class-wp-block-styles-registry.php	6.3K	V E R D
class-wp-block-supports.php	5.5K	V E R D
class-wp-block-template.php	2K	V E R D
class-wp-block-templates-registry.php	7K	V E R D
class-wp-block-type-registry.php	4.9K	V E R D
class-wp-block-type.php	16.9K	V E R D
class-wp-block.php	24.2K	V E R D
class-wp-classic-to-block-menu-converter.php	4K	V E R D
class-wp-comment-query.php	47.7K	V E R D
class-wp-comment.php	9.2K	V E R D
class-wp-customize-control.php	25.5K	V E R D
class-wp-customize-manager.php	198.4K	V E R D
class-wp-customize-nav-menus.php	56.7K	V E R D
class-wp-customize-panel.php	10.5K	V E R D
class-wp-customize-section.php	10.9K	V E R D
class-wp-customize-setting.php	29.3K	V E R D
class-wp-customize-widgets.php	70.9K	V E R D
class-wp-date-query.php	35.3K	V E R D
class-wp-dependencies.php	16.6K	V E R D
class-wp-dependency.php	2.6K	V E R D
class-wp-duotone.php	39.8K	V E R D
class-wp-editor.php	70.6K	V E R D
class-wp-embed.php	15.6K	V E R D
class-wp-error.php	7.3K	V E R D
class-wp-exception.php	253	V E R D
class-wp-fatal-error-handler.php	8K	V E R D
class-wp-feed-cache-transient.php	3.2K	V E R D
class-wp-feed-cache.php	969	V E R D
class-wp-hook.php	16.3K	V E R D
class-wp-http-cookie.php	7.2K	V E R D
class-wp-http-curl.php	13K	V E R D
class-wp-http-encoding.php	6.5K	V E R D
class-wp-http-ixr-client.php	3.4K	V E R D
class-wp-http-proxy.php	5.8K	V E R D
class-wp-http-requests-hooks.php	2K	V E R D
class-wp-http-requests-response.php	4.3K	V E R D
class-wp-http-response.php	2.9K	V E R D
class-wp-http-streams.php	16.5K	V E R D
class-wp-http.php	40.6K	V E R D
class-wp-image-editor-gd.php	20.2K	V E R D
class-wp-image-editor-imagick.php	36.1K	V E R D
class-wp-image-editor.php	17K	V E R D
class-wp-list-util.php	7.3K	V E R D
class-wp-locale-switcher.php	6.6K	V E R D
class-wp-locale.php	16.5K	V E R D
class-wp-matchesmapregex.php	1.8K	V E R D
class-wp-meta-query.php	29.8K	V E R D
class-wp-metadata-lazyloader.php	6.7K	V E R D
class-wp-navigation-fallback.php	9K	V E R D
class-wp-network-query.php	19.4K	V E R D
class-wp-network.php	12K	V E R D
class-wp-object-cache.php	17.1K	V E R D
class-wp-oembed-controller.php	6.7K	V E R D
class-wp-oembed.php	30.9K	V E R D
class-wp-paused-extensions-storage.php	5K	V E R D
class-wp-phpmailer.php	4.2K	V E R D
class-wp-plugin-dependencies.php	24.7K	V E R D
class-wp-post-type.php	30K	V E R D
class-wp-post.php	6.3K	V E R D
class-wp-query.php	159.9K	V E R D
class-wp-recovery-mode-cookie-service.php	6.7K	V E R D
class-wp-recovery-mode-email-service.php	10.9K	V E R D
class-wp-recovery-mode-key-service.php	4.8K	V E R D
class-wp-recovery-mode-link-service.php	3.4K	V E R D
class-wp-recovery-mode.php	11.2K	V E R D
class-wp-rewrite.php	62.2K	V E R D
class-wp-role.php	2.5K	V E R D
class-wp-roles.php	9.2K	V E R D
class-wp-script-modules.php	32.1K	V E R D
class-wp-scripts.php	34K	V E R D
class-wp-session-tokens.php	7.1K	V E R D
class-wp-simplepie-file.php	3.5K	V E R D
class-wp-simplepie-sanitize-kses.php	1.9K	V E R D
class-wp-site-query.php	30.9K	V E R D
class-wp-site.php	7.3K	V E R D
class-wp-speculation-rules.php	7.4K	V E R D
class-wp-styles.php	12.5K	V E R D
class-wp-tax-query.php	19.1K	V E R D
class-wp-taxonomy.php	18.1K	V E R D
class-wp-term-query.php	40K	V E R D
class-wp-term.php	5.2K	V E R D
class-wp-text-diff-renderer-inline.php	979	V E R D
class-wp-text-diff-renderer-table.php	18.4K	V E R D
class-wp-textdomain-registry.php	10.2K	V E R D
class-wp-theme-json-data.php	1.8K	V E R D
class-wp-theme-json-resolver.php	34.9K	V E R D
class-wp-theme-json-schema.php	7.2K	V E R D
class-wp-theme-json.php	160.5K	V E R D
class-wp-theme.php	64.3K	V E R D
class-wp-token-map.php	27.9K	V E R D
class-wp-url-pattern-prefixer.php	4.7K	V E R D
class-wp-user-meta-session-tokens.php	2.9K	V E R D
class-wp-user-query.php	43.1K	V E R D
class-wp-user-request.php	2.3K	V E R D
class-wp-user.php	22.5K	V E R D
class-wp-walker.php	13K	V E R D
class-wp-widget-factory.php	3.3K	V E R D
class-wp-widget.php	18K	V E R D
class-wp-xmlrpc-server.php	210.4K	V E R D
class-wp.php	25.9K	V E R D
class-wpdb.php	115.8K	V E R D
class.wp-dependencies.php	373	V E R D
class.wp-scripts.php	343	V E R D
class.wp-styles.php	338	V E R D
comment-template.php	100.7K	V E R D
comment.php	130.9K	V E R D
compat-utf8.php	19.1K	V E R D
compat.php	17.4K	V E R D
cron.php	42K	V E R D
date.php	400	V E R D
default-constants.php	11.1K	V E R D
default-filters.php	37K	V E R D
default-widgets.php	2.2K	V E R D
deprecated.php	188.1K	V E R D
embed-template.php	338	V E R D
embed.php	38K	V E R D
error-protection.php	4K	V E R D
feed-atom-comments.php	5.4K	V E R D
feed-atom.php	3K	V E R D
feed-rdf.php	2.6K	V E R D
feed-rss.php	1.2K	V E R D
feed-rss2-comments.php	4K	V E R D
feed-rss2.php	3.7K	V E R D
feed.php	24.6K	V E R D
fonts.php	9.6K	V E R D
formatting.php	346.4K	V E R D
functions.php	281.8K	V E R D
functions.wp-scripts.php	15K	V E R D
functions.wp-styles.php	8.4K	V E R D
general-template.php	168.9K	V E R D
global-styles-and-settings.php	20.7K	V E R D
http.php	25.3K	V E R D
https-detection.php	5.7K	V E R D
https-migration.php	4.6K	V E R D
kses.php	81.7K	V E R D
l10n.php	67.2K	V E R D
link-template.php	156.4K	V E R D
load.php	55.2K	V E R D
locale.php	162	V E R D
media-template.php	61.7K	V E R D
media.php	216.1K	V E R D
meta.php	65K	V E R D
ms-blogs.php	25.2K	V E R D
ms-default-constants.php	4.8K	V E R D
ms-default-filters.php	6.5K	V E R D
ms-deprecated.php	21.2K	V E R D
ms-files.php	2.8K	V E R D
ms-functions.php	89.7K	V E R D
ms-load.php	19.4K	V E R D
ms-network.php	3.7K	V E R D
ms-settings.php	4.1K	V E R D
ms-site.php	40.7K	V E R D
nav-menu-template.php	25.4K	V E R D
nav-menu.php	43.3K	V E R D
option.php	102.6K	V E R D
pluggable-deprecated.php	6.2K	V E R D
pluggable.php	124.5K	V E R D
plugin.php	35.6K	V E R D
post-formats.php	6.9K	V E R D
post-template.php	67K	V E R D
post-thumbnail-template.php	10.6K	V E R D
post.php	289.1K	V E R D
query.php	36.2K	V E R D
registration-functions.php	200	V E R D
registration.php	200	V E R D
rest-api.php	98.3K	V E R D
revision.php	30K	V E R D
rewrite.php	19K	V E R D
robots-template.php	5.1K	V E R D
rss-functions.php	255	V E R D
rss.php	22.7K	V E R D
script-loader.php	154.6K	V E R D
script-modules.php	9.7K	V E R D
session.php	258	V E R D
shortcodes.php	23.5K	V E R D
sitemaps.php	3.2K	V E R D
speculative-loading.php	8.4K	V E R D
spl-autoload-compat.php	441	V E R D
style-engine.php	7.4K	V E R D
taxonomy.php	172.9K	V E R D
template-canvas.php	544	V E R D
template-loader.php	4.2K	V E R D
template.php	36K	V E R D
theme-i18n.json	1.7K	V E R D
theme-previews.php	2.8K	V E R D
theme-templates.php	6.1K	V E R D
theme.json	8.7K	V E R D
theme.php	131.8K	V E R D
update.php	37.5K	V E R D
user.php	173.9K	V E R D
utf8.php	7.1K	V E R D
vars.php	6.4K	V E R D
version.php	1.1K	V E R D
widgets.php	69.5K	V E R D
wp-db.php	445	V E R D
wp-diff.php	799	V E R D