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 link

Descrizione

Restituisce un link HTML ad un file o una pagina allegato, contenente alternativamente:

  1. un'immagine con la dimensione specificata, per gli allegati di tipo immagine; oppure
  2. un'icona (come specificata) che rappresenta l'allegato; oppure
  3. il titolo dell'allegato (in formato testo) oppure
  4. un testo a propria scelta

Se l'allegato non esiste, la funzione mosta la stringa Allegato mancante.

Utilizzo

<?php wp_get_attachment_link$id$size$permalink$icon$text ); ?>

Utilizzo standard

<?php echo wp_get_attachment_link( 13 ); ?>

Per ottenere gli ID dinamicamente in un template, è meglio usare get_children().

Parametri

$id
(integer) (opzionale) ID dell'allegato desiderato.
Default: L'ID del post corrente, quando usato nel loop (deve trattarsi di un loop che mostra solo gli allegati).
$size
(string/array) (opzionale) Dimensione dell'immagine. Può essere una parola chiave (thumbnail, medium, large o full) o un array con due elementi che rappresentano la larghezza e l'altezza in pixel, es. array(32,32). A partire dalla versione 2.5, questo parametro non influsice sulla dimensione delle icone, che sono sempre mostrate nella loro dimensione originale.
Default: thumbnail
$permalink
(boolean) (opzionale) Indica se il collegamento deve essere direttamente all'immagine o al file allegato (Default), oppure alla pagina dell'allegato.
Default: false
$icon
(boolean) (opzionale) Indica se usare un'icona per rappresentare l'allegato.
Default: false
$text
(string/boolean) (opzionale) Eventuale testo del collegamento.
Default: false

Esempi

Mostrare allegati di medie dimensioni

Le dimensioni predefinite per le immagini in WordPress sono "thumbnail", "medium", "large" e "full" (l'immagine così come caricata). Queste dimensioni possono essere configurate nel pannello di amministrazione Media nella sezione Impostazioni > Media.

<?php 
    $id = 9; // ID di un allegato
    echo wp_get_attachment_link( $id, 'medium' ); 
?>

Collegamento all'allegato di un post

Questo esempio crea un link alla pagina di un allegato.

<?php 
    $id = 9; // ID di un allegato
    echo wp_get_attachment_link( $id, 'thumbnail', true ); 
?>

Collegamento testuale ad un allegato

Questo esempio restituisce un link HTML con "Il mio collegamento testuale" che punta ad un file allegato.

<?php 
    $id = 9; // ID di un allegato
    echo wp_get_attachment_link( $id, '' , false, false, 'Il mio collegamento testuale' ); 
?>

Collegare il titolo di un post ad un allegato

Questo esempio restituisce un link HTML con il titolo del post che punta ad un file allegato.

<?php 
    $id = 9; // ID di un allegato
    echo wp_get_attachment_link( $id, '' ); 
 ?>

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'; 
}

Note

Utilizzare wp_get_attachment_image() se si vuole solamente il tag HTML dell'immagine (non un collegamento).

Log delle modifiche

Since: 2.5.0

File sorgente

wp_get_attachment_link() si trova in wp-includes/post-template.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()