Кастомизация медиа-элементов

Редактировал(а) Руслан Савельев 2025/11/05 23:49

1. Информация

КСО поддерживает настройку внешнего вида и звукового сопровождения. Пользовательские файлы (иконки, изображения товаров, реклама, звуки, голосовые фразы) размещаются в папке CustomMedia, структура которой повторяет стандартную папку SystemMedia.

Для медиафайлов используется следующий приоритет:

  • Если файл найден в CustomMedia — будет использован он.
  • Если файл отсутствует — будет использован из SystemMedia.

2. Замена системных изображений и звуков

Для замены стандартных иконок, звуковых сигналов и голосовых подсказок используются соответствующие папки в каталоге CustomMedia:

  • CustomMedia\Icons: иконки интерфейса
  • CustomMedia\Sounds: системные звуки
  • CustomMedia\Voice: голосовые подсказки

Файлы в этих папках должны иметь точно такие же имена, как оригинальные файлы в каталоге SystemMedia. При наличии файла в CustomMedia система использует его вместо стандартного.

Поддерживаемые форматы:

  • Изображения: PNG, JPG
  • Звуки: WAV, MP3

Примечание!
Изменения применяются после перезапуска КСО.
При отсутствии файла в CustomMedia используется оригинал из SystemMedia.

3. Изображения товаров

Изображения товаров отображаются на экранах выбора товаров и в корзине. Система ищет подходящее изображение по следующему приоритету (от высшего к низшему):

  1. CustomMedia\ProductImages\[глобальный_код_товара_на_АЗС].png — индивидуальное изображение конкретного товара (имя файла должно совпадать с глобальным кодом товара на АЗС, например, 35688.png)
  2. CustomMedia\ProductGroupImages\[код_группы_АЗС].png — изображение группы товаров на АЗС (например, 12.png)
  3. CustomMedia\SelfServiceGroupImages\[код_группы_КСО].png — изображение группы товаров в КСО (например, 1.png)
  4. CustomMedia\ProductImages\0.png — кастомное изображение по умолчанию
  5. SystemMedia\ProductImages\0.png — системное изображение по умолчанию

Папки и назначение:

ПапкаНазначениеИмя файла
CustomMedia\ProductImagesИндивидуальные изображения товаровглобальный_код_товара_на_АЗС.png
CustomMedia\ProductGroupImagesИзображения групп товаров АЗСкод_группы_АЗС.png
CustomMedia\SelfServiceGroupImagesИзображения групп товаров КСОкод_группы_КСО.png

Пример использования:

Группа «Напитки» в КСО объединяет товары из разных групп АЗС: кофе, энергетики, соки. Администратор может:

  • Задать одну общую картинку для всей группы «Напитки» в КСО — разместить файл 1.png в CustomMedia\SelfServiceGroupImages (где 1 — код группы КСО).
  • Или задать отдельные картинки для подгрупп АЗС:
    • Кофе → 15.png в CustomMedia\ProductGroupImages
    • Энергетики → 16.png в CustomMedia\ProductGroupImages
    • Соки → 17.png в CustomMedia\ProductGroupImages

В этом случае в группе «Напитки» на КСО каждый товар будет показывать свою подгрупповую картинку (приоритет 2), а не общую.

  • Поддерживаемые форматы изображения: PNG, JPG
  • Рекомендуемые размеры изображения: 256*256 пикс., 512*512 пикс.

4. Загрузка рекламных изображений для режима «Витрина»

Поместите рекламные изображения в каталог:

  • CustomMedia\StoreShowcaseImages

При размещении в каталоге нескольких изображений, их отображение будет сменяться согласно установленным настройкам КСО.

  • Поддерживаемые форматы изображения: PNG, JPG
  • Рекомендуемые размеры изображения: 1080*1920 пикс.

5. Загрузка рекламных изображений для режима «Самообслуживание»

Поместите рекламные изображения в каталог:

  • CustomMedia\SelfServiceImages

При размещении в каталоге нескольких изображений, их отображение будет сменяться согласно установленным настройкам КСО.

  • Поддерживаемые форматы изображения: PNG, JPG
  • Рекомендуемые размеры изображения: 1080*1920 пикс.