README

За допомогою CombaCart можна створити повноцінний інтернет-магазин чи маркетплейс (декілька Продавців на одному сайті) на базі EVO 1.4+ чи Evolution CMS 3.+, та керувати Замовленями покупців.

Важливо: для редагування розширених властивостей товарів використовуйте окремі плагіни чи модулі (multiTV та подібні)

Для Покупця:

перегляд, додавання та редагування Товарів у Кошику, та подальше оформлення Кошика в Замовлення покупця.
сторінка Відстеження та Оплата замовлення.
онлайн оплата та отримання callback відповіді через LiqPay.
перегляд історії Замовлень (персональний кабінет). Реєстрацію та авторизацію користувача робіть засобами Evolution CMS або через спеціалізований плагін, наприклад HybridAuth.
підтримка багатомовності: Українська, Англійська.

Для Менеджера:

керування Замовленнями покупців на окремій сторінці, за замовчуванням //ваш_сайт/comba
перегляд, редагування, зміна статусів обробки та друк Замовлення
відправлення текстових повідомлень через пошту, смс, текст для месенджерів.

Для Адміністратора:

автоматичне прибирання Товару з Кошиків, якщо з товару знято Доступен до замовлення ( редагування сторінки Товару в адмінці (evo))
для кожного товару можна задати свого Продавця
Продавець це окрема юридична особа або ФОП зі своїми налаштуваннями.
при оформленні Кошика автоматично сформуються декілька Замовлень якщо Товари у кошику від різних Продавців (опціонально)

Мінімальна технічна конфігурація

PHP 7.4 та вище

Composer

EVO 1.4+ або Evolution CMS 3.+

Встановлення

Варіант 1 - повна інсталяція через Extras (рекомендовано)

завантажте останній реліз або архів CombaCart з github.com
авторизуйтесь в адміністративній частині evolution cms (/manager)
запустіть модуль Extras, перейдіть до опції «Install by file», виберіть архівний файл і натисніть «Install».
після закінчення процесу інсталяції архіву авторизуйтесь в консолі вашого веб серверу та виконайте оновлення залежностей через composer

cd _коренева_тека_вашого_сайту_/assets/plugins/combacart

composer update

Варіант 2 - оновлення файлів через консоль

завантажте та розпакуйте архів CombaCart github.com та перезапишіть файли в /assets/plugins/combacart .
виконайте в консолі оновлення компонентів вказаних в composer.json

cd _коренева_тека_вашого_сайту_/assets/plugins/combacart

composer update

Файл composer.json містить перелік компонентів що використовується в CombaCart. ви можете прибрати зайві, на ваш розсуд, залежності та модифікувати шаблони за потреби.

Налаштування

файл /src/Config/config.php

містить основні шляхи та глобальні константи для роботи плагіну. не змінюйте їх без нагальної потреби.

файл /assets/custom/Config/config_custom.php

містить ваші дані аутентифікації до стороніх сервисів, наприклад:
- НоваПошта
- LiqPay
- смс провайдер
- та інші

файл /src/Bundle/BuildInServer/Server.php

містить методи та масиви з даними, і саме ці дані редагуйте під свої потреби:

метод marketplace()
- повертає загальні налаштування інтернет магазину/маркетплейсу (формальна різниця між ІМ та М: ІМ може мати одного Продавця, а маркетплейс може зберігати декілька Продавців)
метод sellers()
- повертає дані по Продавцях (публічні дані)
- Продавці крім основних параметрів містять посилання на Отримувачів оплат
метод payee()
- повертає дані Отримувачів оплат
- Отримувачі оплат це юридичнф особи чи ФОПм з типами оплат які вони підтримують
метод delivery()
- повертає перелік типів доставок
метод payment()
- повертає перелік типів оплат

Перші кроки після закінчення інсталяції та налаштувань

При інсталяції через Extras будуть створені необхідні елементи, а саме :
- шаблон для сторінки товару goods_tmplt
- шаблон для сторінки оформлення замовлення checkout_tmplt
- tv
  - goods_avail ознака чи доступний товар до замовлення
  - goods_code актикул товару (sku)
  - goods_price ціна товару
  - goods_price_old стара ціна товару
  - goods_weight вага товару
  - goods_isnewproduct ознака "новий товар"
  - goods_isondemand ознака "товар під замовлення"
  - goods_seller Продавець товару
  - goods_inbalances ознака залежності товару від залишків
  - goods_images містить перелік зображень.
  - для frontend завжди повертається шлях до зображення з assets/cache
  - якщо використовується multiTV, запуск сніпету [[GoodsImage]] без параметрів повертає шлях до першого зображення
  - якщо запустити сніпет ось так [[GoodsImage? &imgsrc=`[*goods_images*]`]] поверне шлях [goods_images] враховуючі кеш та інші налаштування, наприклад розміри.
  - goods_goods містить перелік видів товару (опціонально), використовує multiTV
