文件管理器

编辑：post-thumbnail-template.php

<?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 ) );
}

名称	权限	大小	修改时间	操作
↑ 返回上级	-	-	-	-
ID3	drwxr-xr-x	-	2026-05-07 07:32	删除
IXR	drwxr-xr-x	-	2024-10-28 04:32	删除
PHPMailer	drwxr-xr-x	-	2026-05-07 07:34	删除
Requests	drwxr-xr-x	-	2026-05-07 06:14	删除
SimplePie	drwxr-xr-x	-	2026-05-07 06:18	删除
Text	drwxr-xr-x	-	2026-05-07 07:18	删除
abilities-api	drwxr-xr-x	-	2026-05-07 07:09	删除
assets	drwxr-xr-x	-	2026-05-07 07:19	删除
block-bindings	drwxr-xr-x	-	2026-05-07 07:31	删除
block-patterns	drwxr-xr-x	-	2026-05-07 01:18	删除
block-supports	drwxr-xr-x	-	2026-05-07 07:34	删除
blocks	drwxr-xr-x	-	2026-05-07 07:32	删除
certificates	drwxr-xr-x	-	2026-05-07 06:12	删除
css	drwxr-xr-x	-	2025-04-16 18:37	删除
customize	drwxr-xr-x	-	2026-05-07 07:28	删除
fonts	drwxr-xr-x	-	2026-05-07 07:06	删除
html-api	drwxr-xr-x	-	2026-05-07 07:31	删除
images	drwxr-xr-x	-	2026-05-07 07:34	删除
interactivity-api	drwxr-xr-x	-	2026-05-07 08:00	删除
js	drwxr-xr-x	-	2026-05-07 06:05	删除
l10n	drwxr-xr-x	-	2026-05-07 07:35	删除
php-compat	drwxr-xr-x	-	2024-10-28 04:32	删除
pomo	drwxr-xr-x	-	2026-05-07 07:34	删除
rest-api	drwxr-xr-x	-	2024-10-28 04:32	删除
sitemaps	drwxr-xr-x	-	2026-05-07 07:12	删除
sodium_compat	drwxr-xr-x	-	2026-05-07 05:00	删除
style-engine	drwxr-xr-x	-	2026-05-07 05:01	删除
theme-compat	drwxr-xr-x	-	2026-05-07 07:10	删除
widgets	drwxr-xr-x	-	2026-05-07 06:03	删除
author-template.php	-rw-r--r--	18.94 KB	2025-12-03 15:12	编辑下载删除
block-i18n.json	-rw-r--r--	316 B	2021-08-11 18:38	编辑下载删除
block-template-utils-20260507045943.php	-rw-r--r--	61.02 KB	2025-12-03 15:12	编辑下载删除
bookmark-template.php	-rw-r--r--	12.47 KB	2025-04-16 18:37	编辑下载删除
bookmark.php	-rw-r--r--	15.07 KB	2024-03-23 23:50	编辑下载删除
canonical-20260507050333.php	-rw-r--r--	33.83 KB	2025-12-03 15:12	编辑下载删除
canonical.php	-rw-r--r--	33.83 KB	2025-12-03 15:12	编辑下载删除
category-template.php	-rw-r--r--	55.71 KB	2025-12-03 15:12	编辑下载删除
category.php	-rw-r--r--	12.53 KB	2025-04-16 18:37	编辑下载删除
class-avif-info.php	-rw-r--r--	28.92 KB	2024-04-27 00:32	编辑下载删除
class-phpmailer.php	-rw-r--r--	664 B	2020-07-21 22:28	编辑下载删除
class-pop3.php	-rw-r--r--	20.63 KB	2025-04-16 18:37	编辑下载删除
class-smtp.php	-rw-r--r--	457 B	2021-01-27 00:15	编辑下载删除
class-snoopy-20260507035813.php	-rw-r--r--	36.83 KB	2023-02-04 00:05	编辑下载删除
class-walker-category-dropdown.php	-rw-r--r--	2.41 KB	2023-09-14 22:16	编辑下载删除
class-walker-category.php	-rw-r--r--	8.28 KB	2023-09-08 19:02	编辑下载删除
class-walker-nav-menu-20260507070926.php	-rw-r--r--	11.76 KB	2025-04-16 18:37	编辑下载删除
class-walker-page-dropdown.php	-rw-r--r--	2.65 KB	2023-09-14 22:16	编辑下载删除
class-walker-page.php	-rw-r--r--	7.43 KB	2023-09-14 22:16	编辑下载删除
class-wp-ajax-response-20260507060638.php	-rw-r--r--	5.14 KB	2022-09-13 01:17	编辑下载删除
class-wp-ajax-response.php	-rw-r--r--	5.14 KB	2022-09-13 01:17	编辑下载删除
class-wp-block-bindings-registry.php	-rw-r--r--	8.28 KB	2025-12-03 15:12	编辑下载删除
class-wp-block-metadata-registry-20260507072840.php	-rw-r--r--	11.62 KB	2025-04-16 18:37	编辑下载删除
class-wp-block-metadata-registry.php	-rw-r--r--	11.62 KB	2025-04-16 18:37	编辑下载删除
class-wp-block-pattern-categories-registry.php	-rw-r--r--	5.32 KB	2025-12-03 15:12	编辑下载删除
class-wp-block-styles-registry.php	-rw-r--r--	6.34 KB	2025-12-03 15:12	编辑下载删除
class-wp-block-supports.php	-rw-r--r--	5.49 KB	2025-04-16 18:37	编辑下载删除
class-wp-block-template-20260507024316.php	-rw-r--r--	1.99 KB	2024-11-13 23:17	编辑下载删除
class-wp-block-templates-registry.php	-rw-r--r--	7.02 KB	2025-12-03 15:12	编辑下载删除
class-wp-block-type-registry.php	-rw-r--r--	4.91 KB	2025-12-03 15:12	编辑下载删除
class-wp-block-type.php	-rw-r--r--	16.86 KB	2024-05-02 09:31	编辑下载删除
class-wp-classic-to-block-menu-converter.php	-rw-r--r--	3.97 KB	2025-12-03 15:12	编辑下载删除
class-wp-customize-manager-20260507024356-20260507050655.php	-rw-r--r--	198.38 KB	2025-12-03 15:12	编辑下载删除
class-wp-customize-manager-20260507024356.php	-rw-r--r--	198.38 KB	2025-12-03 15:12	编辑下载删除
class-wp-customize-nav-menus.php	-rw-r--r--	56.65 KB	2025-12-03 15:12	编辑下载删除
class-wp-dependencies-20260507024246.php	-rw-r--r--	16.61 KB	2026-02-03 19:37	编辑下载删除
class-wp-duotone.php	-rw-r--r--	39.83 KB	2024-06-14 21:48	编辑下载删除
class-wp-locale-switcher-20260507072836.php	-rw-r--r--	6.62 KB	2025-12-03 15:12	编辑下载删除
class-wp-locale-switcher.php	-rw-r--r--	6.62 KB	2025-12-03 15:12	编辑下载删除
class-wp-locale.php	-rw-r--r--	16.49 KB	2025-04-16 18:37	编辑下载删除
class-wp-paused-extensions-storage.php	-rw-r--r--	4.99 KB	2024-11-13 23:17	编辑下载删除
class-wp-post-type.php	-rw-r--r--	29.96 KB	2025-04-16 18:37	编辑下载删除
class-wp-recovery-mode-cookie-service.php	-rw-r--r--	6.72 KB	2022-10-04 13:29	编辑下载删除
class-wp-recovery-mode-email-service-20260507073323.php	-rw-r--r--	10.92 KB	2023-05-03 01:15	编辑下载删除
class-wp-recovery-mode-email-service.php	-rw-r--r--	10.92 KB	2023-05-03 01:15	编辑下载删除
class-wp-recovery-mode-key-service-plain.php	-rw-r--r--	972 B	2025-12-03 15:12	编辑下载删除
class-wp-recovery-mode-key-service.php	-rw-r--r--	4.77 KB	2025-04-16 18:37	编辑下载删除
class-wp-recovery-mode-link-service.php	-rw-r--r--	3.38 KB	2022-09-13 01:17	编辑下载删除
class-wp-recovery-mode.php	-rw-r--r--	11.18 KB	2025-04-16 18:37	编辑下载删除
class-wp-role.php	-rw-r--r--	2.46 KB	2023-09-08 19:02	编辑下载删除
class-wp-roles.php	-rw-r--r--	9.17 KB	2026-02-03 19:37	编辑下载删除
class-wp-session-tokens.php	-rw-r--r--	7.15 KB	2025-04-16 18:37	编辑下载删除
class-wp-simplepie-sanitize-kses.php	-rw-r--r--	1.87 KB	2025-04-16 18:37	编辑下载删除
class-wp-site-query-20260507060430.php	-rw-r--r--	30.91 KB	2025-12-03 15:12	编辑下载删除
class-wp-site.php	-rw-r--r--	7.29 KB	2025-12-03 15:12	编辑下载删除
class-wp-tax-query.php	-rw-r--r--	19.12 KB	2025-12-03 15:12	编辑下载删除
class-wp-taxonomy.php	-rw-r--r--	18.12 KB	2025-04-16 18:37	编辑下载删除
class-wp-textdomain-registry.php	-rw-r--r--	10.24 KB	2024-11-21 18:36	编辑下载删除
class-wp-translation-file-20260507072842.php	-rw-r--r--	6.13 KB	2024-04-16 05:33	编辑下载删除
class-wp-translation-file.php	-rw-r--r--	6.13 KB	2024-04-16 05:33	编辑下载删除
class-wp-user-meta-session-tokens.php	-rw-r--r--	2.94 KB	2025-12-03 15:12	编辑下载删除
class-wp-widget-factory.php	-rw-r--r--	3.27 KB	2022-09-13 01:17	编辑下载删除
cron.php	-rw-r--r--	41.98 KB	2025-12-03 15:12	编辑下载删除
default-filters.php	-rw-r--r--	37.02 KB	2025-12-03 15:12	编辑下载删除
error_log	-rw-r--r--	47.11 KB	2026-05-07 06:57	编辑下载删除
feed-rdf.php	-rw-r--r--	2.61 KB	2020-01-29 11:15	编辑下载删除
fonts.php	-rw-r--r--	9.56 KB	2025-12-03 15:12	编辑下载删除
global-styles-and-settings.php	-rw-r--r--	20.71 KB	2025-12-03 15:12	编辑下载删除
kses.php	-rw-r--r--	81.73 KB	2026-03-10 18:32	编辑下载删除
l10n.php	-rw-r--r--	67.18 KB	2025-12-03 15:12	编辑下载删除
link-template.php	-rw-r--r--	156.36 KB	2025-12-03 15:12	编辑下载删除
locale.php	-rw-r--r--	162 B	2019-10-09 02:49	编辑下载删除
media-template-20260507050408.php	-rw-r--r--	61.72 KB	2025-12-03 15:12	编辑下载删除
media-template.php	-rw-r--r--	61.72 KB	2025-12-03 15:12	编辑下载删除
media.php	-rw-r--r--	216.06 KB	2026-03-10 18:32	编辑下载删除
meta-20260507060411.php	-rw-r--r--	65 KB	2025-12-03 15:12	编辑下载删除
meta.php	-rw-r--r--	65 KB	2025-12-03 15:12	编辑下载删除
ms-blogs-20260507070856.php	-rw-r--r--	25.24 KB	2025-04-16 18:37	编辑下载删除
ms-blogs.php	-rw-r--r--	25.24 KB	2025-04-16 18:37	编辑下载删除
ms-default-filters.php	-rw-r--r--	6.48 KB	2023-02-24 11:53	编辑下载删除
ms-files.php	-rw-r--r--	2.79 KB	2025-12-03 15:12	编辑下载删除
ms-site-20260507050418.php	-rw-r--r--	40.74 KB	2025-12-03 15:12	编辑下载删除
ms-site.php	-rw-r--r--	40.74 KB	2025-12-03 15:12	编辑下载删除
nav-menu-template.php	-rw-r--r--	25.38 KB	2025-04-16 18:37	编辑下载删除
option-20260507060504.php	-rw-r--r--	102.57 KB	2025-12-03 15:12	编辑下载删除
option.php	-rw-r--r--	102.57 KB	2025-12-03 15:12	编辑下载删除
post-formats.php	-rw-r--r--	6.94 KB	2024-05-28 01:59	编辑下载删除
post-template.php	-rw-r--r--	67.04 KB	2025-12-03 15:12	编辑下载删除
post-thumbnail-template.php	-rw-r--r--	10.62 KB	2025-04-16 18:37	编辑下载删除
registration-functions.php	-rw-r--r--	200 B	2020-11-12 21:47	编辑下载删除
registration.php	-rw-r--r--	200 B	2020-11-12 21:47	编辑下载删除
rewrite.php	-rw-r--r--	19.03 KB	2025-12-03 15:12	编辑下载删除
rss-20260507060524.php	-rw-r--r--	22.66 KB	2025-12-03 15:12	编辑下载删除
sitemaps.php	-rw-r--r--	3.16 KB	2021-05-16 03:08	编辑下载删除
taxonomy.php	-rw-r--r--	172.91 KB	2025-12-03 15:12	编辑下载删除
template-20260507045958.php	-rw-r--r--	35.97 KB	2025-12-03 15:12	编辑下载删除
template-canvas.php	-rw-r--r--	544 B	2023-10-01 09:52	编辑下载删除
theme-i18n.json	-rw-r--r--	1.69 KB	2026-02-03 19:37	编辑下载删除
theme-templates.php	-rw-r--r--	6.09 KB	2025-04-16 18:37	编辑下载删除
theme.json	-rw-r--r--	8.71 KB	2025-12-03 15:12	编辑下载删除
vars.php	-rw-r--r--	6.41 KB	2025-04-16 18:37	编辑下载删除