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 src

Descrizione

Restituisce un array contenente gli attributi "url", "width" e "height" del file relativo ad un allegato di tipo immagine .
Nota: Per riempire solo l'attributo src di un tag HTML img, usare il primo elemento nell'array restituito.

Utilizzo

 <?php wp_get_attachment_image_src$attachment_id$size$icon ); ?> 

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
$icon
(bool) (opzionale) Indica se usare un'icona per rappresentare l'allegato.
Default: false

Valori restituiti

(array) 
un array contenente:
  • [0] => url
  • [1] => larghezza
  • [2] => altezza
  • [3] => boolean: true se $url è un'immagine ridimensionata, false se è l'originale.

o false se non vi è un'immagine disponibile.

Esempi

Utilizzo standard

<?php 
$attachment_id = 8; // ID dell'allegato

$image_attributes = wp_get_attachment_image_src( $attachment_id ); // restituisce un array
?> 
 
<img src="<?php echo $image_attributes[0]; ?>" width="<?php echo $image_attributes[1]; ?>" height="<?php echo $image_attributes[2]; ?>">

Cambiare la cartella dell'icona

WordPress può usare icone per rappresentare file allegati sul sito e nell'interfaccia di amministrazione, se tali icone sono disponibili. Per le immagini restituisce la miniatura, per altri tipi di file cerca file immagini con lo stesso nome del tipo di media (es. audio.jpg) nella cartella: wp-includes/images/crystal/.

Questo esempio mostra come modificare il percorso di questa cartella per usarne un'altra dal nome "images" presente nel tema: wp-content/themes/tuotema/images. Dopo aver creato la cartella e averci messo dentro le immagini rappresentanti le icone, bisogna dire a WordPress che la cartella è cambiata indicandola nel file functions.php del tema corrente:

add_filter( 'icon_dir', 'my_theme_icon_directory' );
add_filter( 'icon_dir_uri', 'my_theme_icon_uri' );

function my_theme_icon_directory( $icon_dir ) {
	return get_stylesheet_directory() . '/images';
}

function my_theme_icon_uri( $icon_dir ) {
	return get_stylesheet_directory_uri() . '/images'; 
}

Mostra la prima immagine del post

Il codice completo si trova qui get_children().

Log delle modifiche

Da: 2.5.0

File sorgente

wp_get_attachment_image_src() 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.