Modül Kurulum Rehberi - WHMCS, WordPress & WiseCP

WHMCS модулін жүктеп алу (v5.9.0) WordPress плагинін жүктеп алу (v5.9.0) WiseCP Modülünü İndir (v5.9.0)

Серверсіз архитектура: Модульдер API деректерін ішіне ендірілген түрде сақтайды. Сервер қосудың, API URL немесе API Key енгізудің қажеті жоқ. Жүктеп алған модуліңіз реселлер аккаунтыңыз үшін арнайы жасалады.

Жүйе талаптары

WHMCS

WHMCS 7.x, 8.x немесе 9.x
PHP 7.2 немесе одан жоғары (PHP 8.x қолдау көрсетіледі)
cURL PHP кеңейтімі
JSON PHP кеңейтімі
FTP/SFTP немесе cPanel қолжетімділігі

WordPress

WordPress 5.8 немесе жоғары
WooCommerce 6.0 немесе жоғары
PHP 7.4 немесе одан жоғары
wp_remote_request() (әдепкі)
FTP/SFTP немесе wp-admin қолжетімділігі

DATASSL тіркелгісі

Белсенді дилер тіркелгісі
API кілті (автоматты түрде енгізіледі)
Жеткілікті кредит балансы
Анықталған өнім тобы

Орнату қадамдары

Модульді жүктеп алыңыз

Дилер панеліңізге кіріп, Модульді жүктеп алу бөлімінен WHMCS модулін жүктеп алыңыз. Немесе төмендегі түйме арқылы тікелей жүктеп ала аласыз.

WHMCS модулін жүктеп алу

Жүктеп алынған ZIP файлында API кілтіңіз енгізілген. API кілтін бөлек енгізудің қажеті жоқ.

ZIP файлын ашыңыз

Жүктеп алған datassl_whmcs_v5.9.0.zip файлын ашыңыз. Ішінде келесі құрылымды көресіз:

📁 modules/
  📁 servers/
    📁 datassl/ ← Сервер (Provisioning) модулі
      📄 datassl.php — Негізгі модуль файлы
      📁 lib/
        📄 ApiClient.php — API клиент класы
      📄 hooks.php — WHMCS hook-тары
      📁 templates/
        📄 clientarea.tpl — Клиент панелінің үлгісі
        📄 admin.tpl — Әкімші панелінің үлгісі
        📄 overview.tpl — Шолу үлгісі
  📁 addons/
    📁 datassl/ ← Addon басқару модулі
      📄 datassl.php — Addon негізгі файлы
      📄 hooks.php — Addon hook-тары
      📄 cron.php — Тапсырыстарды синхрондау cron-ы
      📁 lib/
        📄 ApiClient.php — API клиент класы
        📄 Helper.php — Көмекші функциялар
📄 README.md
📄 CHANGELOG.md

Файлдарды WHMCS-ке жүктеңіз

ZIP ішіндегі modules қалтасын WHMCS орнату каталогына жүктеңіз. FTP, SFTP немесе cPanel File Manager пайдалана аласыз.

FTP / SFTP


                                # Екі қалтаны да WHMCS каталогына көшіріңіз:

                                modules/servers/datassl/ → /home/user/public_html/whmcs/modules/servers/datassl/

                                modules/addons/datassl/ → /home/user/public_html/whmcs/modules/addons/datassl/

Маңызды: Қолданыстағы WHMCS modules қалтасының ішіне көшіріңіз. Қалтаны қайта жазбаңыз, тек servers/datassl және addons/datassl ішкі қалталарын қосыңыз.

Файл рұқсаттары: PHP файлдары үшін 644, қалталар үшін 755 рұқсаты жеткілікті.

Addon модулін белсендіріңіз

WHMCS әкімші панеліне өтіп, addon модулін белсендіріңіз:

WHMCS әкімшісі панеліне кіріңіз
Setup → Addon Modules бетіне өтіңіз
"DATASSL SSL Certificates" модулін табыңыз
"Activate" түймесін басыңыз
Access Control бөлімінен әкімші рөлдерін таңдаңыз (мысалы: Full Administrator)
"Save Changes" арқылы сақтаңыз

