Skip to content
Наиболее эффективный LESS компилятор для Bitrix
PHP
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
install
lang/ru/install
lib
libs/less
.gitignore
README.md
composer.json
include.php

README.md

LESS Компилятор для Bitrix

version MIT License

Простой и удобный компонент, реализующий компиляцию LESS файлов.

❗️ Компонент не подключает CSS к шаблону, а только компилирует LESS файлы. Это сделано специально для более гибкого управления подключением css-файлов.

Преимущества

  • Быстрая работа.
  • Автоматическая компиляция только изменённых файлов.
  • Генерация SourceMap.
  • Минификация CSS-кода.
  • Управление доступом к компиляции.

Установка

Шаг 1

a)

Компонент очень удобно устанавливать через composer:

composer require pafnuty/less-for-bitrix

b)

Но можно и вручную, для этого нужно положить файлы и папаки из репозитория в папку /bitrix/modules/cn.less.

Шаг 2

В админке перейти в раздел /bitrix/admin/partner_modules.php и выполнить установку решения LESS Компилятор (cn.less).

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

В нужном месте шаблона прописать вызов компонента:

<?$APPLICATION->IncludeComponent(
    "codenails:cn.less", 
    "", 
    array(),
    false
);?>

Так же можно выбрать нужный компонент при редактировании страницы:

cn.less

При необходимости можно настроить параметры.

По умолчанию компонент будет искать файл SITE_TEMPLATE_PATH/less/template_styles.less и положит скомпилированный template_styles.css в папку с текущим шаблоном сайта.

Не забывайте прописать в шаблон подключение CSS-файла, если настройки отличаются от стандартных:

<?\Bitrix\Main\Page\Asset::getInstance()->addCss('/local/assets/css/compiled_file.css');?>

Известные ошибки и недоработки

  • При изменении параметров компонента нужно либо удалять папку less_cache и скомпилированные файлы (.css и .map), либо пересохранить один из less файлов, чтобы произошла перекомпляция.
  • Для корректной работы SourseMap необходимо отключать минификацию CSS файла.

Вопросы и поддержка

Если у вас возник вопрос, или есть пожелания к улучшению компонента — воспользуйтесь формой

Куда делась старая "примочка"?

  • Живёт в ветке old и её развитие не планируется.
You can’t perform that action at this time.