ProBG Blog for OpenCart 3 - Документация
Изтеглете probg-blog-1.4.2.ocmod.zip от GitHub Release или директорията dist/.
Отворете Extensions → Installer и качете OCMOD ZIP пакета.
Отворете Extensions → Modifications и натиснете Refresh.
Отворете Extensions → Extensions → Modules и инсталирайте ProBG Blog.
Отворете ProBG Blog → Настройки и конфигурирайте основните данни, SEO, изображенията и интеграциите.
Създайте категории от ProBG Blog → Категории.
Създайте статии от ProBG Blog → Статии.
При необходимост създайте едно или повече менюта от ProBG Blog → Настройки → Меню и ги добавете в Design → Layouts.
Уверете се, че SEO URL и .htaccess са активирани в OpenCart.
Настройки
Основните настройки на модула са организирани в секции:
Общи - статус, подредба и брой статии на страница;
Данни - многоезично заглавие, описание и SEO данни за основната блог секция;
Меню - управление на неограничен брой frontend менюта;
Изображения - размери за списък, статия и галерия;
Интеграции и производителност - sitemap и кеширане.
Категории
Всяка категория поддържа:
многоезично заглавие;
HTML описание;
многоезични SEO URL, Meta Title, Meta Description и Meta Keywords;
тагове;
статус и подредба;
присвояване към магазини;
Layout Override.
Ако SEO URL е празно, модулът го генерира автоматично чрез транслитерация. Ръчно въведен SEO URL не се презаписва. При конфликт автоматично генерираният адрес получава числов суфикс.
Статии
Всяка статия поддържа:
задължителна основна категория;
многоезично заглавие;
многоезично кратко HTML описание;
многоезично пълно HTML описание;
основно изображение;
неограничени допълнителни изображения;
lightbox галерия;
многоезични SEO URL, Meta Title, Meta Description и Meta Keywords;
свързани продукти;
статус и подредба;
автоматични дати на добавяне и обновяване.
Свързаните продукти се избират чрез стандартния OpenCart autocomplete и се визуализират под съдържанието на статията.
Менюта и Layouts
В таб Меню се показва компактен списък с всички създадени менюта. Всяко меню е стандартен OpenCart module instance и може да бъде добавено независимо в Design → Layouts.
Всяко меню поддържа:
административно име;
многоезично заглавие;
статус;
Покажи линк към блога;
Покажи категории;
Покажи статии;
категория за филтриране на статиите;
лимит;
подредба по дата или sort_order;
изглед Списък или Слайдър;
при Slider - брой елементи, autoplay и интервал.
При Списък статиите се визуализират като статичен responsive grid със същите cards, използвани от слайдъра. При Слайдър се добавят стрелки, dots, autoplay, responsive брой елементи и touch swipe.
За блок с последни статии се използва системният instance ProBG Blog - Latest Articles.
Галерия и Lightbox
Допълнителните изображения към статия се показват в responsive gallery grid. При клик оригиналното изображение се отваря в lightbox с:
предишно/следващо изображение;
брояч;
затваряне с Esc;
навигация с клавиатура;
responsive поведение за мобилни устройства.
SEO и URL структура
Публичната URL структура е йерархична:
/blog /blog/category /blog/category/article
Модулът поддържа:
автоматична българска транслитерация;
ръчно зададени SEO URL адреси;
проверка за конфликт по език и магазин;
canonical адреси;
301 пренасочване към правилния йерархичен URL;
Open Graph;
Twitter Cards;
JSON-LD структурирани данни.
SEO стойностите се записват в стандартната OpenCart таблица seo_url.
Sitemap
При включена настройка ProBG Blog се интегрира със стандартния OpenCart Google Sitemap и предоставя собствен sitemap endpoint:
index.php?route=extension/feed/probg_blog_sitemap
Обновяване
При обновяване не деинсталирайте модула, защото деинсталацията премахва блог таблиците.
Качете новия OCMOD пакет през Extensions → Installer.
Отворете Extensions → Modifications и натиснете Refresh.
Отворете ProBG Blog → Настройки поне веднъж, за да се изпълнят необходимите migration стъпки.
Изчистете theme/cache при необходимост.
Деинсталация
Деинсталацията премахва блог таблиците, настройките и SEO записите на модула.
Внимание: всички въведени блог данни се изтриват.