Как получить альтернативный текст (Alt Text) изображения во вложении?

Рекомендуется рассмотреть функцию wp_prepare_attachment_for_js( $attachment ), где $attachment — это объект WP_Post самого вложения.

Это своего рода "универсальная" функция, но она предоставляет удобный массив с множеством метаданных, включая '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,
    );

Эта функция особенно полезна (как следует из названия) для передачи метаданных изображения в wp.media View через wp_send_ajax(), но это не означает, что её нельзя использовать для других целей.

Мне нравится идея абстрагироваться от метаполя _wp_attachment_image_alt на случай, если метод получения альтернативного текста когда-нибудь изменится (маловероятно, но возможно).

Я также считаю, что было бы полезно иметь метод wp_get_attachment_image_alt().

Ответ Майка, конечно, правильный, но $alt_text = get_post_meta($post->ID, '_wp_attachment_image_alt', true); может вернуть пустую строку.

Однако wp_get_attachment_image всегда получает alt_text.

Команда WordPress применяет следующий трюк: сначала проверяет post_except, а затем получает заголовок.

if(empty($alt_text)) // Если пусто, используем подпись
{
    $attachment = get_post($post->ID);
    $alt_text = trim(strip_tags( $attachment->post_excerpt ));
}
if(empty($alt_text)) // В крайнем случае используем заголовок
{ 
    $attachment = get_post($post->ID);
    $alt_text = trim(strip_tags( $attachment->post_title )); 
}

Я выяснил, что альтернативный текст для вложений хранится в пользовательском метаполе "_wp_attachment_image_alt".

Таким образом, имея ID вложения, я смог получить альтернативный текст с помощью этого кода:

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

Дополняя ответ Майка, кому-то может пригодиться следующее. Возможно, вам потребуется получить конкретный ID вложения, это можно сделать, передав ID записи в функцию get_post_thumbnail_id. Пример:

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

Если вы используете WP_Customize_Media_Control(), функция get_theme_mod() вернет ID записи. Но если вы используете новый WP_Customize_Image_Control(), get_theme_mod() вернет URL изображения. Вот как я смог получить альтернативный текст при использовании WP_Customize_Image_Control().

Вот как я это сделал. Надеюсь, это поможет кому-то.

// Получаем изображение / URL
$feature1 = get_theme_mod('feature_image_1');

// Получаем ID записи
$feature1_id = attachment_url_to_postid($feature1);

// Получаем альтернативный текст изображения, установленный в медиабиблиотеке
$image1_alt = get_post_meta( $feature1_id, '_wp_attachment_image_alt', true );

Разметка

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

Если цивилизационные методы не работают:

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