Автоматты орнату: Белсендіру кезінде модуль автоматты түрде:

Дерекқор кестелерін жасайды (mod_datassl_orders, mod_datassl_logs, mod_datassl_settings)
5 электрондық пошта үлгісін жасайды (SSL Configuration, Issued, Expiry, Renewed, Reissued)

Өнім жасау (1-әдіс: Addon панелі - ұсынылады)

Addon панеліндегі Өнім құрастырушы арқылы өнімдерді жаппай қосыңыз:

Addons → DATASSL SSL Certificates мәзіріне өтіңіз
Сол жақ мәзірден "Өнім құрастырушы" бетін ашыңыз
Өнімдер қосылатын WHMCS өнім тобын таңдаңыз (жоқ болса, алдымен жасаңыз)
Үстеме баға (markup) мөлшерлемесін белгілеңіз (мысалы: %20)
Қосқыңыз келетін өнімдерді таңдаңыз
"Таңдалған өнімдерді WHMCS-ке қосу" түймесін басыңыз

Автоматты баға белгілеу: Өнім құрастырушы сіз белгілеген үстеме бағаға сәйкес барлық валюталарда бағаны автоматты түрде есептейді. SAN қолдайтын өнімдер үшін Configurable Options автоматты түрде жасалады.

Өнім жасау (2-әдіс: қолмен)

Өнімдерді қолмен бір-бірлеп те жасай аласыз:

Setup → Products/Services → Products/Services бетіне өтіңіз
"Create a New Product" түймесін басыңыз
Product Type: Басқа таңдаңыз
Өнім тобы мен атауын анықтаңыз, "Continue" басыңыз
Module Settings қойындысына өтіңіз
Module Name: "DATASSL SSL Certificates" таңдаңыз
"DATASSL өнімі" dropdown тізімінен сертификат өнімін таңдаңыз
"Save Changes" арқылы сақтаңыз

Өнім тізімінде өнім атауларының жанында растау түрі (DV/OV/EV), SAN ақпараты және серіктес бағасы көрсетіледі. Тізім бос болса, API қосылымын тексеріңіз.

Cron баптауы (ұсынылады)

Тапсырыс күйлерін автоматты түрде синхрондау үшін жеке cron job қосыңыз. Бұл cron API арқылы барлық тапсырыстардың күйін тексеріп, WHMCS қызмет күйлерін жаңартады.

Crontab


                                # Әр 6 сағат сайын іске қосу (ұсынылады)

                                0 */6 * * * php /home/user/public_html/whmcs/modules/addons/datassl/cron.php


                                # Немесе әр 4 сағат сайын

                                0 */4 * * * php /home/user/public_html/whmcs/modules/addons/datassl/cron.php

Балама: Cron job қоспасаңыз да, WHMCS-тің өз күнделікті cron-ы (DailyCronJob hook) арқылы тапсырыстар күніне бір рет автоматты түрде синхрондалады. Алайда жиірек жаңарту үшін жеке cron ұсынылады.

Орнатуды тексеріңіз

Орнатудың сәтті өткенін тексеру үшін:

Addons → DATASSL SSL Certificates мәзіріне өтіңіз
Шолу бетінде API күйін, балансты және статистиканы тексеріңіз
Сол жақ мәзірден Баптаулар бетіне өтіңіз
"Байланысты тексеру" түймесін басыңыз — жасыл белгіні көруіңіз керек
Дилер атауы, баланс және жеңілдік мөлшерлемесі дұрыс көрінсе, баптау аяқталды

Құттықтаймыз! WHMCS модулі сәтті орнатылды. Енді SSL сертификаттарын сатуды бастай аласыз.

Addon панелінің беттері

Шолу

API күйі, баланс, тапсырыс статистикасы, соңғы тапсырыстар және жылдам қолжетімділік сілтемелері

Өнім құрастырушы

API өнімдерін WHMCS-ке жаппай қосыңыз. Үстеме бағаны баптау, SAN және бағаны автоматтандыру

Тапсырыстар

Барлық SSL тапсырыстарын бір экраннан басқарыңыз. Сүзу, іздеу, күйді синхрондау

