¿Cómo Recuperar el Texto Alt de una Imagen Adjunta?

Considera revisar wp_prepare_attachment_for_js( $attachment ), donde $attachment es el objeto WP_Post del adjunto en sí.

Esta es un poco una función "todo en uno", pero proporciona un hash muy completo con mucha metainformación, incluyendo 'alt':

$response = array(
        'id'          => $attachment->ID,
        'title'       => $attachment->post_title,
        'filename'    => wp_basename( $attachment->guid ),
        'url'         => $attachment_url,
        'link'        => get_attachment_link( $attachment->ID ),
        'alt'         => get_post_meta( $attachment->ID, '_wp_attachment_image_alt', true ),
        'author'      => $attachment->post_author,
        'description' => $attachment->post_content,
        'caption'     => $attachment->post_excerpt,
        'name'        => $attachment->post_name,
        'status'      => $attachment->post_status,
        'uploadedTo'  => $attachment->post_parent,
        'date'        => strtotime( $attachment->post_date_gmt ) * 1000,
        'modified'    => strtotime( $attachment->post_modified_gmt ) * 1000,
        'menuOrder'   => $attachment->menu_order,
        'mime'        => $attachment->post_mime_type,
        'type'        => $type,
        'subtype'     => $subtype,
        'icon'        => wp_mime_type_icon( $attachment->ID ),
        'dateFormatted' => mysql2date( get_option('date_format'), $attachment->post_date ),
        'nonces'      => array(
            'update' => false,
            'delete' => false,
            'edit'   => false
        ),
        'editLink'   => false,
        'meta'       => false,
    );

Esto es particularmente útil (como su nombre lo indica), para enviar la metainformación de la imagen adjunta a una vista wp.media mediante wp_send_ajax(), pero eso no significa que no puedas usarlo para otros propósitos.

Me gusta abstraerme del campo de metadatos _wp_attachment_image_alt, en caso de que el método para recuperar el texto alternativo cambie alguna vez (poco probable, pero concebible).

Sin embargo, creo que hay un caso para un método wp_get_attachment_image_alt().

La respuesta de Mike es correcta, por supuesto, pero $alt_text = get_post_meta($post->ID, '_wp_attachment_image_alt', true); puede devolver una cadena vacía.

Sin embargo, wp_get_attachment_image siempre obtiene un alt_text.

El equipo de WordPress aplica el siguiente truco: primero verifica el post_excerpt y luego obtiene el título.

if(empty($alt_text)) // Si no hay texto alternativo, usa el Caption
{
    $attachment = get_post($post->ID);
    $alt_text = trim(strip_tags( $attachment->post_excerpt ));
}
if(empty($alt_text)) // Finalmente, usa el título
{ 
    $attachment = get_post($post->ID);
    $alt_text = trim(strip_tags( $attachment->post_title )); 
}

Descubrí que el texto alternativo para los archivos adjuntos se almacena en un metadato personalizado llamado "_wp_attachment_image_alt".

Así que, teniendo el ID del archivo adjunto, pude obtener el texto alternativo con este código:

<?php echo get_post_meta($attachment_id, '_wp_attachment_image_alt', true) ?>

Para complementar la respuesta de Mike, alguien podría encontrar esto útil. Es posible que necesites obtener el ID específico del adjunto, por lo que puedes hacerlo pasando el ID de la publicación a get_post_thumbnail_id ejemplo:

  $the_img = wp_get_attachment_image( get_post_thumbnail_id( get_the_ID() ) );

Si estás usando WP_Customize_Media_Control(), tu get_theme_mod() devolverá el ID del post, pero si usas el nuevo WP_Customize_Image_Control(), get_theme_mod() devolverá la URL de la imagen. Así fue como pude obtener el texto ALT usando WP_Customize_Image_Control().

Aquí está cómo lo hice. Espero que esto ayude a alguien por ahí.

// Esto obtiene la imagen / URL
$feature1 = get_theme_mod('feature_image_1');

// Esto obtiene el ID del post
$feature1_id = attachment_url_to_postid($feature1);

// Esto obtiene el texto ALT de la imagen que está configurado en el área de medios
$image1_alt = get_post_meta( $feature1_id, '_wp_attachment_image_alt', true );

Marcado HTML

<a href="<?php echo $feature1_url; ?>"><img class="img-responsive center-block" src="<?php echo $feature1; ?>" alt="<?php echo $image1_alt; ?>"></a>

Si los métodos civilizados no funcionan:

alt="<?php echo explode("\"",get_the_post_thumbnail(get_the_ID()))[9]; ?>"