Ръководство за работа и администриране

Инсталиране и първо стартиране

За нова инсталация използвайте пълния пакет PHP84.zip, а не UPDATE.zip.

Изисквания към хостинга

PHP 8.4, HTTPS и PDO с pdo_mysql или pdo_sqlite. Нужни са mbstring, fileinfo, GD с WebP, cURL, OpenSSL и ZIP. MySQL/MariaDB трябва да поддържа транзакции и UTF-8. Инсталаторът показва проверките на средата.

Качете магазина в главната директория на домейна — инсталация в подпапка не се поддържа. PHP трябва да може да записва снимки и файлове за обновяване, както и да създава директории за кратките адреси. Нужна е стандартна временна папка извън публичния сайт.

Стъпки

1. Създайте отделна празна база MySQL/MariaDB и потребител с достъп до нея.
2. Разархивирайте пълния пакет в корена на сайта, включително скритите .htaccess файлове.
3. Отворете домейна и попълнете адреса на магазина, връзката с базата и данните на собственика.
4. Завършете инсталирането и влезте през /asaap/. Инсталаторът се заключва автоматично.
5. От „Начална настройка“ въведете данните на магазина и изберете тема.

Частно и публично хранилище

Системата първо опитва частна директория до корена на сайта. Ако хостингът не я разрешава, използва защитени PHP файлове в storage — този режим изисква MySQL/MariaDB. SQLite се предлага само с частно хранилище; съществуваща SQLite база не се преобразува автоматично.

Администрация и служители

Работете със собствен профил за всеки служител, за да е ясна историята на действията.

Навигация

Лявото меню започва с „Общ преглед“, „Поръчки“, „Продукти“ и „Категории“. Горната навигация групира разделите в падащи менюта. Търсачката намира продукти и SKU, поръчки, клиенти, категории, страници, служители и настройки според разрешения достъп. Бутонът горе превключва светъл и тъмен админ панел — изборът се пази в браузъра и не променя клиентската тема.

Служители и роли

Добавяне на служител

От „Служители“ създайте запис с име, имейл, парола и роля. При нужда включете „Индивидуални права“ и отбележете разрешените раздели — те заменят правата на ролята. Без избрани права служителят има само собствен профил. Собственикът запазва всички права.

Нова парола се въвежда само когато искате да я смените. Промени по профила или правата прекратяват старите сесии на служителя. Използвайте „Дневник“ за проследяване на административните действия.

Категории, продукти и SEO

Добрият продуктов запис съдържа ясни текстове, точна цена, наличност и подходящи снимки.

Категории

От „Категории“ добавете име, адрес на латиница, родител, подредба, описание и снимка. Родителят изгражда дървовидната структура. В продуктовата форма избирате категория от дървото вдясно. Проверявайте зависимите продукти преди изтриване.

Нов продукт

Попълнете име и уникален SKU. Адресът може да се генерира от името или да се зададе ръчно. В ценовата лента въведете цена с или без ДДС, ставка и кое поле да се използва за записа. „Стара цена“ 0 означава без стара цена. Наличността без варианти важи за обикновения продукт.

Краткото описание се показва до цената и бутона за покупка, а пълното съдържа подробности, списъци и форматиран текст. Качете снимки с избор на файл или влачене; библиотеката позволява повторно използване на вече качени изображения.

SEO и адреси

Ако SEO заглавието и описанието са празни, при запис се попълват от името и описанията. „SEO помощник“ показва липсващи текстове и изображения. Промяната на продуктов адрес създава пренасочване от стария; налични са и ръчни пренасочвания.

Началната страница е /. Категориите и продуктите използват /adres-na-latinica/. При конфликт на имена се добавя -category или -product. Старите query линкове се пренасочват към кратките.

Варианти, характеристики и импорт

Разграничавайте описателните характеристики от вариантите, които имат собствена наличност.

Характеристики и филтри

Въвеждайте по една характеристика на ред: „Размер: M“, „Цвят: Черен“, „Марка: MONO“, „Материал: Памук“ или „Памет: 256 GB“. Използвайте еднакъв правопис. Клиентските филтри се изграждат от продуктите в текущата категория и подкатегориите ѝ и се комбинират с цена, наличност и промоции.