Әрекеттер журналы

Толық әрекет журналдары, API шақырулары және қателерді бақылау

Баптаулар

API байланысын тексеру, модуль ақпараты, cron конфигурациясы, дерекқор күйі

Плагинді жүктеп алыңыз

Дилер панеліңізге кіріп, Модульді жүктеп алу бөлімінен WordPress плагинін жүктеп алыңыз.

WordPress плагинін жүктеп алу

Жүктеп алынған ZIP файлында API кілтіңіз енгізілген. Оны WordPress баптаулар бетінен өзгерте аласыз.

ZIP файлын ашыңыз

Жүктеп алған datassl_wordpress_v5.9.0.zip файлында келесі құрылым бар:

📁 datassl/ ← Плагин қалтасы
  📄 datassl.php — Негізгі плагин файлы
  📄 uninstall.php — Таза жою
  📁 includes/
    📄 class-api-client.php — API клиент класы
    📄 class-admin.php — Басқару панелі
    📄 class-orders.php — Тапсырыстарды басқару
    📄 class-woocommerce.php — WooCommerce интеграциясы
    📄 class-cron.php — Жоспарланған тапсырмалар
  📁 assets/
    📁 css/ — Стиль файлдары
    📁 js/ — JavaScript файлдары

Плагинді орнатыңыз

Екі әдістің бірін пайдалана аласыз:

1-әдіс: WordPress Admin

Плагиндер → Жаңасын қосу → Плагин жүктеу → ZIP таңдау → Орнату

2-әдіс: FTP / SFTP

datassl/ → /home/user/public_html/wp-content/plugins/datassl/

Жүктегеннен кейін Плагиндер бетінен DATASSL SSL Certificates плагинін белсендіріңіз.

WooCommerce қажет: Бұл плагин WooCommerce-пен жұмыс істейді. WooCommerce орнатылмаған және белсенді болмаса, плагин тек әкімші панелін көрсетеді.

Баптауларды конфигурациялаңыз

WordPress сол жақ мәзірінде DATASSL → Баптаулар бетін ашыңыз:

API URL

Автоматты түрде ендірілген

API кілті

Автоматты түрде ендірілген

Қосылымды тексеру

Бір рет басып API арқылы растау

WooCommerce өнімін жасаңыз

WooCommerce-те жаңа өнім жасап, өнім түрін DATASSL SSL сертификаты ретінде таңдаңыз:

Өнімдер → Жаңасын қосу
Product Data dropdown тізімінде "DATASSL SSL сертификаты" таңдаңыз
"DATASSL API өнімі" қойындысында сатқыңыз келетін SSL сертификатын таңдаңыз
Баға мен басқа мәліметтерді толтырыңыз
Сақтау & Жариялау

Виртуалды өнім: SSL өнімі автоматты түрде виртуалды (virtual) өнім ретінде белгіленеді. Жеткізуді қажет етпейді.

Орнатуды тексеріңіз

Орнатудың сәтті өткенін тексеру үшін:

DATASSL → Шолу бетінде тіркелгі деректеріңізді тексеріңіз
Қосылымды тексеруRun it
DATASSL → Өнімдер бетінде API өнімдерінің тізімде тұрғанын тексеріңіз
Клиент аккаунтында Менің тіркелгім → SSL сертификаттары мәзірінің көрінетінін тексеріңіз
Тест тапсырысын жасап, бүкіл процесті тексеріңіз

Құттықтаймыз! WordPress плагині сәтті орнатылды. WooCommerce арқылы SSL сертификаттарын сатуды бастай аласыз.

Клиент аймағының мүмкіндіктері

SSL баптау

Менің тіркелгім → SSL сертификаттары бетінен CSR енгізу, домен және DCV әдісін таңдау арқылы оңай баптау

Күйді бақылау

30 секундтық автоматты күй тексеруі, DCV әдісін өзгерту және тапсырыстан бас тарту мүмкіндіктері

Сертификатты қарау

Certificate, CA Bundle, Private Key файлдарын бір рет басып көшіру түймелері (қараңғы тақырып көрінісі)

Қайта шығару

