Компонент сравнение записей Для InstantCMS 2.X.

LitCompare — это компонент который добавляет полноценную систему сравнения записей по полям и свойствам. Его задача — помочь пользователю быстро выбрать лучший вариант из нескольких похожих записей: объявлений, товаров, услуг, объектов, техники и любого другого контента с характеристиками.

Компонент собирает выбранные записи в список сравнения и выводит их на отдельной странице в виде таблицы: колонки — это записи, строки — характеристики. Пользователь сразу видит, где значения совпадают, а где отличаются, и может быстро удалить лишние позиции прямо из таблицы.

Для чего нужен

Увеличивает удобство выбора среди похожих записей.
Сокращает путь до решения: пользователь не открывает десятки вкладок, а сравнивает все в одном месте.
Повышает вовлеченность и конверсию в целевое действие за счет наглядного сравнения параметров.

Что умеет компонент

Добавление записей в сравнение из списков и из карточки записи.
Отдельная страница всех сравнений с табличным сравнением по выбранным правилам.
Подсветка отличий в таблице.
Удаление записи из сравнения без перезагрузки страницы.
Гибкая настройка, где показывать кнопку сравнения:
- в списках,
- в карточке записи.
- Виджет кнопка на всех страницах с переходом на страницу Сравнений
Настройка внешнего вида кнопки:
- выбор системной иконки,
- режим «только иконка»,
- собственный заголовок кнопки (по умолчанию: Сравнения).
Настройка лимита записей в одном сравнении.
Поддержка вывода в меню через{litcompare:list} с актуальным счетчиком.
Поддержка вывода кнопки в произвольном месте через {litcompare:button}.
Настройка поведения при наличии шорткода на странице записи (скрывать/не скрывать системную кнопку).
Группировка свойств по группам (если у свойств задана группа).
Плавная прокрутка таблицы по наведению (опционально).
Настройка иконки в левом верхнем углу таблицы:
- включить/выключить,
- загрузить изображение,
- загрузить SVG,
- приоритет SVG, если загружены оба варианта,
- настройка размера.
Хранение иконок в upload/litcompare.
Правила сравнения (главная часть логики)

Компонент работает по правилам, которые создаются отдельно для каждого типа контента и категории.

В правиле можно задать:
- Тип контента.
- Категорию.
- Поля для сравнения:
- выбрать все поля,
- либо выбрать вручную.
- Свойства для сравнения:
  - выбрать все свойства,
  - либо выбрать вручную.
Настройки шапки таблицы:
- показывать картинку,
- пресет изображения из активных пресетов выбранного типа контента,
- показывать заголовок,
- показывать дополнительное поле.
Активность правила.

Это позволяет для каждой категории задать свой «сценарий сравнения» и не смешивать нерелевантные характеристики.

Права доступа
Компонент поддерживает права для:

авторизованных пользователей,
гостей (неавторизованных).

В разделе прав есть доступ для группы гостей, поэтому можно точно управлять, кому сравнение доступно.

Хранение выбранных сравнений

Для авторизованных пользователей выбор хранится в базе и сохраняется между сессиями.
Для гостей выбор хранится в браузере и доступен до очистки данных/кэша браузера.

Шаблоны и вывод

Фронтенд-страница сравнения реализована под шаблон modern.
Стили и скрипты вынесены в отдельные файлы.
Поддерживается вывод через:
- меню {litcompare:list},
- шорткод кнопки {litcompare:button}.

Установка и удаление
При установке компонент:

создает служебные таблицы,
добавляет правило прав,
добавляет системные пункты меню Сравнения ({litcompare:list}) в нужные меню с иконкой solid:exchange-alt.

При удалении компонент:

удаляет свои таблицы,
удаляет свои пункты меню,
удаляет файлы компонента,
удаляет папку upload/litcompare со всеми загруженными файлами.

LitCompare — это не просто кнопка «сравнить», а полноценный управляемый модуль сравнения с правилами, правами, интеграцией в меню и гибкой настройкой отображения. Он подходит для проектов, где важен осознанный выбор между похожими записями и нужна удобная, масштабируемая логика сравнения.