ҚұжаттамаСоңғы жаңарту: 29.10.2026
Бұл нұсқаулық Northbytra-ның барлық сайттарына — IT және техникалық қызмет сайтына және барлық салалық сайттарға қолданылады. Әдеттегі орнату шамамен 30 минутқа созылады. Сізге FTP бағдарламасы (мысалы, FileZilla) және хостингіңізге кіру деректері қажет.
1. Дұрыс пакетті таңдаңыз
- Сайт: IT және техникалық қызмет сайты (компьютер жөндеу, IT қызметтері, бейнебақылау камералары — жөндеуді онлайн бақылаумен) немесе салалық сайт: Сәулет студиясы, Құрылыс компаниясы, Электр мердігері, Интерьер дизайны студиясы, Күн панельдерін орнатушы, Жиһаз дүкені мен өндірушісі, Автожөндеу және автосервис, Шина орталығы, Эвакуатор және жолдағы көмек, Кузов жөндеу және бояу, Автокөлік жалдау, Автосалон немесе кез келген басқа салаға арналған Сіздің бизнесіңіздің сайты. Оларды өнімдер бетінде және тікелей демоларда салыстырыңыз.
- Нұсқа: Standard — банктік аударыммен, жеткізу кезінде қолма-қол немесе дүкенде төленетін тапсырыстар. Pro — қосымша PayTR немесе Stripe арқылы онлайн картамен төлеу. Екі нұсқа да бірдей орнатылады; кейін Standard нұсқасынан Pro нұсқасына көше аласыз, ал белсендіру кілтіңіз өзгермейді.
- Бір пакет = бір сала: пакеттің дизайны, мәзірі, модульдері мен үлгі мазмұны өз саласына арналған. Барлық мәтіндерді, суреттер мен модульдерді басқару панелінде өзгертуге болады, бірақ пакеттің саласын басқасына ауыстыру мүмкін емес.
- Төлемнен кейін тапсырыс бетіңіздің сілтемесі бар хат аласыз: онда белсендіру кілтіңізді көрсетіп, жеке жүктеу сілтемеңізді пайдаланасыз; бас тарту құқығы тоқтағаннан кейін кілттің көшірмесі сізге электрондық пошта арқылы да жіберілуі мүмкін. ZIP файлында
uploadқалтасы мен құжаттама (INSTALL.md / KURULUM.md) бар.
2. Талаптар
- pdo_mysql, sodium, mbstring және fileinfo кеңейтімдері бар PHP 8.1 немесе одан жаңа нұсқасы (gd және intl ұсынылады) — хостинг пакеттерінің көбінде стандартты
- MySQL 5.7+ немесе MariaDB 10.3+
- mod_rewrite бар Apache немесе LiteSpeed — немесе 10-бөлімдегі ережелермен Nginx
- Доменіңізге арналған SSL сертификаты (хостинг провайдерлерінің көбінде Let's Encrypt арқылы тегін)
Орнату шебері орнату басталмас бұрын әр талапты тексереді.
3. Файлдарды FTP арқылы жүктеңіз
- ZIP файлын компьютеріңізде ашыңыз.
- Хостингіңізге FTP арқылы — жақсырағы SFTP немесе FTPS — қосылып,
uploadқалтасының мазмұнын доменіңіздің түбірлік веб-қалтасына (көбінесеpublic_html,httpdocsнемесеhtdocs) жасырын.htaccessфайлдарымен қоса жүктеңіз. - Хостинг панеліңізде бос MySQL дерекқорын және оған барлық құқықтары бар дерекқор пайдаланушысын жасаңыз. Дерекқор атауын, пайдаланушы атын және құпия сөзді жазып алыңыз.
4. Орнату шеберін іске қосыңыз
- Доменіңізді браузерде ашыңыз — шебер автоматты түрде іске қосылады. Оның тілін жоғарғы жағында ауыстыра аласыз.
- Дерекқор деректерін және компанияңыз туралы ақпаратты енгізіңіз.
- Сайттың және басқару панелінің әдепкі тілін, ұсынғыңыз келетін тілдерді және елді / өңірді таңдаңыз — уақыт белдеуі, валюта, телефон коды және тасымалдаушылар соған қарай алдын ала бапталады.
- Әкімші есептік жазбаңызды жасап, белсендіру кілтіңізді енгізіңіз (5-бөлімді қараңыз).
- Үлгі мазмұн: толыққанды сайттан бастау үшін белгіні қалдырыңыз — слайдер, қызметтер, жобалар, өнімдер, блог және ЖҚС он тілде. Салалық сайттар нақты фотосуреттермен (Pexels лицензиясы, коммерциялық пайдалануға рұқсат етілген), IT сайты түпнұсқа иллюстрациялармен беріледі. Әр элементті кейін басқару панелінде сақтаңыз, өңдеңіз немесе жойыңыз — немесе бос сайттан бастау үшін белгіні алып тастаңыз.
- Шебер аяқталғаннан кейін серверден
installқалтасын жойыңыз жәнеapp/config.phpфайлының сақтық көшірмесін сақтаңыз — онда жеке деректерді шифрлайтын кілт бар.
5. Лицензияңызды белсендіріңіз
- Онлайн белсендіру: орнату кезінде шебер кілтіңізді, доменіңізді және бағдарлама нұсқасын біздің лицензия серверімізге жібереді. Содан кейін кілт сайт орнатылған доменге байланады (
wwwбар немесе жоқ; кез келген басқа қосалқы доменге жеке лицензия қажет). - Қолмен белсендіру коды: егер серверіңіз интернетке қосыла алмаса (мысалы, брандмауэр шығыс қосылымдарды бұғаттаса), шебер «Қолмен белсендіру коды» өрісін көрсетеді. Тапсырыс нөміріңіз бен доменіңізді байланыс формасы арқылы жіберіңіз; сіз тек осы кілт пен осы доменге жарамды код аласыз.
- Бір лицензияға бір домен: әр лицензия тек бір доменге жарамды және басқа доменге берілмейді. Басқа сайт үшін жаңа лицензия қажет.
- Белсендіру кілті тапсырыс беру кезінде көрсеткен доменіңізге беріледі және тек сонда жұмыс істейді (www бар немесе жоқ). Сайтты
localhostнемесе басқа жергілікті мекенжайларға орнату мүмкін емес — оны тікелей доменіңізге орнатыңыз.
6. Басқару панеліндегі алғашқы қадамдар
your-domain/admin мекенжайы бойынша кіріп, басқару тақтасындағы орнату тізімін орындаңыз:
- Компания деректері (құқықтық ақпарат), логотип, бренд түсі және макет тақырыбы
- Жеткізу нұсқалары және банктік аударымдарға арналған банк деректемелеріңіз
- Құқықтық бет үлгілері — оларды тексеріп, бизнесіңізге бейімдеңіз
- Үлгі мәтіндер мен фотосуреттерді өзіңіздікімен ауыстырып, қажет емес модульдерді өшіріңіз
7. Электрондық пошта (SMTP) және екі қадамды растау
- Сайт баптаулары → Электрондық пошта бөлімін ашып, пошта жәшігіңіздің SMTP серверін, портын (STARTTLS үшін 587 немесе SSL үшін 465), пайдаланушы атын, құпия сөзін және жіберуші мекенжайын енгізіңіз, содан кейін Сынақ хатын өзіме жіберу түймесін басыңыз. Gmail және Microsoft 365 қолданба құпия сөзін талап етеді. Сәтсіз жіберілімдер қатесімен бірге E-mail хабарландырулары бөліміндегі жіберу журналында тізімделеді.
- Сынақ хаттары келе бастаған бойда Менің профилім бөлімінде екі қадамды растауды қосыңыз: содан кейін әр кіру электрондық поштаңызға жіберілетін 6 таңбалы кодпен расталады. Тек бір рет көрсетілетін он қалпына келтіру кодын қауіпсіз жерде сақтаңыз.
8. Тек Pro: онлайн картамен төлеу
- Әкімші → Онлайн төлем бөлімін ашып, PayTR немесе Stripe таңдаңыз және провайдер аккаунтыңыздағы API кілттерін енгізіңіз (олар шифрланып сақталады). Әзірге сынақ режимін қосулы қалдырыңыз.
- PayTR: сол бетте көрсетілген хабарландыру URL мекенжайын PayTR сатушы панеліңізге енгізіңіз. Stripe: онда көрсетілген webhook URL мекенжайын қосып, қолтаңба құпиясын (whsec_…) қойыңыз.
- Жеткізу нұсқалары бөлімінде тұтынушылар картамен төлей алатын нұсқалар үшін «Онлайн карта төлемі» белгісін қойыңыз.
- Сынақ тапсырысын жасаңыз, содан кейін сынақ режимін өшіріп, нақты кілттеріңізді енгізіңіз. Карта деректері тек провайдердің қауіпсіз бетінде енгізіледі және сайтыңызға ешқашан жетпейді.
9. Жаңа нұсқаға жаңарту
Сіздің контентіңіз, баптауларыңыз, аудармаларыңыз, тапсырыстарыңыз және активтендіру кілтіңіз дерекқорда және app/config.php файлында сақталады — жаңарту тек бағдарлама файлдарын ауыстырады. Лицензияңыз өзгермейді; қайта активтендіру қажет емес.
Бастамас бұрын
- Әкімшілік панелінде Лицензия бөлімін ашыңыз: *Бағдарлама нұсқасы* жолы қазір орнатылған нұсқаны көрсетеді. Жаңа пакеттегі INSTALL.md / KURULUM.md файлындағы «Жаңалықтар» бөлімін оқыңыз.
- Жаңа пакетті жеке жүктеу сілтемесі арқылы жүктеп алыңыз. Сілтеменің мерзімі аяқталса, тапсырыс нөміріңізді байланыс формасы арқылы бізге жіберіңіз, сізге жаңа сілтеме беріледі. Әрдайым сол сайтты (сол сала) және сол басылымды (Standard немесе Pro) пайдаланыңыз — ал Standard басылымынан Pro-ға ауысу үшін Pro пакетін.
- Сақтық көшірме жасаңыз: дерекқорды экспорттаңыз (phpMyAdmin → Export немесе хостингтің сақтық көшірме функциясы),
app/config.phpфайлын жәнеuploadsқалтасын FTP арқылы жүктеп алыңыз.app/config.phpжеке деректерді шифрлайтын кілтті қамтиды — онсыз бұл деректерді қайта оқу мүмкін емес. Сайт қалтасының толық көшірмесі одан да жақсы. - Бағдарлама файлдарын өзіңіз өзгерткен болсаңыз, қайсысын екенін жазып алыңыз: жаңа нұсқа оларды қайта жазады, кейін өз өзгерістеріңізді қайта қолдану керек болады.
Жаңарту
- Жаңа ZIP файлын компьютеріңізде архивтен шығарыңыз.
uploadқалтасының мазмұнын FTP арқылы бұрынғы қалтаға жүктеңіз және FTP бағдарламасына бар файлдардың үстінен жазуға рұқсат беріңіз (жасырын.htaccessфайлдарын қоса). Алдымен серверден ештеңені өшірмеңіз. Пакеттеapp/config.phpжәне сіздің суреттеріңіздің ешқайсысы жоқ, сондықтан баптауларыңыз бенuploadsқалтасы сол күйінде қалады.installқалтасын серверден қайтадан жойыңыз.- Сайтыңызды ашып, әкімшілік панеліне кіріңіз: дерекқор бірінші кіргенде автоматты түрде жаңартылады (бұл бірнеше секунд алады). Лицензия бөлімінде енді жаңа нұсқа нөмірі көрсетіледі.
Кейін тексеріңіз
- Басты бетті және әр белсенді тілдегі бірнеше бетті ашыңыз; байланыс формасын бір рет жіберіңіз.
- Pro: төлем провайдеріңіздің тест режимінде сынақ төлемін жасаңыз немесе төлем баптауларын тексеріңіз.
- Дизайн ескі немесе бұзылған болып көрінеді ме? Бетті Ctrl + F5 арқылы қайта жүктеңіз және хостингтің немесе CDN кэшін тазалаңыз (мысалы, LiteSpeed Cache, Cloudflare).
- Жаңартумен келген жаңа тілдер өшірулі күйде қосылады — қаласаңыз, әкімшілік панелінде Тілдер бөлімінен қосыңыз.
Бірдеңе дұрыс болмаса
- Ақ бет немесе 500 қатесі:
storage/logsішіндегі ең жаңа файлды қараңыз — қате сонда сипатталған. - Алдыңғы нұсқаға оралу үшін екеуін де — файлдарды да, дерекқорды да — сақтық көшірмеден қалпына келтіріңіз. Ескі бағдарлама файлдарын бұрыннан жаңартылған дерекқормен ешқашан қолданбаңыз.
10. Nginx
Apache және LiteSpeed жинақтағы .htaccess файлдарын пайдаланады. Nginx-те доменіңіздің server блогына мына ережелерді қосыңыз (PHP-FPM сокетін серверіңізге сәйкес түзетіңіз):
location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ ^/(app|storage)(/|$) { deny all; }
location ~ ^/install/(?!index\.php$).+\.php$ { deny all; }
location ~ ^/uploads/.*\.(php|phtml|phar|pl|py|cgi|sh)$ { deny all; }
location ~ /\. { deny all; }
location ~* \.(sql|md|log|lock|ini|bak|old|orig|sh|dist|env|json|yml|yaml|key|pem|zip|tar|gz)$ { deny all; }
location ~ \.php$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass unix:/run/php/php8.2-fpm.sock; }
11. Демо режимі
Сайтты клиенттерге немесе әріптестерге ешқандай тәуекелсіз көрсету үшін app/config.php файлында 'demo' => true мәнін орнатыңыз. Сонда келушілер демо есептік жазбамен толық басқару панелін қарап шыға алады, бірақ ештеңе сақталмайды, екі қадамды растау жасырылады және мазмұн автоматты түрде бастапқы күйіне қайтарылады (аралық: demo_reset_minutes). Пакеттегі құжаттамада барлық демо баптаулары тізімделген.
12. Ақауларды жою
- Басты беттен басқа әр бет 404 көрсетеді:
.htaccessфайлы жүктелмеген немесе mod_rewrite өшірулі. - Сайт басқа мекенжайға бағыттайды:
app/config.phpфайлындағыbase_urlмәнін түзетіңіз. - Хаттар келмейді: SMTP баптауларын тексеріп, жіберу журналындағы қатені оқыңыз.
- Ақ бет немесе 500 қатесі:
storage/logsішіндегі файлдарды қараңыз.
Орнатуда қиындық туындады ма? Орнатуға көмек ақылы орнату қызметіміз ретінде қолжетімді: оны бағалар бетінде тапсырыс беріңіз — немесе рәсімдеу кезінде қосыңыз — сонда сайтты хостингіңізге біз орнатамыз.