Сертификатты reissue (жаңа CSR міндетті емес), DCV әдісін өзгерту, тапсырысты болдырмау

Модульдерді салыстыру

Мүмкіндік	WHMCS модулі	WordPress плагині
Нұсқа	v5.9.0	v1.0.0
Архитектура	Server + Addon (2 модуль)	Өнім модулі
Сервер баптау талабы	✓ Қажет емес (серверсіз)	✓ Қажет емес (серверсіз)
API Key автоматты енгізу	✓ Иә	✓ Иә
Өнім құрастырушы (жаппай)	✓ Addon панелінен	✗ Қолмен жасау
Addon басқару панелі	✓ 5 беттік толық панель	✓ 4 беттік панель (Dashboard, Тапсырыстар, Өнімдер, Баптаулар)
Тапсырыстарды синхрондау	✓ Cron + күнделікті WHMCS cron	✓ WP Cron күнделікті синхрондау
Хат үлгілері	✓ 5 автоматты үлгі	wp_mail ile süre uyarıları
SAN (Multi-Domain) қолдауы	✓ Configurable Options арқылы	✓ Иә
Wildcard SAN қолдауы	✓ Иә	✓ Иә
Көпжылдық қолдау	✓ Иә	✓ Иә
Клиенттің SSL баптауы	3 қадамды шебер	Клиент аймағының формасы
Сертификатты жүктеп алу / көшіру	✓ Иә	✓ Иә
Әкімші күй көрінісі	✓ Түспен белгіленген	✓ Түспен белгіленген
Қайталау логикасы	✓ 2 рет қайталау	2 tekrar
Тілдік қолдау	Ағылшын тілі (WHMCS тілі)	Түрік тілі + ағылшын тілі
Мерзімнің аяқталуы туралы еске салу	✓ 30/14/7/3/1 күн	wp_mail ile süre uyarıları

Модульді жүктеп алыңыз

Дилер панеліңізге кіріп, Модульді жүктеп алу bölümünden WiseCP modülünü indirin. Ya da aşağıdaki butonu kullanarak doğrudan indirebilirsiniz.

WiseCP Modülünü İndir

Жүктеп алынған ZIP файлында API кілтіңіз енгізілген. API кілтін бөлек енгізудің қажеті жоқ.

ZIP файлын ашыңыз

İndirdiğiniz ZIP dosyasını açın. İçinde şu yapıyı göreceksiniz:

📂 coremio/modules/Product/DATASSL/

├── DATASSL.php — Негізгі модуль файлы

├── api.php — API клиенті

├── config.php — Конфигурация

├── logo.png — Модуль логотипі

📂 controllers/

└── test_connection.php

📂 pages/

├── settings.php

├── product-detail.php

├── order-detail.php

└── ac-order-detail.php

📂 lang/

├── tr.php

└── en.php

Файлдарды жүктеңіз

ZIP ішіндегі coremio/ klasörünü WiseCP kurulum dizininizin kök klasörüne FTP / dosya yöneticisi ile yükleyin. Mevcut coremio/ қалтасымен біріктіріледі.

                            
                                /home/kullanici/public_html/

                                ├── coremio/

                                │   ├── modules/

                                │   │   └── Product/

                                │   │       └── DATASSL/ ← Осында жүктелді

                                │   ├── ...

                                └── index.php

Маңызды: coremio/modules/Product/DATASSL/ каталогының астындағы барлық файлдар толық жүктелгеніне көз жеткізіңіз.

Модуль параметрлерін баптаңыз

WiseCP Admin Panel-ге кіріп, келесі қадамдарды орындаңыз:

Баптаулар → Өнім модульдері бөліміне өтіңіз
DATASSL modülünü listede bulun ve Баптаулар ikonuna tıklayın
API URL және API кілті alanlarını kontrol edin (otomatik gömülüdür)
Қосылымды тексеру түймесін басыңыз
"Байланыс сәтті!" хабарламасын көргеннен кейін Сақтау— click it

API мәліметтеріңіз жүктеп алған модульге автоматты түрде енгізілген. Байланыс тексеруінде мәселе болмаса, оларды өзгертудің қажеті жоқ.

SSL өнімін жасаңыз

