8  /  18

Страница настроек модуля

Данная страница позволяет настроить параметры модуля Ammina.Optimizer: Оптимизация сайта (CSS, JS, HTML, изображения)

Страница настроек модуля расположена по адресу административной части сайта: Настройки -> Настройки продукта -> Настройки модулей -> Ammina.Optimizer: Оптимизация сайта (CSS, JS, HTML, изображения)

Общие параметры

  • Не использовать оптимизацию на страницах - Выключает все виды оптимизации на указанных страницах. Правила определения страниц
  • Использовать оптимизацию для JSON данных - Позволяет оптимизировать AJAX запросы, которые возвращают JSON данные (например возвращается HTML код, или пути к файлам изображений)
  • Использовать оптимизацию на страницах AJAX запросов - Разрешает оптимизировать AJAX запросы
  • API ключ к Google PageSpeed Insights - Ключ доступа к API сервиса Google PageSpeed Insights, который позволяет проводить мониторинг параметров оптимизации непосредственно из административной части сайта. Получить ключ прямо сейчас

Настройки оптимизации CSS

  • Активировать оптимизацию CSS - Включает оптимизацию CSS файлов
  • Не использовать оптимизацию CSS на страницах - Выключает оптимизацию CSS на указанных страницах. Правила определения страниц
  • Включить CSS из файлов в качестве inline в HTML код страницы - Позволяет включить CSS стили в HTML код страницы. Не рекомендуется использовать при большом объеме CSS кода на странице
  • Поместить inline CSS из файлов перед закрывающим тегом body - При включенном режиме "Включить CSS из файлов в качестве inline в HTML код страницы" помещает Inline CSS перед закрывающем тегом BODY. Если данный параметр выключен - то размещение inline CSS начинается в месте первого подключаемого CSS файла.
  • Добавить стилю определения шрифта @font-face свойство font-display - Добавляет объявлениям веб-шрифтов в CSS файлах значение режима отображения. Рекомендуется значение fallback. Подробная информация на сайте Google
  • Минифицировать CSS файлы - При включении данного параметра файлы CSS будут минифицированы
  • Библиотека минификации CSS файлов - При помощи какой библиотеки будет производится минификация. В зависимости от написания CSS некоторые библиотеки могут некорректно производить минификацию. Мы рекомендуем использовать библиотеку Node YUI Compressor, но для ее использования необходима установка дополнительно ПО на хостинге.
  • Включить в CSS файлы изображения из файлов в виде inline кода - Прописывает в коде CSS файлы изображений, указанные в файлах CSS в виде inline кода. Позволяет сократить количество запросов к серверу и ускорить отображение сайта
  • Максимальный размер включаемого в CSS inline изображения из файла, байт - Максимальный размер файлов изображений, включаемых в виду inline кода в CSS. Рекомендуется размер не более 10 кБайт, чтобы накладные расходы не увеличивали время загрузки файлов стилей.
  • Не оптимизировать CSS файлы - Исключает из объединения всех CSS файлов в один данные файлы. Правила определения страниц
  • Не минимизировать CSS файлы - Выключает минимизацию данных CSS файлов. Правила определения страниц
  • Отправлять заголовок Link для предзагрузки CSS файлов - Автоматически отправляет заголовок предварительной загрузки оптимизированного CSS файла после получения браузером посетителя заголовка (вместо загрузки данного файла после анализа HTML кода страницы браузером)
  • Путь к исполняемому файлу YUI Compressor - При использовании библиотеки Node YUI Compressor необходимо указать полный путь к файлу yuicompressor. При глобальной установке данного NPM модуля, чаще всего, нет необходимости менять данный параметр.
  • Оптимизировать CSS файлы со сторонних сайтов - Включает обработку CSS файлов с других сайтов. В этом случае данные файлы будут закэшированы на сервере, оптимизированы и объединены с основным файлом оптимизации.
  • Исключить из оптимизации CSS файлы со сторонних сайтов - Исключает их оптимизации CSS файлы с других сайтов. Правила определения страниц
  • Тип обработки подключенный шрифтов Google Fonts - Если на странице используется подключение шрифтов GoogleFonts, то можно включить данную опцию. ВНИМАНИЕ! Опция является экспериментальной. Рекомендуется включать данную опцию в режиме «Обработать и вставить как Inline CSS» и оценивать накладные расходы от включения данной опции и выигрыш производительности. Кроме того необходимо периодически очищать кэш в папке /bitrix/cache/css/ammina.optimizer/SITE_ID/googlefonts/ (в зависимости от свободного места и посещаемости сайта от 1 дня до 1 месяца). В следующих версиях модуля выйдет агент для автоматической очистики данного кэша.

