Исходный код вики Кастомизация медиа-элементов
Редактировал(а) Руслан Савельев 2025/11/05 23:49
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | == **1. Информация** == | ||
| 2 | |||
| 3 | КСО поддерживает настройку внешнего вида и звукового сопровождения. Пользовательские файлы (иконки, изображения товаров, реклама, звуки, голосовые фразы) размещаются в папке ##CustomMedia##, структура которой повторяет стандартную папку ##SystemMedia##. | ||
| 4 | |||
| 5 | **Для медиафайлов используется следующий приоритет:** | ||
| 6 | |||
| 7 | * Если файл найден в ##CustomMedia ##— будет использован он. | ||
| 8 | * Если файл отсутствует — будет использован из ##SystemMedia##. | ||
| 9 | |||
| 10 | == **2. Замена системных изображений и звуков** == | ||
| 11 | |||
| 12 | Для замены стандартных иконок, звуковых сигналов и голосовых подсказок используются соответствующие папки в каталоге ##CustomMedia##: | ||
| 13 | |||
| 14 | * ##**CustomMedia\Icons**##: иконки интерфейса | ||
| 15 | * ##**CustomMedia\Sounds**##:** **системные звуки | ||
| 16 | * ##**CustomMedia\Voice**##: голосовые подсказки | ||
| 17 | |||
| 18 | Файлы в этих папках должны иметь точно такие же имена, как оригинальные файлы в каталоге ##**SystemMedia**##. При наличии файла в ##**CustomMedia**## система использует его вместо стандартного. | ||
| 19 | |||
| 20 | Поддерживаемые форматы: | ||
| 21 | |||
| 22 | * **Изображения**: ##PNG, JPG## | ||
| 23 | * **Звуки**: ##WAV, MP3## | ||
| 24 | |||
| 25 | (% class="box infomessage" %) | ||
| 26 | ((( | ||
| 27 | **Примечание!** | ||
| 28 | Изменения применяются после перезапуска КСО. | ||
| 29 | При отсутствии файла в CustomMedia используется оригинал из SystemMedia. | ||
| 30 | ))) | ||
| 31 | |||
| 32 | == **3. Изображения товаров** == | ||
| 33 | |||
| 34 | Изображения товаров отображаются на экранах выбора товаров и в корзине. Система ищет подходящее изображение по следующему приоритету (**от высшего к низшему**): | ||
| 35 | |||
| 36 | 1. ##**CustomMedia\ProductImages\[глобальный_код_товара_на_АЗС].png**## — индивидуальное изображение конкретного товара (имя файла должно совпадать с глобальным кодом товара на АЗС, например, ##35688.png##) | ||
| 37 | 1. ##**CustomMedia\ProductGroupImages\[код_группы_АЗС].png**## — изображение группы товаров на АЗС (например, ##12.png##) | ||
| 38 | 1. ##**CustomMedia\SelfServiceGroupImages\[код_группы_КСО].png**## — изображение группы товаров в КСО (например, ##1.png##) | ||
| 39 | 1. ##**CustomMedia\ProductImages\0.png**## — кастомное изображение по умолчанию | ||
| 40 | 1. ##**SystemMedia\ProductImages\0.png**## — системное изображение по умолчанию | ||
| 41 | |||
| 42 | |||
| 43 | |||
| 44 | **Папки и назначение:** | ||
| 45 | |||
| 46 | |(% style="background-color:lightgray" %)**Папка**|(% style="background-color:lightgray" %)**Назначение**|(% style="background-color:lightgray" %)**Имя файла** | ||
| 47 | |**##CustomMedia\ProductImages##**|Индивидуальные изображения товаров|##глобальный_код_товара_на_АЗС.png## | ||
| 48 | |**##CustomMedia\ProductGroupImages##**|Изображения групп товаров АЗС|##код_группы_АЗС.png## | ||
| 49 | |**##CustomMedia\SelfServiceGroupImages##**|Изображения групп товаров КСО|##код_группы_КСО.png## | ||
| 50 | |||
| 51 | **Пример использования:** | ||
| 52 | |||
| 53 | Группа **«Напитки»** в КСО объединяет товары из разных групп АЗС: кофе, энергетики, соки. Администратор может: | ||
| 54 | |||
| 55 | * Задать **одну общую картинку** для всей группы «Напитки» в КСО — разместить файл ##1.png## в ##CustomMedia\SelfServiceGroupImages## (где 1 — код группы КСО). | ||
| 56 | * Или задать **отдельные картинки** для подгрупп АЗС: | ||
| 57 | ** Кофе → ##15.png## в ##CustomMedia\ProductGroupImages## | ||
| 58 | ** Энергетики → ##16.png## в ##CustomMedia\ProductGroupImages## | ||
| 59 | ** Соки → ##17.png## в ##CustomMedia\ProductGroupImages## | ||
| 60 | |||
| 61 | В этом случае в группе «**Напитки**» на КСО каждый товар будет показывать **свою подгрупповую картинку** (приоритет 2), а не общую. | ||
| 62 | |||
| 63 | * Поддерживаемые форматы изображения: ##PNG, JPG## | ||
| 64 | * Рекомендуемые размеры изображения: 256*256 пикс., 512*512 пикс. | ||
| 65 | |||
| 66 | == **4. Загрузка рекламных изображений для режима «Витрина»** == | ||
| 67 | |||
| 68 | Поместите рекламные изображения в каталог: | ||
| 69 | |||
| 70 | * ##CustomMedia\StoreShowcaseImages## | ||
| 71 | |||
| 72 | При размещении в каталоге нескольких изображений, их отображение будет сменяться согласно установленным настройкам КСО. | ||
| 73 | |||
| 74 | * Поддерживаемые форматы изображения: ##PNG, JPG## | ||
| 75 | * Рекомендуемые размеры изображения: 1080*1920 пикс. | ||
| 76 | |||
| 77 | == **5. Загрузка рекламных изображений для режима «Самообслуживание»** == | ||
| 78 | |||
| 79 | Поместите рекламные изображения в каталог: | ||
| 80 | |||
| 81 | * ##CustomMedia\SelfServiceImages## | ||
| 82 | |||
| 83 | При размещении в каталоге нескольких изображений, их отображение будет сменяться согласно установленным настройкам КСО. | ||
| 84 | |||
| 85 | * Поддерживаемые форматы изображения: ##PNG, JPG## | ||
| 86 | * Рекомендуемые размеры изображения: 1080*1920 пикс. | ||
| 87 | |||
| 88 |