Как установить уникальные атрибуты alt к картинкам WordPress автоматически

Автор: Нина Волкова | Опубликовано: 15.01.2026

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

Почему уникальные alt-теги важны для SEO и доступности

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

Уникальные alt-атрибуты улучшают:

Индексацию изображений в поиске Google Images;
Ранжирование страниц по ключевым словам;
Общий пользовательский опыт;
Доступность сайта согласно стандартам WCAG.

Поэтому важно не просто руками прописывать alt, а иметь механизм автоматизации на случай массовой загрузки картинок.

Автоматическая генерация alt с помощью кода в functions.php

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

Пример функции wplike_set_unique_alt_on_upload:

function wplike_set_unique_alt_on_upload($metadata, $attachment_id) {
    $attachment = get_post($attachment_id);
    if (!$attachment) return $metadata;

    // Получаем заголовок вложения
    $title = $attachment->post_title;
    // Формируем alt на основе заголовка
    if (!empty($title)) {
        update_post_meta($attachment_id, '_wp_attachment_image_alt', sanitize_text_field($title));
    }
    return $metadata;
}
add_filter('wp_generate_attachment_metadata', 'wplike_set_unique_alt_on_upload', 10, 2);

Эта функция срабатывает при загрузке изображения и устанавливает alt равным заголовку файла. Это простой и эффективный способ, если вы называете файлы осмысленно.

Обновление alt для уже загруженных изображений

Если у вас много медиафайлов без alt, можно запустить скрипт для массового обновления:

function wplike_update_missing_alt() {
    $args = [
        'post_type' => 'attachment',
        'post_status' => 'inherit',
        'posts_per_page' => -1,
        'meta_query' => [
            [
                'key' => '_wp_attachment_image_alt',
                'compare' => 'NOT EXISTS'
            ]
        ]
    ];
    $query = new WP_Query($args);

    foreach ($query->posts as $attachment) {
        $alt = sanitize_text_field($attachment->post_title);
        if (!empty($alt)) {
            update_post_meta($attachment->ID, '_wp_attachment_image_alt', $alt);
        }
    }
}
// Вызовите функцию один раз (через админку или WP CLI), потом удалите вызов
// wplike_update_missing_alt();

Используйте этот код аккуратно, чтобы не перегружать сервер.

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

Если вы предпочитаете готовые решения, обратите внимание на плагины для SEO и оптимизации изображений:

Auto Image Attributes From Filename With Bulk Updater — автоматически генерирует alt, title и description по имени файла, поддерживает пакетное обновление.
SEO Friendly Images — автоматически добавляет alt и title к изображениям, если они отсутствуют.
Clearfy Pro — универсальный плагин для оптимизации сайта, в том числе умеет управлять атрибутами изображений и SEO-настройками.

Например, если вы используете Clearfy Pro, там есть удобный интерфейс для настройки авто-генерации alt по шаблонам, что экономит время и улучшает SEO.

Советы по созданию уникальных alt-атрибутов

При автоматизации важно придерживаться нескольких правил:

Используйте осмысленные названия файлов — это основа для генерации alt.
Избегайте избыточного использования ключевых слов (keyword stuffing).
Делайте alt максимально описательными, но короткими (до 125 символов).
Если изображение декоративное, допускается пустой alt (alt="").

Например, для фото черного кота alt может быть alt="черный кот сидит на окне", а не просто alt="кот".

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

Если в теме используются динамические изображения (например, миниатюры постов), можно через фильтр wplike_post_thumbnail_html добавить динамический alt:

function wplike_add_alt_to_thumbnail($html, $post_id, $post_thumbnail_id, $size, $attr) {
    if (empty($attr['alt'])) {
        $alt = get_post_meta($post_thumbnail_id, '_wp_attachment_image_alt', true);
        if (!$alt) {
            $alt = get_the_title($post_id);
        }
        $html = str_replace('<img', '<img alt="'.esc_attr($alt).'"', $html);
    }
    return $html;
}
add_filter('post_thumbnail_html', 'wplike_add_alt_to_thumbnail', 10, 5);

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

Заключение

Автоматизация установки уникальных атрибутов alt к картинкам в WordPress — ключ к улучшению SEO и доступности сайта. Вы можете использовать как кастомный код, так и готовые плагины вроде Clearfy Pro. Главное — следить за качеством alt, чтобы они были уникальными, описательными и полезными.

Пробуйте описанные методы и улучшайте ваш сайт на WordPress уже сегодня!