ПОСМОТРЕТЬ ДЕМО
Модуль можно оценить вживую, ничего не устанавливая:
Демо: все шаблоны на одной странице
На демо-странице собраны 15 готовых блоков — пять шаблонов отображения, светлый, тёмный и выключенный фон, автоматические фирменные цвета кнопок под маркетплейсы, единицы измерения у цены и маркировка «Реклама». Страница адаптивна: откройте её с телефона, чтобы увидеть, как блоки перестраиваются на узком экране.
НАЗНАЧЕНИЕ
У магазина есть трафик, но не весь ассортимент выгодно возить самому. Часть позиций проще отдать партнёрам и зарабатывать на переходах. То же с обзорными статьями, подборками и страницами брендов: там уместна рекламная выдача, но собирать её вручную в HTML долго, а результат разъезжается на мобильных и теряется при смене шаблона.
Отдельная проблема — маркировка. Реклама на сайте требует пометки «Реклама» с идентификатором ERID, данными рекламодателя и ИНН. Проставлять это вручную у каждого блока неудобно и легко забыть.
Affiliate CPA Blocks решает обе задачи. Рекламные блоки создаются в собственной панели: карточка = ссылка, изображение, название, цена, кнопка. Готовый блок вставляется в любое место сайта шорткодом, через макеты или из шаблона темы. Маркировка задаётся один раз на блок и выводится автоматически.
КОМУ ПОДХОДИТ
- Магазинам, работающим с партнёрскими программами маркетплейсов и CPA-сетей: заработок на переходах по позициям, которых нет на складе. - Контентным проектам при магазине — обзорам, подборкам, статьям блога, где нужна аккуратная монетизируемая выдача товаров. - Тем, кто продаёт рекламные места сторонним рекламодателям: маркировка ERID / рекламодатель / ИНН предусмотрена на уровне креатива. - Магазинам с услугами и позициями, которые считаются в квадратных метрах, погонных метрах, кубах, комплектах: единица измерения задаётся на карточку.
РЕКЛАМНЫЕ БЛОКИ
Блок — это набор карточек с общими настройками показа. Управление блоками вынесено в отдельный раздел админ-панели, отдельная страница настроек для каждой позиции макета не требуется.
Поля карточки: ссылка, изображение, название, цена, старая цена, единица измерения, текст кнопки, цвет кнопки, стикер с цветом, рейтинг, число отзывов, переключатель показа.
- Автоопределение площадки по ссылке. Для известных платформ (Ozon, Wildberries, Яндекс Маркет, DNS, Ситилинк, ВсеИнструменты, Лемана ПРО, AliExpress, Amazon, eBay) цвет кнопки подставляется в цвет бренда. Для CPA-офферов и собственных ссылок цвет задаётся вручную. - Порядок карточек меняется перетаскиванием. - Изображения выбираются штатным менеджером файлов OpenCart, поддерживается формат WebP. - Единица измерения выводится рядом с ценой: «1 990 ₽ за м²», «за пог. м», «за услугу» и другие.
ШАБЛОНЫ ОТОБРАЖЕНИЯ
Пять готовых шаблонов, каждый адаптирован под мобильные устройства:
- Стандартный — сетка карточек, число колонок настраивается. - Компактный — плотный список для узких мест и боковых панелей. - Горизонтальный — крупные акцентные карточки; на мобильных перестраивается в плитку по две в ряд. - Вертикальный — одна узкая колонка для сайдбара. - Карусель — горизонтальная прокрутка при большом числе позиций.
Формат фотографий выбирается на уровне блока: квадрат 1:1 или вертикальный 3:4 как на маркетплейсах. Выбранная пропорция соблюдается во всех шаблонах и на всех разрешениях, изображения не искажаются.
Фон блока настраивается отдельно: включается и выключается переключателем, цвет выбирается произвольно. При тёмном фоне карточки автоматически переключаются на тёмное оформление — контраст сохраняется без ручной настройки. С выключенным фоном блок сливается со страницей.
СПОСОБЫ ВЫВОДА
1. Шорткод — [promo id="1"] в описании товара, категории, информационной страницы или статьи. Работает в том числе в блогах сторонних модулей и в блогах, встроенных в шаблон, поскольку обрабатывается готовый HTML страницы, а не конкретное поле в базе. 2. Дизайн → Макеты — блок доступен как модуль и ставится в любую позицию макета. Инстанс создаётся автоматически при сохранении блока. 3. Twig — вызов {{ promo(1) }} прямо в файле шаблона темы для точной вставки в вёрстку.
Шорткод принимает необязательные параметры: template (шаблон отображения) и limit (число карточек). Один блок допускается размещать в любом количестве мест, правки применяются везде одновременно.
МАРКИРОВКА РЕКЛАМЫ
ERID, наименование рекламодателя и ИНН задаются на блок, то есть на креатив, и выводятся под карточками пометкой «Реклама». Вывод отключается переключателем.
Все внешние ссылки формируются с атрибутами rel="nofollow sponsored noopener noreferrer" и открываются в новой вкладке: ссылочный вес не передаётся, переход по партнёрской ссылке не влияет на продвижение магазина.
РАСПИСАНИЕ И РОТАЦИЯ
- Период показа: даты начала и окончания. Вне периода блок не выводится. - Ротация: показ всех карточек либо случайных N карточек при каждой загрузке. - Переключатель статуса у блока и у каждой карточки в отдельности.
СТАТИСТИКА
Для каждого блока ведётся учёт показов и кликов:
- показы, клики, CTR и дата последней активности; - самая кликабельная карточка; - разбивка по дням за последние 30 суток; - сброс статистики по блоку.
Показы и клики фиксируются на стороне браузера, поэтому учёт продолжает работать и на сайтах с полностраничным кэшированием.
СОВМЕСТИМОСТЬ
- OpenCart 3.0.x, ocStore 3.0.x - PHP 7.0 – 8.1 (рекомендуется 7.4) - Расширения PHP: GD, mbstring, json (входят в стандартный набор хостинга) - MySQL 5.6+ / MariaDB - Установка штатными средствами через раздел «Установка расширений» (файл ocmod), правка кода не требуется.
Модуль работает на любом шаблоне витрины, включая покупные. Файл вывода размещён в теме default и подхватывается штатным механизмом наследования тем OpenCart. Стили и скрипты встроены в сам блок и подключаются один раз на страницу — внешних файлов нет, конфликты со сборщиками стилей шаблона исключены. Все классы имеют собственный префикс, оформление темы и оформление блока не влияют друг на друга.
Родные файлы движка не заменяются. Три точечные правки вносятся механизмом OCMOD и помечены как необязательные: при нестандартной сборке установка не прерывается, а неприменённая правка не нарушает работу модуля.
ПРОИЗВОДИТЕЛЬНОСТЬ
- Блок, размещённый на странице несколько раз, читается из базы один раз. - Стили и скрипты выводятся однократно, а не с каждым блоком. - Обработчик шорткодов завершается немедленно, если на странице нет подстроки шорткода. - Изображения обрабатываются штатным механизмом ресайза: файл создаётся один раз и далее отдаётся с диска. - Статистика хранится дневной свёрткой, а не журналом событий.
ЛИЦЕНЗИРОВАНИЕ
Лицензия привязывается к доменному имени. После установки в панели модуля отображается домен магазина, для которого запрашивается и активируется ключ. Ключ основного домена действует также на технических поддоменах (test, dev, staging и подобных), что позволяет использовать одну лицензию на рабочем сайте и его тестовой копии.
КЛЮЧЕВЫЕ ПРЕИМУЩЕСТВА
- Монетизация трафика партнёрскими ссылками без ручной вёрстки блоков. - Соответствие требованиям к маркировке рекламы из коробки. - Ссылочный вес магазина не передаётся партнёрам. - Три способа вывода, включая работу в сторонних блогах. - Корректное отображение на любом шаблоне и на мобильных устройствах. - Собственная панель управления блоками и статистика эффективности.
Подробности об установке, требованиях и ответы на частые вопросы приведены в файлах УСТАНОВКА.txt и README_RU.md. Условия использования — в файле LICENSE_RU.txt.