WiseCP Admin Panel арқылы жаңа SSL өнімін жасаңыз:

Өнім/Қызмет → Өнімдер мен қызметтер бөліміне өтіңіз
Өнім түрін SSL сертификаты ретінде таңдаңыз
Модуль ретінде DATASSL таңдаңыз
Автоматтандыру қойындысында DATASSL API өнімін сәйкестендіріңіз
Бағаны белгілеп, сақтаңыз

SAN (Multi-Domain) қолдауы

Multi-domain SSL satmak istiyorsanız:

Өнімді өңдеу бетінде Бапталатын опциялар
Түрі ретінде Саны (Quantity) таңдаңыз
Баптаулар тісті дөңгелегінен sans_count мәнін 1 орындаңыз
Сақтаңыз — әр опция бірлігі 1 қосымша SAN доменін қосады

SSL операцияларының барысы

Модуль белсендірілгеннен кейін SSL тапсырыстары келесі тәртіппен өңделеді:

1 Тапсырыс — Клиент өнімді таңдап, домен мен CSR енгізеді

2 DCV таңдау — EMAIL, HTTP, HTTPS немесе DNS әдісі таңдалады

3 Тексеру — Клиент таңдаған DCV әдісінің қадамдарын орындайды

4 Сертификат — Сертификат автоматты тексеру арқылы жүктеліп, клиентке ұсынылады

Müşteri İşlemleri

Клиенттер тапсырыс мәліметтері бетінде мыналарды жасай алады:

DCV әдісін өзгерту: Ағымдағы тексеру әдісін өзгерте алады (мысалы: EMAIL → DNS)
Тексеруді қайта жіберу: Электрондық пошта арқылы тексеруді қайта жібере алады
Қайта шығару (Reissue): Сертификатты жаңа CSR арқылы қайта шығара алады
Сертификатты жүктеп алу: Берілген сертификатты жүктеп ала алады
Күйді тексеру: SSL күйін бірден тексере алады

Бұл әрекеттердің барлығы DATASSL API арқылы автоматты түрде орындалады. Қолмен араласу қажет емес.

Жиі қойылатын сұрақтар

Сервер қосуым керек пе?

Жоқ. Барлық модульдер серверсіз (serverless) архитектурамен жұмыс істейді. API URL және API Key модуль файлдарына автоматты түрде кірістіріледі. WHMCS-те "Servers" бөліміне, WordPress-те қосымша параметрлерге тиісудің қажеті жоқ.

API кілтімді қайда енгізуім керек?

Оны ешқайда енгізудің қажеті жоқ. Модульді DATASSL реселлер панеліңізден жүктеп алғанда, API кілтіңіз модуль файлдарына автоматты түрде ендіріледі. Модуль жұмыс істегенде осы ендірілген кілтті пайдаланады.

Модульді жаңарту үшін не істеуім керек?

Жаңа нұсқаны DATASSL панеліңізден жүктеп алып, бар файлдардың үстіне жүктеңіз. Жаңарту кезінде WHMCS addon модулі дерекқор кестелері мен хат үлгілерін автоматты түрде тексеріп, жетіспейтіндерін қосады. Деректеріңіз сақталады.

Өнім тізімінде ешбір өнім көрінбейді, не істеу керек?

Бұл әдетте API қосылымы ақауын білдіреді. Тексеріңіз:

cURL кеңейтімі белсенді ме? (php -m | grep curl)
Сервер брандмауэрі сыртқы қосылымдарды бұғаттап тұр ма?
Дилер тіркелгіңіз белсенді ме және өнім тобы анықталған ба?
WHMCS-те: Addon панеліндегі Баптаулар → Қосылымды тексеру орындаңыз
Әкімші панелінен "Өнімдер тізімін жаңарту" түймесін басыңыз (кэш тазартылады)

Клиент CSR енгізбей тапсырыс бере ала ма?

Иә. Тапсырыс кезінде CSR енгізілмесе, қызмет "Конфигурацияны күтуде" (awaiting_configuration) күйінде белсендіріледі. Клиент кейінірек өз панелінен (Client Area) CSR енгізу арқылы SSL конфигурациясын аяқтай алады.

