akh/bitrix-optimization

Инструменты для оптимизации сайта на bitrix

v1.3.0 2023-02-25 22:40 UTC

Requires

• ext-exif: *

Requires (Dev)

• phpunit/phpunit: ^9.0

MIT

• Alexey Khozyaykin

• image
• bitrix
• Webp
• lazy content

README

Набор инструментов, для оптимизации сайта на bitrix

Установка

composer require akh/bitrix-optimization

Оптимизация изображений

скрипт умеет 2 вещи

• конвертация изображений в формат webp
• отложенная загрузка изображений lazyload

для конвертации в webp необходима библиотека cwebp

Использование

\Akh\BitrixOptimization\Image::initEvents($option = []);

Параметры

$option = [
    'debug' => false,
    'lazy_addJs' => false,
    'lazy_addJsBgSupport' => false,
    'lazy_active' => true,
    'lazy_background' => false,
    'lazy_dummy' => 'gif',
    'lazy_exclusions' => [
        'lazyload',
        'skip-lazy',
        'data-no-lazy',
        'data-src',
        'data-srcset',
        'data:image/',
        'data-lazyload',
        'swiper-lazy'
    ],
    'webp_active' => true,
    'webp_exclusions' => [
        'skip-webp'
    ],
    'webp_checkHref' => false,
    'webp_checkHrefExclusions' => [
        '#',
        '.css',
        '.js',
        '.html',
        '.svg',
        '.php',
        'mailto:',
        'tel:',
        'javascript:',
        'http://',
        'https://',
        '.ico',
    ],
    'webp_support' => [
        IMAGETYPE_JPEG,
        IMAGETYPE_PNG
    ],
    'webp_folder' => '/upload/webp'
];

Принудительная остановка конвертации по параметру stop_convert=Y

LazyLoad Контент

Отложенная загрузка контента
контент можно загружать сразу после загрузки страницы или же что более актуально для оптимизации, по мере того, как пользователь начинает приближаться к блоку (позиция скрола).

данный функционал полезен, чтобы скрыть изначально со страницы часть контента, к примеру блок «Вы смотрели», «Похожие товары».

Работает на основе $APPLICATION->IncludeFile()

Использование

\Akh\BitrixOptimization\LazyContent::includeFile(
	$fileDefferPath,
	$arParams = [],
	$loadOnScroll = false
);

Параметры

$arParams может содержать особые параметры

'DULL_FILE_PATH' - путь к файлу заглушки

'DATA_OFFSET_LOAD' - расстояние в px до начала загрузки контента (по умолчанию = 600)

События

После загрузки области вызывается js событие lazycontentloaded его можно использовать для инициализации скриптов

document.addEventListener('lazycontentloaded', function () {
    //some script
});

Отладка

Будучи авторизованным под админом, $_GET параметр include_lazy_content=Y будет всегда грузить включаемую область сразу