Настройка
Обновлено
Настройки плагина
Откройте настройки «Изображения пунктов меню» в приложении «Управление меню», затем вкладку «Настройки плагина». Изменения переключателей сохраняются автоматически.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Статус плагина | Разрешает получение изображений через хелперы. При выключении getImage() возвращает пустую строку, getImages() — пустой массив |
Включено / выключено; при установке включено |
| Временная метка | При загрузке добавляет уникальную часть к имени файла, чтобы новая загрузка не использовала прежний адрес из кеша браузера | Включено / выключено; при установке включено |
| Эскизы изображений @2x | При создании растрового эскиза создаёт дополнительную версию с удвоенными размерами. Требует дополнительной памяти и места для файлов | Включено / выключено; при установке включено |
| Эскизы произвольных размеров | При вызове хелпера создаёт отсутствующий растровый эскиз размера, указанного в вызове, даже если размера нет в группе | Включено / выключено; при установке включено |
«Временная метка» действует при загрузке файлов. Переключение «Эскизы изображений @2x» само по себе не пересоздаёт ранее загруженные изображения.
Добавление группы
Группа связывает изображение в пункте меню с его назначением в теме. Например, у пункта могут быть отдельные группы для маленькой иконки и крупной иллюстрации.
На вкладке «Добавить группу» заполните поля и нажмите «Добавить».
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Уникальный идентификатор группы | Используется в вызовах хелперов для выбора группы | Непустая строка, уникальная среди групп; в новой форме пусто |
| Название группы | Отображается в настройках и области загрузки пункта меню | Непустая строка; в новой форме пусто |
| Описание группы | Пояснение к группе в её карточке настроек | Текст; в новой форме пусто |
При совпадении идентификатора сервер возвращает «Группа с таким идентификатором уже существует».
Изменение и удаление группы
На вкладке «Группы изображений» включите «Редактировать» в карточке группы. После изменения полей нажмите «Обновить».
Если изменили идентификатор, обновите его и в шаблонах темы. Название группы не заменяет идентификатор в вызове хелпера.
«Удалить группу» удаляет саму группу, её размеры и связанные изображения, включая файлы оригиналов и эскизов. Используйте эту кнопку только для ненужной группы.
Размеры эскизов
В карточке группы на вкладке «Группы изображений» задайте размер и нажмите «Добавить».
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Ширина изображения | Ширина растрового эскиза в пикселях | Число от 0; в форме 0 |
| Высота изображения | Высота растрового эскиза в пикселях | Число от 0; в форме 0 |
Оба значения не могут одновременно равняться 0. Интерфейс также проверяет, не существует ли уже такой размер в группе.
64x64— квадрат с обрезкой.200x100— прямоугольник заданных пропорций с обрезкой.200x0— ширина 200 пикселей, высота по пропорциям оригинала.0x100— высота 100 пикселей, ширина по пропорциям оригинала.
Добавление размера запускает создание эскизов для уже загруженных растровых изображений этой группы. SVG пропускаются.
Крестик на метке размера удаляет размер из группы и его обычные и @2x-эскизы. Оригинал сохраняется. Если «Эскизы произвольных размеров» включены, последующий вызов хелпера с удалённым размером может создать эскиз снова.