Данная страница позволяет настроить параметры модуля 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