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 attachment link

Descrizione

Restituisce l'URI della pagina di un allegato.

Utilizzo

 <?php $attachment_page get_attachment_link($id); ?> 

Parametri

$id
(integer) (opzionale) ID numerico dell'allegato.
Default: ID del post corrente, quando usato nel loop.

Esempi

Utilizzo standard

Poiché la funzione non stampa il permalink, questo esempio usa il comando PHP echo.

<?php 
$attachment_id = 1; // ID dell'allegato
$attachment_page = get_attachment_link( $attachment_id ); 
?>
<a href="<?php echo $attachment_page; ?>"><?php echo get_the_title( $attachment_id ); ?></a>

Mostrare immagini allegate e titoli in forma di lista

Per mostrare le immagini allegate ad una certa pagina sotto forma di 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>';
           the_attachment_link( $attachment->ID, true );
           echo '<p>';
           echo apply_filters( 'the_title', $attachment->post_title );
           echo '</p></li>';
          }
     }

 endwhile; endif; ?>
</ul>

Valori restituiti

Usando la struttura dei permalink "gradevoli", la funzione restituisce qualcosa simile a http://wp.example.net/path_to_post/post_name/attachment_name.

Usando la struttura predefinita dei permalink — o nel caso in cui Wordpress non riesca a costruire un URI gradevole — la funzione restituisce qualcosa simile a http://wp.example.net/?attachment_id=n, dove n è l'ID numerico dell'allegato.

Note

Si può modificare l'output di questa funzione attraverso il filtro attachment_link .

Se si vuole un link diretto al file allegato (invece della pagina dell'allegato), si può usare la funzione wp_get_attachment_url(id).

Nota: get_attachment_link in realtà restituisce un URI, mentre wp_get_attachment_link() restituisce un link HTML.

File sorgente

get_attachment_link() si trova in wp-includes/link-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()