SEO Картинки для Shop-Script

Цифровой паспорт изображения

Плагин записывает название товара, описание, ключевые слова, авторство и ссылку на страницу прямо в XMP-метаданные файла. Это невидимая бирка, которая путешествует вместе с картинкой — её не нужно никуда прикреплять вручную.

Защита авторства

Если ваше фото «утащат» на другой сайт или оно появится в поиске по картинкам — робот прочитает данные из файла и поймёт: «Эта картинка относится к такому-то товару в таком-то магазине». Правильная атрибуция сохраняется, даже если прямой ссылки на ваш сайт рядом нет.

Больше трафика из поиска по картинкам

Поисковики лучше понимают содержимое фотографии, когда в файле есть точные описания и ключевые слова. Это повышает шансы, что ваши изображения покажутся выше в Google Images или Яндекс.Картинках по визуальному запросу — и приведут покупателя прямо к товару.

Умное заполнение через нейросеть

Вручную прописывать теги для тысяч товаров не нужно: подключите imageapi.ru через Webasyst ID — и нейросеть сама опишет каждое изображение. Описания подставляются в XMP-шаблоны автоматически, делая метаданные точными и уникальными для каждой фотографии.

Быстрый старт

Установите плагин, убедитесь что на сервере есть PHP-расширение Imagick, включите чекбокс «Автоматически генерировать метаданные» и нажмите кнопку «Пересоздать эскизы». Все существующие эскизы получат XMP-метаданные по шаблонам из настроек.

Автоматическая генерация

Если включён чекбокс «Автоматически генерировать метаданные», плагин перехватывает каждый созданный эскиз и сразу записывает в него XMP-данные по шаблонам. Эскизы получают метаданные без дополнительных действий — при загрузке новых фотографий или пересоздании существующих.

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

Шаблоны метаданных

Каждое XMP-поле задаётся Smarty-шаблоном. В шаблонах доступны переменные товара: название, SEO-поля, краткое описание, URL, название магазина, текущий год. А если у изображения есть описание от нейросети — можно подставить его через хелперы getDescribeData() и getDescribeDataField().

Пересоздание эскизов

Кнопка «Пересоздать эскизы» в настройках плагина открывает стандартный диалог Shop-Script для пересоздания эскизов всех товаров. Это удобно при первом включении плагина — чтобы добавить метаданные ко всем уже существующим изображениям без ручной работы.

Профили и пакетная обработка

Создайте профиль — укажите набор товаров-источник, набор-результат, промпт и режим ответа. После этого можно запустить пакетное описание одним кликом: плагин пройдёт по всем изображениям из набора, опишет каждое через ИИ и переместит товар в результирующий набор.

Прогресс отображается в модальном окне с лог-строками и счётчиком обработанных изображений.

В настройках профиля есть поле «Шаблон описания»: Smarty-шаблон, результат которого автоматически записывается в поле описания изображения (shop_product_images.description) сразу после обработки. Удобно, если тема вашего сайта выводит это поле на карточке товара — заполнять вручную не нужно.

Для автоматизации поддерживается запуск через cron — готовая команда с правильным путём показана прямо в настройках плагина.

Ручное редактирование на странице товара

На странице редактирования товара в разделе с фотографиями появляется кнопка «Метаданные». Откройте её — и увидите список всех эскизов этого изображения с текущими XMP-данными. Можно отредактировать поля для конкретного эскиза или применить данные из шаблонов ко всем сразу.

Если установлен плагин «Изображения WEBP», в редакторе появится отдельный блок с WebP-эскизами — их метаданные можно редактировать так же.

Описание изображений через ИИ

Подключите аккаунт imageapi.ru через Webasyst ID — и нейросеть сможет описывать изображения товаров автоматически. Описание сохраняется и используется в XMP-шаблонах: чем точнее описание, тем релевантнее метаданные в эскизах.

На странице каждого товара, в разделе редактирования фотографий, появляется вкладка «Описание ИИ». Здесь можно описать конкретное изображение, отредактировать результат и сохранить его. Промпт и формат ответа (текст или JSON) можно изменить прямо перед запросом.

Использование описаний ИИ в шаблоне витрины

Два статических хелпера позволяют подставить описание изображения от нейросети в любое место шаблона карточки товара: в alt, title, подпись или любой другой элемент. Данные читаются из базы и не требуют дополнительных запросов к API.

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

{* Получаем title и alt из ИИ-описания изображения *}
{capture assign="img_title"}{shopMetaimagePluginHelper::getDescribeDataField($image.id, 'title', true)|default:$product.name}{/capture}
{capture assign="img_alt"}{shopMetaimagePluginHelper::getDescribeDataField($image.id, 'alt', true)|default:$product.name}{/capture}

<div class="image{if $image.id == $product.image_id && empty($video)} selected{/if}">
    <a id="product-image-{$image.id}"
       data-href="{$wa->shop->imgUrl($image, '970')}"
       data-srcset="{$wa->shop->imgUrl($image, '970@2x')}"
       href="{$wa->shop->imgUrl($image, '750')}"
       title="{$img_title|escape}">
        {$wa->shop->imgHtml($image, '96x96', [
            'srcset' => "`$wa->shop->imgUrl($image, '96x96@2x')` 2x",
            'alt'    => $img_alt
        ])}
    </a>
</div>

Значение true в третьем параметре хелпера означает: если нейросеть вернула обычный текст (не JSON), использовать его целиком как запасное значение. Фильтр |default:$product.name сработает, если описания для этого изображения ещё нет.

Авторизация через Webasyst ID

Для работы ИИ-описания необходим аккаунт на imageapi.ru. Подключение выполняется в один клик через Webasyst ID: на вкладке «Авторизация» войдите в свой аккаунт Webasyst ID — и плагин получит токен доступа автоматически.

Текущий баланс токенов отображается на вкладке «Информация» в настройках плагина.

Сервис imageapi.ru

imageapi.ru — российский облачный сервис обработки изображений нейросетями. Для описания изображений используется модель Qwen2-VL-7B-Instruct — мультимодальная языковая модель, специализированная на понимании визуального содержимого и генерации текстовых описаний.

Принцип работы: плагин отправляет публичный URL эскиза товара на сервер imageapi.ru, модель анализирует изображение и возвращает короткое описание на русском языке. Вся вычислительная работа выполняется на стороне сервиса — на хостинге магазина ничего дополнительно устанавливать не нужно.

Сервис поддерживает два режима ответа: текстовое описание (одна фраза) и JSON-режим — структурированные атрибуты товара (описание, бренд, теги, цвета, категория). Промпт можно задать самостоятельно под нужды конкретного магазина.

Стоимость описания изображений

Стоимость одного запроса зависит от длины ответа нейросети (количества сгенерированных токенов ИИ):

На практике короткое текстовое описание занимает около 10–20 токенов ИИ (2 токена). Ответ в JSON-режиме с 5 полями — около 80–130 токенов ИИ (2 токена).

Интеграция с плагином «Изображения WEBP»

Если у вас установлен плагин «Изображения WEBP», «SEO Картинки» автоматически записывает XMP-метаданные и в WebP-версии эскизов — они создаются плагином cwebp в момент первого обращения к изображению.

В редакторе метаданных на странице товара WebP-эскизы отображаются отдельным блоком: можно просмотреть текущие метаданные, отредактировать их вручную или записать данные из шаблонов сразу во все WebP-файлы изображения.