Как добавить автоматический alt к изображениям в WordPress: практические решения и примеры кода

Автор: Дарья Алексеева | Опубликовано: 08.01.2026

Для улучшения SEO и доступности сайта важно, чтобы у всех изображений был атрибут alt. Однако часто контент-менеджеры забывают добавлять описание к картинкам, особенно если их много. В этой статье мы разберём, как автоматизировать процесс добавления alt-текста в WordPress с помощью кода и плагинов, а также рассмотрим примеры, которые помогут решить эту задачу эффективно.

Почему важен alt для изображений в WordPress

Атрибут alt — это текст, который описывает изображение, если по каким-то причинам оно не отображается. Он также помогает поисковым системам лучше понимать контент страницы и улучшает доступность для пользователей с ограничениями по зрению.

Без alt поисковики не смогут проиндексировать изображения, а пользователи с экранными читалками не поймут, что изображено на картинке. Поэтому автоматизация добавления alt особенно важна для сайтов с большим количеством медиа-контента.

Автоматическое добавление alt с помощью кода в functions.php

Один из самых простых способов — написать функцию, которая при загрузке изображения будет автоматически ставить alt из названия файла, если он не задан.

Пример функции wpskills_auto_alt_add()

function wpskills_auto_alt_add($metadata, $attachment_id) {
    $attachment = get_post($attachment_id);
    $alt = get_post_meta($attachment_id, '_wp_attachment_image_alt', true);
    if (empty($alt)) {
        $filename = pathinfo($attachment->post_title, PATHINFO_FILENAME);
        $alt_text = str_replace(array('-', '_'), ' ', $filename);
        update_post_meta($attachment_id, '_wp_attachment_image_alt', $alt_text);
    }
    return $metadata;
}
add_filter('wp_generate_attachment_metadata', 'wpskills_auto_alt_add', 10, 2);

Эта функция срабатывает при добавлении изображения в медиатеку. Если у картинки нет alt, она берёт название файла (без расширения), заменяет дефисы и подчёркивания на пробелы и записывает этот текст в alt.

Такой подход прост, но может не всегда отражать суть изображения. Для более точных описаний можно использовать более сложные методы.

Использование плагинов для автоматической генерации alt

Если вы не хотите писать код, можно использовать плагины, которые автоматически добавляют alt для изображений.

Расширенные методы: автоматическое добавление alt на основе контекста и AI

Более продвинутые решения используют анализ содержимого страницы или ИИ для генерации описаний.

Пример: использование WPGPT для генерации alt

Плагин WPGPT позволяет интегрировать GPT-модели в WordPress. С его помощью можно автоматически создавать описания для изображений, основываясь на содержимом поста.

Пример кода для автоматизации генерации alt через WPGPT:

function wpskills_generate_alt_with_wpgpt($attachment_id, $post_id) {
    $post = get_post($post_id);
    $attachment = get_post($attachment_id);
    $alt = get_post_meta($attachment_id, '_wp_attachment_image_alt', true);
    if (empty($alt) && class_exists('WPGPT')) {
        $context = $post->post_content;
        $image_name = $attachment->post_title;
        $prompt = "Опиши изображение с названием: $image_name в контексте статьи: $context";
        $description = WPGPT::generate_text($prompt);
        if (!empty($description)) {
            update_post_meta($attachment_id, '_wp_attachment_image_alt', $description);
        }
    }
}
add_action('add_attachment', function($attachment_id) {
    $post_id = get_post_field('post_parent', $attachment_id);
    if ($post_id) {
        wpskills_generate_alt_with_wpgpt($attachment_id, $post_id);
    }
});

Этот пример показывает, как можно использовать возможности ИИ для создания уникальных и релевантных alt для изображений.

Как массово обновить alt для уже загруженных изображений

Если на сайте уже много картинок без alt, можно использовать SQL-запросы или специальные плагины для массового обновления.

Обновление через SQL (осторожно!)

Пример запроса, который обновит alt, если он пуст, используя имя файла:

UPDATE wp_postmeta pm
INNER JOIN wp_posts p ON pm.post_id = p.ID
SET pm.meta_value = REPLACE(SUBSTRING_INDEX(p.post_title, '.', 1), '-', ' ')
WHERE pm.meta_key = '_wp_attachment_image_alt'
AND (pm.meta_value = '' OR pm.meta_value IS NULL)
AND p.post_type = 'attachment';

Перед выполнением сделайте резервную копию базы! Лучше использовать плагины с функцией массового обновления, например, Media Library Assistant.

Как добавить автоматический alt к изображениям в WordPress