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

Оскільки ПЗ вільнорозповсюджуване оплата не потрібна але можна задонатити на розвиток проекту.

Вимоги до ПЗ:
PHP8.1+
Apache (необхідна підтримка .htaccess)
Mysql 8.0+ (MariaDB)
Програма спроектована на максимальну простоту і дешевизну розробки, а не на максимальне навантаження. Якщо передбачається активна торгівля з великим обсягом товарів, по мiрi накопичення даних будуть потрібні значні обчислювальні ресурси.
Для PHP рекомендується не менше 512MB пам'яті та не менше 300 секунд timeout. Також рекомендується збільшити пам'ять для сервера БД.

Установка програми може бути виконана як на хостингу, так і на локальному сервері, або персональному комп'ютері. Може бути використаний самий недорогий, не потребуючий спеціального адміністрування, віртуальний хостинг

Рекомендований хостинг ukraine.com.ua

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

Для IT спеціалістів:

1. Отримати дистрибутив з GitHub репозиторію (Не забуваємо ставити зiрочку :) ) .
2. Скопiювати вмiст www в корiнь сайту. Надати право запису в папки logs та upload (для Лiнукса)
3. Виконати загрузку бібліотек за допомогою Composer.
4. Створити БД (кодування utf8_general_ci) та виконати SQL скрипт /db/db.sql . (Файли update*.sql виконувати не треба).
В PhpMyAdmin скрипти виконувати через iмпорт
5. Прописати конект до БД в config/config.php.
6. Увійти дефолтним користувачем admin admin (дефолтний пароль слід змінити на сторінці профілю).
7. Задати необхідні налаштування - склад за замовчуванням, назву фірми, оперативне меню у вигляді кнопок, типи цін та ін.

Розгортання через Docke

Для швидкого запуску без ручного налаштування Apache/PHP/MySQL:

Встановіть Docker та Docker Compose

Запустіть:
docker compose pull
docker compose up -d
Відкрийте у браузері http://localhost:8080/
Логін: admin, пароль: admin
Докладніше: https://github.com/VladyslavHor/zstore-ci-docker

Менш досвідчені розробники (або ті в кого віртуальний хостинг)

можуть скачати дистрибутив в зборі з усіма бібліотеками (папка vendor) та пропустити пункти 1 i 3.

Користувачі, що не є IT спеціалістами

можуть встановити зібрану, готову до роботи програму на локальному комп'ютері.
Для цього потрібно завантажити збірку на основі проекту XAMPP, розпакувати архів в корінь диску c:. Файл для запуску c:/xampp/xampp-control.exe. Запускати бажано користувачеві з правами адміністратора.
Якщо Apache і Mysql стартували після натискання відповідних кнопок, сайт повинен відкритися в браузерi за адресою http://localhost/.

Далі панель можна згорнути.
Папка з сайтом (на випадок ручних оновлень) - htdocs.
Сторінка управління БД (для ручних оновлень) за адресою http://localhost/phpmyadmin (якщо запитає акаунт- root root)
Після закінчення роботи або перед вимкненням комп'ютера слід зупинити XAMPP. В першу чергу потрібно зупинити MySQL, щоб уникнути втрати даних.

Для Mac OS i Linux можна завантажити збiрку XAMPP.
Далi завантажити дистрибутив в зборі з усіма бібліотеками (папка vendor) та пропустити пункти 1 i 3 вище.

На випадок проблем з xampp можна завантажити (для Windows) альтернативну збiрку.

Документація користувача тут

Консультацію по встановленню та налаштуванню можна отримати тут
Також можлива допомога по встановленню програми (якщо використовується вказаний вище рекомендований хостинг)

На випадок втрати пароля адміністратора потрібно встановити для користувача admin (зазвичай перший рядок) в полі userpass таблиці users пароль в незашифрованому вигляді (наприклад 'admin'). (Можна просто виконати запит "update users set userpass = 'admin' where userlogin = 'admin'"). Потім залогінитись та перезадати пароль зі сторінки профілю.
Пароль звичайного користувача може змінити адміністратор в довіднику користувачів

Оновлення та зміни