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/wp get attachment image

Descrizione

Restituisce un tag HTML img che rappresenta un file allegato, se esiste, altrimenti una stringa vuota.

Utilizzo

<?php wp_get_attachment_image$attachment_id$size$icon$attr ); ?>

Utilizzo standard

<?php echo wp_get_attachment_image( 1 ); ?>

Se l'allegato è un'immagine, la funzione restituisce un'immagine con la dimensione specificata. Per altri tipi di allegati, la funzione restituisce un'icona se il parametro $icon è impostato a true.

Per ottenere gli ID degli allegati in modo dinamico in un template, si può usare get_posts('post_type=attachment'), ecc.

Parametri

$attachment_id
(integer) (richiesto) ID dell'allegato desiderato.
Default: Nessuno
$size
(string/array) (opzionale) Dimensione dell'immagine. Può essere una stringa con la parola chiave thumbnail, medium, large o full, oppure un array con due elementi che rappresentano larghezza e altezza in pixel, es. array(32,32). A partire dalla versione 2.5, questo parametro non influisce sulla dimensione dell'icona, che è sempre mostrata nella sua dimensione originale.
Default: thumbnail

Al posto di usare un array, è meglio registrare una dimensione con add_image_size, cosicché una versione ritagliata viene generata: è molto più efficiente rispetto a dover cercare l'immagine con la dimensione più simile a quella indicata, e dover poi far ridurre l'immagine al browser.

$icon
(boolean) (opzionale) Indica se usare un'icona per rappresentare l'allegato.
Default: false
  • 1 (true)
  • 0 (false) - default
$attr
(string/array) (opzionale) Query string o array di attributi.
Default: Nessuno
$default_attr = array(
	'src'	=> $src,
	'class'	=> "attachment-$size",
	'alt'   => trim(strip_tags( get_post_meta($attachment_id, '_wp_attachment_image_alt', true) )),
);

L'argomento $attr è combinato con gli attributi predefiniti di WordPress e passato attraverso il filtro wp_get_attachment_image_attributes.

Valori restituiti

(string) 
Un elemento HTML img o una stringa vuota in caso di fallimento.

Esempi

Mostra tutte le immagini come una lista

Per mostrare tutte le immagini, con i relativi titoli, allegate ad una carta pagina nella forma di una lista puntata, si può usare il seguente codice:

<ul>
<?php if ( have_posts() ) : while ( have_posts() ) : the_post();    

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

  $attachments = get_posts( $args );
     if ( $attachments ) {
        foreach ( $attachments as $attachment ) {
           echo '<li>';
           echo wp_get_attachment_image( $attachment->ID, 'full' );
           echo '<p>';
           echo apply_filters( 'the_title', $attachment->post_title );
           echo '</p></li>';
          }
     }

 endwhile; endif; ?>
</ul>

Log delle modifiche

Da: 2.5.0

File sorgente

wp_get_attachment_image() si trova in wp-includes/media.php.

Correlati

the_attachment_link(), get_attachment_link(), wp_get_attachment_link(), wp_get_attachment_image(), wp_get_attachment_image_src(), wp_get_attachment_url(), wp_get_attachment_thumb_file(), wp_get_attachment_thumb_url(), is_attachment(), wp_get_attachment_metadata()

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