Настройки оптимизации JS

  • Активировать оптимизацию JS - Включает оптимизацию JavaScript файлов
  • Не использовать оптимизацию JS на страницах - Выключает оптимизацию JS файлов на указанных страницах. Правила определения страниц
  • Минифицировать JS файлы - При включении данного параметра файлы JS будут минифицированы
  • Библиотека минификации JS файлов - При помощи какой библиотеки будет производится минификация. В зависимости от написания JS, некоторые библиотеки могут некорректно производить минификацию. Мы рекомендуем использовать библиотеку Node Uglify JS, но для ее использования необходима установка дополнительно ПО на хостинге.
  • Не оптимизировать JS файлы - Исключает из объединения всех JS файлов в один данные файлы. Правила определения страниц
  • Не минимизировать JS файлы - Выключает минимизацию данных JS файлов. Правила определения страниц
  • Отправлять заголовок Link для предзагрузки JS файлов - Автоматически отправляет заголовок предварительной загрузки оптимизированного JS файла после получения браузером посетителя заголовка (вместо загрузки данного файла после анализа HTML кода страницы браузером)
  • Дополнительная обработка файлов ядра при подключении сторонних библиотек не через $APPLICATION->AddHeadScript(); - опция включает дополнительную обработку JS файлов при нештатном подключении JS файлов. Данная опция устраняет ошибку в консоли JavaScript вида «BX.debug: Arguments { 0: "message undefined: .....", ...}»
  • Путь к исполняемому файлу UglifyJS - При использовании библиотеки Node Uglify JS необходимо указать полный путь к файлу uglifyjs. При глобальной установке данного NPM модуля, чаще всего, нет необходимости менять данный параметр.
  • Путь к исполняемому файлу YUI Compressor - При использовании библиотеки Node YUI Compressor необходимо указать полный путь к файлу yuicompressor. При глобальной установке данного NPM модуля, чаще всего, нет необходимости менять данный параметр.
  • Оптимизировать JS файлы со сторонних сайтов - Включает обработку JS файлов с других сайтов. В этом случае данные файлы будут закэшированы на сервере, оптимизированы и объединены с основным файлом оптимизации.
  • Исключить из оптимизации JS файлы со сторонних сайтов - Исключает их оптимизации JS файлы с других сайтов. Правила определения страниц

Настройки оптимизации изображений «на лету»

  • Активировать оптимизацию изображений - Включает оптимизацию изображений
  • Не использовать оптимизацию изображений на страницах - Выключает оптимизацию изображений на указанных страницах. Правила определения страниц
  • Не оптимизировать изображения - Выключает оптимизацию указанных изображений. Правила определения страниц
  • Активировать поддержку WebP изображений - При включенной опции, если браузер пользователя поддерживает формат WebP для изображений, файлы изображений будут преобразованы и отправлены пользователю в данном формате. Во всех остальных случаях, файлы изображений будут оптимизированы библиотекой PHP IMagick.
  • Качество сохраняемого изображения - С каким качеством сохранять оптимизированные изображения. Рекомендуется значение от 60 до 85.
  • Активировать оптимизацию изображений в теге IMG - Включает оптимизацию изображений, находящихся в теге IMG.
  • Активировать оптимизацию изображений, указанных в правилах background[-image] - Если изображения прописаны в HTML коде в виде фоновых изображений в свойстве style, то данный параметр включает их оптитмизацию.
  • Активировать оптимизацию изображений, указанных в коде, как заключенные в кавычки и находящиеся в папке /upload/ - Данный параметр включает поиск всех изображений в HTML коде страницы, которые находятся в каталоге /upload/ и оптимизирует их
  • Активировать преобразование файлов PNG из каталога /upload/ в JPG формат - преобразует изображения из каталога /upload/ в формате PNG в формат JPG/WebP.
  • Активировать преобразование файлов GIF из каталога /upload/ в JPG формат - преобразует изображения из каталога /upload/ в формате GIF в формат JPG/WebP.
  • Также преобразование файлов из каталогов - Так же преобразует файлы в формат JPG/WebP из данных каталогов.
  • Оптимизировать файлы изображений со сторонних сайтов - Включает обработку файлов изображений с других сайтов. В этом случае данные файлы будут закэшированы на сервере, оптимизированы и будут доступны для посетителей непосредственно с сайта.
  • Исключить из оптимизации файлы изображений со сторонних сайтов - Исключает их оптимизации файлы изображений с других сайтов. Правила определения страниц

Настройки оптимизации HTML

  • Активировать оптимизацию HTML - Включает минификацию HTML кода. Включение данной опции возможно, но не всегда рекомендуется, т.к. накладные расходы минификации могут привысить выигрыш по времени от такой минификации
  • Не использовать оптимизацию HTML на страницах - Выключает оптимизацию JS файлов на указанных страницах. Правила определения страниц
  • Библиотека минификации HTML файлов - При помощи какой библиотеки будет производится минификация. В зависимости от HTML кода, наличия inline CSS и JS в коде страницы мы рекомендуем использовать библиотеку PHP Wee для минификации HTML кода.
  • Сжимать inline JS (для библиотек PHPWee и Node HTML-Minifier) - При включении данного параметра также будет проведена минификация JS кода, расположенного непосредственно в коде страницы
  • Сжимать inline CSS (для библиотек PHPWee и Node HTML-Minifier) - При включении данного параметра также будет проведена минификация CSS, расположенного непосредственно в коде страницы
  • Путь к исполняемому файлу HTML-Minifier - При использовании библиотеки Node HTML-Minifier необходимо указать полный путь к файлу html-minifier. При глобальной установке данного NPM модуля, чаще всего, нет необходимости менять данный параметр.

Дополнительные опции

  • Дополнительные заголовки Link (каждый с новой строки) - Отправляет дополнительные заголовки предзагрузки Link. Примеры использования:

    для файлов стилей:

    <ПУТЬ_К_ФАЙЛУ_СТИЛЕЙ>; rel=preload; as=style

    для файлов скриптов:

    <ПУТЬ_К_ФАЙЛУ_СКРИПТА>; rel=preload; as=script

    для файлов шрифтов:

    <ПУТЬ_К_ФАЙЛУ_ШРИФТА>; rel=preload; as=font; crossorigin
  • Очистить кэш файлов CSS и JS - После сохранения настроек очищает кэш оптимизированных CSS и JS файлов

Правила определения страниц

Для определения страниц, указанных в настройках, может применяться любой из 3-х способов для каждого правила (с новой строки):

полное совпадение текущей страницы от корня сайта:

/mypagepath/file.php

частичное совпадение с текущей страницы:

PART:pagepathpart

регулярное вырожение preg для сравнения с текущей страницы:

PREG:preg_regular_text