docs.modx.pro
EasyFavicon
EasyFavicon
Фавиконки из редактора RealFaviconGenerator прямо в админке MODX 2 и 3
  1. Компоненты
  2. EasyFavicon
  3. Быстрый старт

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

API-ключ ​

EasyFavicon обращается к RealFaviconGenerator с вашим ключом. Ключ бесплатный: получите его на realfavicongenerator.net/api и впишите в системную настройку easyfavicon.api_key.

Пока ключа нет, страница компонента напоминает об этом. Кнопка «Системные настройки» рядом с «Новый профиль» открывает системные настройки сразу с фильтром по EasyFavicon, ключ в разделе стоит первым.

Первый профиль ​

Откройте Пакеты → EasyFavicon и нажмите «Новый профиль». Мастер из двух шагов:

  1. Выберите картинку. Файл из медиа-хранилища MODX (кнопка «Обзор…») или абсолютный URL. Лучше всего квадратный PNG или SVG от 512×512.
  2. Как назвать и куда положить. Название видно только вам, по нему же профиль выбирается в сниппете и настройках. Каталог файлов — путь от корня сайта, по умолчанию /favicon/, / — корень. Здесь же описание, контексты (если их на сайте больше одного) и галочка «Активный профиль».

Мастер создания профиля: картинка

Мастер создания профиля: название и каталог

«Создать и собрать» сохранит профиль и сразу откроет редактор, «Только создать» — просто сохранит.

Картинку с диска EasyFavicon отправляет в сервис сам, поэтому она должна лежать внутри сайта, но не в core/, и быть настоящей картинкой: PNG, JPG, GIF, WebP или SVG. Картинку по URL сервис скачивает сам.

Сборка ​

Кнопка «Собрать фавиконку» в строке профиля спрашивает подтверждение и открывает редактор RealFaviconGenerator. Менеджер при этом закрывается.

Подтверждение перед переходом в редактор

Настройте иконки в редакторе и нажмите Generate. Браузер вернётся в MODX, а EasyFavicon скачает набор, распакует его в каталог профиля, дополнит манифест и сохранит разметку. Итог покажет уведомление менеджера. Если в редакторе вы поменяли каталог файлов, профиль запомнит новый.

Внимание

Вернуться из редактора можно только в ту сессию менеджера, где сборку начали: ссылка возврата одноразовая и живёт шесть часов. Если сессия истекла, нажмите «Собрать фавиконку» ещё раз.

Проверка ​

Разметку на страницы вставляет плагин — для активного профиля. Активный профиль отмечен включённым переключателем в столбце «Активный». Откройте любую страницу сайта и загляните в <head>.

Подробнее: Профили, Вывод на сайте.