WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento funzioni/get post thumbnail id

Contents

Descrizione

  1. Se un'immagine in evidenza (o miniatura del post) è impostata, restituisce l'ID dell'immagine allegata al post
  2. Se tale allegato non esiste, la funzione restituisce una stringa vuota
  3. Se il post non esiste, la funzione restituisce false

Nota: Per abilitare le immagini in evidenza, o miniature del post, il tema corrente deve includere add_theme_support( 'post-thumbnails' ); nel suo file functions.php. Si veda anche Immagini in evidenza.

Utilizzo

 <?php  $post_thumbnail_id get_post_thumbnail_id$post_id ); ?> 

Parametri

$post_id
(integer) (opzionale) ID del post. Se è null, il post corrente verrà utilizzato.
Default: null

Valori restituiti

(string) 
L'ID del post, o stringa vuota in caso di fallimento.

Esempi

Mostra tutti gli allegati al post corrente tranne l'immagine in evidenza

Per ottenere tutti gli allegati al post tranne l'immagine in evidenza, si può usare questa funzione con qualcosa come get_posts().

Lo si faccia all'interno del loop (dove $post->ID è disponibile).

<?php

$args = array(
	'post_type'   => 'attachment',
	'numberposts' => -1,
	'post_status' => 'any',
	'post_parent' => $post->ID,
	'exclude'     => get_post_thumbnail_id()
	);

$attachments = get_posts( $args );

if ( $attachments ) {
	foreach ( $attachments as $attachment ) {
		echo apply_filters( 'the_title', $attachment->post_title );
		the_attachment_link( $attachment->ID, false );
	}
}

?>

Note

  • "Miniatura del post" è un vecchio termine per indicare "immagine in evidenza". Questa funzione restituisce l'ID dell'immagine in evidenza del post. Non restituisce gli ID delle altre immagini allegate ai post che hanno dimensione miniatura.

Log delle modifiche

Da: 2.9.0

File sorgente

get_post_thumbnail_id() si trova in wp-includes/post-thumbnail-template.php.

Correlati

Immagini in evidenza: has_post_thumbnail(), the_post_thumbnail(), get_post_thumbnail_id(), get_the_post_thumbnail(), add_image_size(), set_post_thumbnail_size()

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.