Размери, цветове и варианти

За дрехи и обувки използвайте варианти за комбинации от размер и цвят. Всеки вариант има собствена цена, наличност и може да има отделни снимки. Генерирайте комбинациите, проверете редовете и запазете. Масовата редакция поддържа до 100 реда.

Масова редакция и CSV

Маркирайте продукти и изберете действие: активиране, скриване, препоръчване, базова цена, наличност или категория.

„Импорт и отзиви“ приема UTF-8 CSV с разделител ;, до 500 реда и 2 MB. Задължителни колони: sku, name, slug, price_cents, stock, active. Цените са в евроцентове: 1299 означава 12,99 €. category_slug трябва да съвпада със съществуваща категория. Съвпадащо SKU обновява запис; ново SKU създава продукт. Грешка отменя целия импорт.

Поръчки и ежедневна работа

Обработка на нова поръчка

1. Отворете „Поръчки“ и изберете „Преглед“.
2. Проверете имената, телефона, адреса или офиса, куриера и начина на плащане.
3. Проверете артикулите, вариантите, количествата и общата сума.
4. Използвайте бутоните за статус най-горе за следващата разрешена стъпка.
5. Създайте товарителница при настроен куриер или въведете номер за проследяване.
6. Добавете вътрешна бележка при особености и проследете имейл известието.

Статуси и ограничения

Статусите са „Нова“, „Обработва се“, „Изпратена“, „Завършена“, „Отказана“ и „Върната“. Достъпните бутони зависят от текущия статус и ролята. При отказ или връщане наличностите се възстановяват само веднъж. Отказът в магазина не извършва автоматичен refund при платежния оператор.

Редакция и масови операции

Данните за доставка могат да се редактират преди изпращане. „Обработка на поръчки“ поддържа до 25 поръчки за статус и общ печат и до 10 товарителници наведнъж. Не повтаряйте неясен опит за пратка, преди да проверите дали вече е създадена.

Плащания и куриери

Активиране, попълнени настройки и потвърдена външна връзка са различни неща.

Доставка до адрес или офис

Поддържат се Спиди, Еконт и Pigeon Express. За адрес клиентът попълва град/село, улица и номер; за офис избира офис на куриера. Офисите се използват от локален кеш, който се обновява от настройките. За реални товарителници са нужни договорни API данни, подател и услуга. За Pigeon до адрес е нужен и идентификатор на населеното място.

Клиенти, имейли и документи

Клиентски профили

Бутонът за профил отваря вход и регистрация. Телефонът е задължителен при регистрация и поръчка; поддържа се и поръчка като гост. Регистрираният клиент вижда поръчки, лични данни и документи. Смяната на парола прекратява останалите сесии. Клиентът може да подаде заявка за връщане или замяна.

Имейли и шаблони

От „Настройки“ попълнете пощата и включете известията. Нова поръчка изпраща потвърждение до клиента и собственика; смяна на статус — ново съобщение до клиента. Редактирайте шаблоните с показаните променливи, без да ги преименувате. Проверете реалното получаване, включително папка „Спам“.

Отзиви и наличност

Клиент с профил може да изпрати отзив, който се публикува след одобрение. Маркерът „Потвърдена покупка“ се основава на изпратена/завършена поръчка. При изчерпан продукт може да се заяви известие за наличност.

Документи

Фактурите и протоколите за пълно връщане се издават от поръчката. Номерът и съдържанието се заключват; клиентът има достъп само до своите документи.

Теми и редактор на живо

Готови теми

В „Теми и стилове“ има MONO 1 до MONO 15: универсални витрини, техника, мода, красота, козметика, мебели, свеж пазар и аксесоари. Използвайте „Преглед“, „Активирай“ и „Редактирай на живо“. Тематичните теми имат бутон „Демо каталог“ с подходящи продукти. Външен ZIP стил съдържа theme.json и избира сред вградените оформления.

Редакция на началната страница (MONO Studio)

