ПОДИВИТИСЯ ДЕМО
Модуль можна оцінити наживо, нічого не встановлюючи:
Демо: всі варіанти блоків на одній сторінці
На демо-сторінці зібрано 29 готових блоків: шість макетів, чотири формати зображення, різне число колонок, світла та темна підкладка, свої стікери та перевизначення. Під кожним блоком вказано, якими параметрами він зібраний. Сторінка адаптивна: відкрийте її з телефону - блоки перебудують у дві колонки.
ПРИЗНАЧЕННЯ
Штатний OpenCart показує категорії лише на своїх сторінках. Як тільки потрібно вставити добірку розділів до оглядової статті, на посадкову сторінку або опис товару — починається ручна верстка. HTML доводиться переробляти щоразу, коли в каталозі змінилася назва,додався розділ або змінилася картинка. На мобільних така верстка роз'їжджається, а при зміні шаблону остаточно ламається.
Category Blocks Builder прибирає цю роботу. Блок налаштовується один раз, а на сторінку ставиться рядок [catblock id="1"]. Далі блок живе сам: дані беруться з каталогу при кожному показі, оформлення виглядає однаково на будь-якому шаблоні і на будь-якому екрані.
КОМУ ПІДХОДИТЬ?
- Магазини з контентом: огляди, добірки, гайди, статті блогу - скрізь, де після тексту доречний блок «де це купити». - Проекти з посадочними сторінками під запити: на сторінці збирається потрібна вибірка розділів замість ручного списку посилань. - Магазини з великим каталогом: блок «всі підкатегорії розділу» оновлюється сам, коли каталог поповнюється. - Тим, хтоперебирає оформлення: шість макетів і чотири формати фото перемикаються в пару кліків, без правки верстки.
ЯК ЗБИРАЄТЬСЯ БЛОК?
Блок — це набір категорій із загальними параметрами показу. Керування винесене в окремий розділ адмін-панелі, окрема сторінка налаштувань для кожної позиції макету не потрібна.
Три джерела категорій:
- Вибрані вручну. Дерево категорій з чекбоксами, пошуком за назвою та лічильником товарів у кожної гілки. Порядок задається перетягуванням. - Усі підкатегорії вибраного розділу. Блок оновлюється сам: з'явилася нова підкатегорія в каталозі - вона одразу в блоці. - Усі кореневі категорії магазину, автоматично.
ШІСТЬ МАКЕТІВ
Макет вибирається наочно плитками з мініатюрою розкладки, а нерядком у списку, що випадає. Кожен адаптований під мобільні пристрої:
- Плитка – класична сітка, кількість колонок налаштовується. Універсальний варіант статті. - Картки з описом – великі картки з текстом та списком підкатегорій, коли потрібно розповісти про розділ. - Список – горизонтальні рядки: фото зліва, опис у центрі, кнопка праворуч. Економить висоту сторінки. - Компактні чіпи - тільки назва та кількість товарів. Для блоку "де купити" прямо всередині абзацу. - Обкладинки – фото на всю картку, назву та лічильник поверх затемнення. Найпомітніший варіант для початку статті. - Карусель – горизонтальна стрічка зі стрілками та прокруткою свайпом.
Вважаючи формат фото та кількість колонок, виходить близько 280 візуально різних видів блоку – і це без урахування кольорів та стікерів.
ЗОБРАЖЕННЯ
Формат задається лише на рівні блоку: квадрат 1:1, широкий 16:9, вертикальний 3:4 чи коло. Вибрана пропорція дотримується у всіх макетах та на всіх дозволах, зображення не спотворюються.
- Кадрування центром. Якщо у категорій завантажені фото різних пропорцій, модуль приводить їх до одного формату - рядок не роз'їжджається. Штатними засобами OpenCart так не виходить: ядро вміє лише вписувати зображення та добивати поля тлом. - Фото із товару. У категорії не задана картинка - підставляється фотографія першого товару з неї. Блок не виглядає пустим. - Режим "вписати повністю" - коли фотографію важливо показати повністю.
ЗМІСТ КАРТКИ
Перемикачами налаштовується, що показувати: зображення, кількістьтоварів, опис категорії, перелік підкатегорій, кнопку переходу.
- Лічильник товарів вважається з урахуванням вкладених категорій або лише за самою категорією - на вибір. Число схиляється правильно: 1 товар, 2 товари, 13 товарів. - Опис береться з категорії, HTML вирізається, текст обрізається межі слова до заданої довжини. - Підкатегорії виводяться посиланнями усередині картки з позначкою «Ще N». - Порожні категорії можна приховувати, порядок виведення – вручну, за назвою, за кількістю товарів чи як у каталозі.
ПЕРЕВИЗНАЧЕННЯ
Для кожної категорії всередині блоку можна встановити свою назву, своє фото, свій підпис, стікер з кольором і навіть власне посилання — наприклад, на огляд замість сторінки категорії. Сам каталог при цьому не змінюється: одна і та ж категорія врізних блоках може виглядати по-різному.
ЖИВИЙ ПЕРЕГЛЯД
Вкладка «Перегляд» показує блок так, як його побачить покупець: це справжня сторінка вітрини, а не імітація в адмінці. Перемикачі «Десктоп/Планшет/Телефон» перевіряють адаптивність, не виходячи з налаштувань. Макет і кількість колонок застосовуються відразу, інші налаштування після збереження.
Адреса сторінки попереднього перегляду підписана ключем: стороннім вона віддає 404 і в пошукову видачу потрапити не може.
СПОСОБИ ВИСНОВКУ
1. Шорткод - [catblock id="1"] в описі товару, категорії, інформаційної сторінки або статті. Працює в тому числі у блогах сторонніх модулів та у блогах, вбудованих у шаблон, оскільки обробляється готовий HTML сторінки, а небезпосереднє поле в базі. 2. Дизайн → Макети – блок доступний як модуль і ставиться у будь-яку позицію макета. Інстанс створюється автоматично під час збереження блоку. 3. Twig - виклик {{ catblock(1) }} прямо у файлі шаблону теми для точної вставки у верстку.
Шорткод приймає необов'язкові параметри columns (кількість колонок) і limit (скільки категорій показати). Один блок допускається розміщувати в будь-якій кількості місць, редагування застосовуються скрізь одночасно. Щоб показати шорткод у тексті як приклад, а не вивести блок, дужки подвоюються: [[catblock id="1"]].
ОФОРМЛЕННЯ
- Акцентний колір - кнопки, лічильники та наведення перефарбовуються під магазин. - Підкладка блоку: вмикається перемикачем, колір довільний. При темній підкладці картки автоматично перемикаються натемне оформлення - контраст зберігається без ручного налаштування. - Заголовок та підзаголовок над блоком задаються в налаштуваннях, окремий текст у статті не потрібен.
СУМІСНІСТЬ
- OpenCart 3.0.x, ocStore 3.0.x
- PHP 7.1 – 8.3 - Розширення PHP: GD, mbstring, json (входять до стандартного набору хостингу)
- MySQL 5.6+ / MariaDB - Установка штатними засобами через розділ «Установка розширень» (файл ocmod), редагування коду не потрібно.
Модуль працює на будь-якому шаблоні вітрини, включаючи покупні. Файл виведення розміщений у темі default і підхоплюється штатним механізмом наслідування тем OpenCart. Якщо тема захоче своє оформлення, досить покласти до неї однойменний файл стилів - модуль підхопить його сам. Усі класи мають власний префікс, оформлення теми таоформлення блоку впливають друг на друга.
Рідні файли двигуна не замінюються. Дві точкові правки вносяться механізмом OCMOD і помічені як необов'язкові: при нестандартному складанні установка не переривається, а незастосована правка не порушує роботу модуля.
ПРОДУКТИВНІСТЬ
- Усі вибірки пакетні: категорії, лічильники, підкатегорії та запасні картинки читаються фіксованою кількістю запитів незалежно від того, скільки категорій у блоці. - Блок, розміщений кілька разів на сторінці, читається з бази один раз. - стилі виводяться одноразово, а не з кожним блоком; зовнішніх бібліотек немає. - Обробник шорткодів завершується негайно, якщо на сторінці немає підрядка шорткоду. - Кадровані зображення створюються один раз і віддаються з диска. - Завмер натестовому магазині: сторінка з 29 блоками рендериться за 0,43 с проти 0,30 с у такої ж сторінки без блоків.
ЛІЦЕНЗУВАННЯ
Ліцензія прив'язується до доменного імені. Після встановлення в розділі "Ліцензія" внизу сторінки модуля відображається домен магазину, для якого запитується та активується ключ. Ключ основного домену діє також на технічних піддоменах (test, dev, staging та подібних), що дозволяє використовувати одну ліцензію на робочому сайті та його тестову копію.
До введення ключа модуль заблоковано: блоки не створюються та не редагуються.
КЛЮЧОВІ ПЕРЕВАГИ
- Категорії у статтях та на посадкових сторінках без ручної верстки. - Дані завжди актуальні: назви, фото та лічильники беруться з каталогу. - Шістьмакетів та чотири формати фото — близько 280 видів блоку. - Кадрування центром: різні пропорції фотографій не ламають ряд. - Перевизначення для кожної категорії без зміни каталогу. - Живий перегляд з перевіркою на телефоні та планшеті. - Коректне відображення на будь-якому шаблоні та на мобільних пристроях.
Подробиці про встановлення, вимоги та відповіді на часті запитання наведені у файлах УСТАНОВКА.txt та README_UA.md. Умови використання – у файлі LICENSE_RU.txt.