- сніпети, в тому числі:
  - snippetOrderPay для показу сторінки з варіантами оплат
  - snippetOrderTracking для показу статусу обробки замовлення
До шаблона goods_tmplt привяжіть TV goods_avail, goods_code, goods_price, goods_price_old, goods_weight, goods_isnewproduct, goods_isondemand, goods_seller
Створіть нову сторінку (документ), задайте їй шаблон goods_tmplt. Це буде ваш перший товар. Код товару (артикул) має бути унікальним в контексті сторінки (документа).
Створіть сторінку з псевдонімом (alias) checkout та задайте їй шаблон checkout_tmplt . Це буде сторінка оформлення замовлення. якщо використовуєте інший псевдонім то внесіть його в константу COMBAMODX_PAGE_CHECKOUT в файлі /src/Config/config.php
Створіть сторінку з псевдонімом (alias) tnx на яку буде перенаправлено користувача після створення замовлення. якщо використовуєте інший псевдонім внесіть його в константу COMBAMODX_PAGE_TNX в файлі /src/Config/config.php у разі відсутності такої сторінки буде перехвачено OnPageNotFound та відображенно текст з /src/Bundle/Modx/Cart/templates/chunk-CheckoutTnx
Створіть сторінку з псевдонімом (alias) cabinet та задайте їй вміст ресурсу [[CombaHelper? &action=`cabinet`]]. Ця сторінка відображує історію замовлень покупця.

Інше: Options::detectLanguage() визначає поточну мову та керує завантаженням перекладів. до прикладу файл з українською мовою /assets/lang/uk.php

Обробка замовлень

Після того як кліент сформував Замовлення (Кошик з товарами відправлено до обробки менеджерами Макретплейса), замовлення можна подивитись на сторінці керування. Доступ до сторінки має будь-якій користувач з ролю 'manager' що пройшов авторизацію через адміністративну сторінку EVO (//ваш_сайт/manager). Відкрити сторінку керування замовленнями можна за посиланням http(s)://назва_сайту/comba На сторінці керування можна:

передивлятись перелік замовлень за будь-який час
вести пошук замовлень за номером, Замовником та його електроною поштою
редагувати замовлення
друкувати замовлення
надсилати електронні листи, смс повідомлення та формувати тексти для подальшого пересилання в сторонніх месенджерах

Присутня можливість зміни мови та теми інтерфейсу.

Залежності та вимоги до налаштувань

якщо отримуєте помилку Class 'IntlDateFormatter' not found встановіть та активуйте extension php_intl
twig (необхідно) *наявно в composer.json https://twig.symfony.com/ CombaCart використовує twig для шаблонів (після обробки даних парсером Modx/Evo)
boostrap,bootstrap-icon (необхідно,опціонально) *наявно в composer.json верстка СombaCart використовує bootstrap 5.
https://getbootstrap.com/

якщо маєте наявну копію bootstrap змінить шляхи до вашого bootstrap в файлі snippetGoodsFooter.php

bootbox.js (опціонально) *наявно в пакеті інсталяції для роботи з діалоговими формами bootstrap https://bootboxjs.com/
phpthumb (необхідно) *встановлюється з extras якщо користуєтесь іншим обробником зображень ніж phpthumb змінить файл snippetGetImage.php під свої потреби.
claviska\SimpleImage (опціонально) *наявно в composer.json composer require claviska/simpleimage
cropper.js (опціонально) *наявно в пакеті інсталяції опис по налаштуванню cropper https://github.com/extras-evolution/multiTV
venobox (опціонально) *наявно в пакеті інсталяції для роботи з діалоговими формами зображень https://veno.es/venobox/
multiTV (опціонально) *встановлюється з extras https://github.com/extras-evolution/multiTV використовується для списків зображень в TV goods_images. замість списків зображень можете використовувати TV goods_images як "строка" для единого зображення. використовується для списків підвидів товару в TV goods_goods. якщо вам це не потрібно - не заповнюйте.
reCaptcha (опціонально) заповніть параметри assets/custom/Config/config_custom.php якщо бажаете використовати капчу при перевірці оформлення замовлення 'reCaptcha' => array( 'key' => '', 'secret' => '', 'url' => 'https://www.google.com/recaptcha/api/siteverify', )

zatomant / combacart

Maintainers

Details