SAN (қосымша домен) қолдауын қалай қосамын?

WHMCS: Addon панеліндегі Өнім құрастырушы арқылы өнім қоссаңыз, SAN қолдайтын өнімдер үшін Configurable Options автоматты түрде жасалады. Қолмен жасасаңыз, Configurable Options Group қосып san_count және san_domains өрістерін анықтаңыз.

WordPress: SAN қолдауы плагинге кіріктірілген. Төлем кезінде клиент қосымша домендерін енгізеді.

Кредит балансым тапсырыстардан автоматты түрде шегеріле ме?

Иә. API арқылы жасалған барлық тапсырыстарда сома кредит балансыңыздан автоматты түрде шегеріледі. Баланс жеткіліксіз болса, тапсырыс жасалмайды (HTTP 402 қатесі қайтарылады). Модульдер бұл жағдайды клиентке түсінікті қате хабарламасы ретінде көрсетеді.

Кодқа қол қою (Code Signing) сертификаттарына қолдау көрсетіле ме?

Иә. Кодқа қол қою және EV кодқа қол қою сертификаттарына толық қолдау көрсетіледі. Бұл өнім түрлері доменді тексеруді (DCV) қажет етпейді және домен өрісі жасырылады. Тек CSR мен байланыс деректері жеткілікті.

Ақауларды жою

Мәселе	Шешім
WHMCS: Addon мәзірде көрінбейді	Setup → Addon Modules арқылы іске қосылғанына және әкімші рөлдері таңдалғанына көз жеткізіңіз
WHMCS: Өнімді жасау мүмкін емес	Алдымен WHMCS өнім тобы (Product Group) жасалған болуы керек
WHMCS: Модуль Module Settings бөлімінде көрінбейді	`modules/servers/datassl/datassl.php` файлының дұрыс жолда екенін тексеріңіз
API байланыс қатесі	Серверіңіз сыртқы байланыстарды бұғаттамайтынына көз жеткізіңіз. `curl` және `json` PHP кеңейтімдерін тексеріңіз
Тапсырыс жасау мүмкін емес	WHMCS: толық қатені Utilities → Logs → Module Log бөлімінен қараңыз. Кредит балансыңызды тексеріңіз
Сертификатты жүктеп алу мүмкін емес	Сертификат әлі дайын болмауы мүмкін. Тапсырыс күйін синхрондап, оның "active/issued" күйіне өтуін күтіңіз
Cron жұмыс істемейді	PHP жолының дұрыс екенін тексеріңіз: `which php`. Cron журналдарын тексеріңіз: `/var/log/cron`

Көмек керек пе?
Орнату кезінде қиындық туындаса, қолдау тобымызға хабарласыңыз.
Қолдау өтінімін жасау

Модульді орнату нұсқаулығы

Жүйе талаптары

WHMCS

WordPress

DATASSL тіркелгісі

Орнату қадамдары

Модульді жүктеп алыңыз

ZIP файлын ашыңыз

Файлдарды WHMCS-ке жүктеңіз

Addon модулін белсендіріңіз

Өнім жасау (1-әдіс: Addon панелі - ұсынылады)

Өнім жасау (2-әдіс: қолмен)

Cron баптауы (ұсынылады)

Орнатуды тексеріңіз

Addon панелінің беттері

Шолу

Өнім құрастырушы

Тапсырыстар

Әрекеттер журналы

Баптаулар

Плагинді жүктеп алыңыз

ZIP файлын ашыңыз

Плагинді орнатыңыз

Баптауларды конфигурациялаңыз

WooCommerce өнімін жасаңыз

Орнатуды тексеріңіз

Клиент аймағының мүмкіндіктері

SSL баптау

Күйді бақылау

Сертификатты қарау

Қайта шығару

Модульдерді салыстыру

Модульді жүктеп алыңыз

ZIP файлын ашыңыз

Файлдарды жүктеңіз

Модуль параметрлерін баптаңыз

SSL өнімін жасаңыз

SAN (Multi-Domain) қолдауы

SSL операцияларының барысы

Müşteri İşlemleri

Жиі қойылатын сұрақтар

Ақауларды жою