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. |