Изберете текст, снимка или група. Дръжката „Елемент“ мести в същата група, „Секция“ — подрежда секциите. Добавяйте банери, текстове, категории, слайдери и продуктови секции или готова композиция. Продуктовата секция се настройва по брой, категория, сортиране и само промоционални артикули.

Телефон, чернова и публикуване

„Само телефон“ позволява отделни размери на текст, отстояния, заобляне, подравняване и колони. „Запази чернова“ не променя публичната страница. „Публикувай“ прави редакцията видима и пази до 15 предишни версии.

Менюта и информационни страници

Подредете горното, основното, вторичното и долното меню. От „Страници и SEO“ попълнете контакти, доставка, плащане, общи условия, поверителност и бисквитки.

Промоции, склад и отчети

Кампании и допълнителни продажби

Създавайте процентни отстъпки, „Купи 3, плати 2“ и отстъпка на всяка втора бройка — с категория, период и минимално количество. При няколко автоматични промоции се прилага най-голямата; въведеният код я заменя, отстъпките не се натрупват. Настройте подаръци и праг за безплатна доставка.

Цени на едро и колички

„Цени на едро“ управлява клиентски групи, отстъпки, минимални количества и цени по SKU. Запазените колички се възстановяват по текущи наличности; напомняне се изпраща само при желание на клиента. За автоматична обработка настройте почасова задача към app/cart-worker.php.

Склад и марж

Въведете доставчик, доставна цена и праг за ниска наличност. „Марж на продажбите“ показва показатели, графика и таблица по поръчки за изпратени и завършени поръчки.

Статистика и внимание

„Статистика“ следи търсенията, продажбите и продуктите. „Център за внимание“ проверява последните 1000 поръчки за забавена обработка, имейли и пратки.

ZIP модули и разширения

ZIP модулите и ZIP темите са различни формати и се качват в различни раздели.

Инсталиране и управление

1. Влезте като собственик и отворете „Модули“ → „ZIP модули“.
2. Разгънете качването и пуснете ZIP файла или го изберете от устройството.
3. Потвърдете, че пакетът е от доверен източник, и натиснете „Инсталирай ZIP“.
4. Попълнете „Настройки“ на модула и запазете.
5. Натиснете „Включи“ и проверете резултата в магазина.

Каченият модул остава изключен до изрично активиране. Обновяване със същия идентификатор изисква по-висока версия; настройките се запазват, но модулът отново се изключва. При уловена грешка системата спира модула и показва съобщение.

Формат за разработчици

ZIP съдържа точно module.json и module.php в основата. Максимум 2 MB архив и 200 KB за всеки файл. Подробности и пример — в ръководството за разработчици.

Обновяване и резервни копия

Обновяване на системата

За съществуващ магазин използвайте UPDATE.zip. От „Обновяване“ качете архива, прегледайте разпознатата версия и приложете. Не прекъсвайте операцията. След това проверете администрацията, началната страница, продукт, категория и количката. Предишните системни файлове се пазят; връщането възстановява кода, не базата.

Резервни копия на данните

„Резервни копия“ позволява на собственика да създава, сваля и възстановява архиви на базата, снимките, настройките, товарителниците и ZIP модулите. Лимитът е 100 MB разархивирани данни и до 20 000 файла. Сваленият архив съдържа лични данни — съхранявайте го защитено, заедно с оригиналния config.php.

Автоматично архивиране

Изпълнява се при посещение на собственика след изминали 24 часа. За изпълнение без посещение настройте ежедневна задача към app/backup-worker.php. Пазят се от 2 до 30 копия.

Проверка преди старт и помощ

Контролен списък

• Данните на магазина и имейлът на собственика са верни.
• Демонстрационните продукти са скрити или заменени; цените и наличностите са проверени.
• Размерите, цветовете, снимките и филтрите работят.
• Началната страница, менюто и продуктовите секции са прегледани на телефон.
• Контактите и информационните страници са попълнени.
• Всеки активен куриер е проверен за адрес и офис.
• Направена е тестова поръчка, получени са писмата и е проверена смяна на статус.
• Има актуално резервно копие и ясни права за служителите.

Чести затруднения