Recupera la miniatura de la publicación.

Descripción

Cuando un tema agrega compatibilidad con ‘post-miniatura’, se registra un tamaño de imagen especial ‘post-miniatura’, que difiere del tamaño de imagen de ‘miniatura’ administrado a través de la pantalla Configuración> Medios.

Cuando se usa the_post_thumbnail () o funciones relacionadas, el tamaño de imagen ‘post-thumbnail’ se usa por defecto, aunque se puede especificar un tamaño diferente en su lugar según sea necesario.

Parámetros

$ publicación

(En t|WP_Post) (Opcional) ID de publicación o objeto WP_Post. El valor predeterminado es global $post.

Valor predeterminado: nulo

$ tamaño

(cuerda|En t[]) (Opcional) Tamaño de la imagen. Acepta cualquier nombre de tamaño de imagen registrado o una matriz de valores de ancho y alto en píxeles (en ese orden).

Valor predeterminado: ‘post-miniatura’

$ attr

(cuerda|formación) (Opcional) Cadena de consulta o matriz de atributos.

Valor por defecto: ”

Regreso

(cuerda) La etiqueta de la imagen en miniatura de la publicación.

Más información

Si el requerido add_theme_support( 'post-thumbnails' ); en el archivo functions.php del tema actual está adjunto a un gancho, debe ser llamado antes de init se dispara el gancho. los en eso Es posible que el gancho sea demasiado tarde para algunas funciones. Si se adjunta a un gancho, debe after_setup_theme.

Fuente

Expediente: wp-includes / post-thumbnail-template.php

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.
	 * @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       $attr              Query string of attributes.
	 */
	return apply_filters( 'post_thumbnail_html', $html, $post->ID, $post_thumbnail_id, $size, $attr );
}

Relacionado

Usos

Usos Descripción
wp-includes / query.php: en el lazo()

Determina si la persona que llama está en el bucle.

wp-includes / plugin.php: aplicar_filtros ()

Llama a las funciones de devolución de llamada que se han agregado a un enlace de filtro.

wp-includes / plugin.php: do_action ()

Ejecuta funciones conectadas a un gancho de acción específico.

wp-includes / post-thumbnail-template.php: get_post_thumbnail_id ()

Recuperar el ID de la miniatura de la publicación.

wp-includes / post-thumbnail-template.php: update_post_thumbnail_cache ()

Actualiza la caché de las miniaturas en el bucle actual.

wp-includes / post-thumbnail-template.php: post_thumbnail_size

Filtra el tamaño de la miniatura de la publicación.

wp-includes / post-thumbnail-template.php: begin_fetch_post_thumbnail_html

Se activa antes de obtener el HTML en miniatura de la publicación.

wp-includes / post-thumbnail-template.php: end_fetch_post_thumbnail_html

Se activa después de obtener el HTML en miniatura de la publicación.

wp-includes / post-thumbnail-template.php: post_thumbnail_html

Filtra el HTML de la miniatura de la publicación.

wp-includes / media.php: wp_get_attachment_image ()

Obtenga un elemento img HTML que represente un archivo adjunto de imagen.

wp-includes / post.php: get_post ()

Recupera los datos de la publicación con un ID de publicación o un objeto de publicación.

Usado por

Usado por Descripción
wp-includes / post-thumbnail-template.php: the_post_thumbnail ()

Muestra la miniatura de la publicación.

Registro de cambios

Versión Descripción
4.4.0 $post puede ser un ID de publicación o un objeto WP_Post.
2.9.0 Introducido.