Pokyny k instalaci modulu WHMCS
- Domov
- Znalostní báze
- Pokyny k instalaci modulu WHMCS
WHMCS (Web Host Manager Complete Solution) je automatizační systém pro hostingové společnosti a poskytovatele internetových služeb. Nabízí funkce pro správu zákazníků, fakturaci, podporu a automatizaci procesů. Zde jsou pokyny k instalaci tohoto modulu.
KROK 1: Načtení modulu
Nahrajte modul na server pomocí příkazového řádku pomocí scp:
scp /path/to/local/module-whmcs-billmanager.zip
username@remote_server:/path/to/remote/directoryPříklad: Pokud se již nacházíte ve složce se souborem:
scp module-whmcs-billmanager.ziproot@77.92.122.212:/var/www/www-root/data/www/data-hub.online/Poté budete vyzváni k zadání hesla k serveru.
Po nahrání souboru na server se připojte k serveru pomocí SSH a rozbalte soubor.
ssh user@remote_serverBudete muset zadat heslo serveru.
Poté přejděte do složky svého projektu, kam jste soubor nahráli.
cd /var/www/path/to/destination/ Archiv by měl být rozbalen do kořenového adresáře projektu
unzip module-whmcs-billmanager.zipV tomto archivu jsou 3 verze modulu odpovídající verzi php, na které whmcs pracuje, pro zjištění vaší verze php přejděte do Utilities/System/PHP info.
Poté musíte archiv znovu rozbalit pro verzi, kterou váš whmcs podporuje.
Pro php 7.1, php 7.2, php 7.4 zadejte příkaz
unzip version7.1|7.2|7.4.zipPro php 8.1 zadejte
unzip version8.1Pro php 8.2 zadejte
unzip version8.2Poté musíte (nutně) přidělit práva k souborům. To můžete provést ze složky projektu zadáním příkazu
chmod -R 755 modules/servers/PQH
Modul se načte.
Nebo nahrajte modul na server pomocí aplikace FileZilla
V počítači rozbalte soubor module-whmcs-billmanager.zip.
Poté je třeba znovu rozbalit archiv verze, kterou váš whmcs podporuje:
Для версии php 7.1, php 7.2, php 7.4 архив version7.1|7.2|7.4.zip
Для версии php 8.1 архив version8.1
Для версии php 8.2 архив version8.2Poté se připojte k serveru pomocí programu filezilla.
Přeneste soubory do kořenové složky webu z archivu odpovídajícího vaší verzi php (jako na obrázku níže).
Poté je nutné (povinné) udělit složce a souborům práva k tomu tak, že přejdete do složky modules/servers a kliknete pravým tlačítkem myši na složku PQH a ve vyskakovacím okně vyberete atributy souborů, do pole napíšete číselnou hodnotu 755 a zaškrtnete políčko recurse into subdirectories (jako na screenshotu níže).
Modul je načten.
KROK 2. Zkontrolujte IonCube
Na našem sdíleném hostingu je podpora modulu IonCube a jeho verze závislá na verzi PHP zvolené pro uživatele. To platí pro jakoukoli řadu hostingových plánů i pro virtuální/dedikované servery s nainstalovaným panelem ISPManager.
Předběžné požadavky na instalaci IonCube
Pokud máte server bez ovládacího panelu, můžete se setkat s nutností ruční instalace IonCube.
Proces instalace se může lišit v závislosti na operačním systému. Bez ohledu na operační systém je vždy prvním krokem připojení přes SSH a získání přístupu root.
K instalaci IonCube potřebujete počítač s aktivním a funkčním webovým serverem Apache nebo Nginx a také nainstalovanou verzi PHP ze seznamu podporovaného nástrojem IonCube Loader.
Instalace IonCube krok za krokem
Důležité: hodnota příkazů použitých k instalaci nástroje IonCube Loader se liší v závislosti na některých proměnných: verzi PHP na serveru, umístění adresáře PHP a verzi architektury serveru. Zde a v budoucnu budeme na hodnoty těchto proměnných upozorňovat. Na jejich místo budete muset při instalaci dosadit hodnoty odpovídající vašemu serveru.
1 .Připojte se k serveru prostřednictvím SSH.
2. Zkontrolujte architekturu aktuálního serveru:
uname -m
Exit
x86_64Jak vidíme z x86_64, náš současný server běží na 64bitové architektuře. Hodnoty ve tvaru i686 by naznačovaly opak - 32bitovou architekturu.
Dále přejděte do adresáře tmp a stáhněte potřebný archiv:
Pro 64bitové systémy:
cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gzPro 32bitové systémy:
cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gzPo stažení archivu byste jej měli rozbalit:
Protože v příkladu máme 64bitovou architekturu, stáhli jsme a rozbalili právě takový archiv.
tar -zxvf ioncube_loaders_lin_x86-64.tar.gz5. Přejděte do adresáře ioncube a prohlédněte si seznam souborů.
cd ioncube/
ls -lZávěr
total 39260
-rw-rw-r-- 1 507 507 472192 Sep 9 2023 ioncube_loader_lin_4.1.so
-rw-rw-r-- 1 507 507 471968 Sep 9 2023 ioncube_loader_lin_4.2.so
-rw-rw-r-- 1 507 507 472768 Sep 9 2023 ioncube_loader_lin_4.3.so
-rw-rw-r-- 1 507 507 490752 Sep 9 2023 ioncube_loader_lin_4.3_ts.so
-rw-rw-r-- 1 507 507 475840 Sep 9 2023 ioncube_loader_lin_4.4.so
-rw-rw-r-- 1 507 507 494880 Sep 9 2023 ioncube_loader_lin_4.4_ts.so
-rw-rw-r-- 1 507 507 483360 Sep 9 2023 ioncube_loader_lin_5.0.so
-rw-rw-r-- 1 507 507 497632 Sep 9 2023 ioncube_loader_lin_5.0_ts.so
-rw-rw-r-- 1 507 507 1116768 Sep 9 2023 ioncube_loader_lin_5.1.so
-rw-rw-r-- 1 507 507 1155744 Sep 9 2023 ioncube_loader_lin_5.1_ts.so
-rw-rw-r-- 1 507 507 1139936 Sep 9 2023 ioncube_loader_lin_5.2.so
-rw-rw-r-- 1 507 507 1176704 Sep 9 2023 ioncube_loader_lin_5.2_ts.so
-rw-rw-r-- 1 507 507 1222328 Sep 9 2023 ioncube_loader_lin_5.3.so
-rw-rw-r-- 1 507 507 1275512 Sep 9 2023 ioncube_loader_lin_5.3_ts.so
-rw-rw-r-- 1 507 507 1512960 Sep 9 2023 ioncube_loader_lin_5.4.so
-rw-rw-r-- 1 507 507 1599584 Sep 9 2023 ioncube_loader_lin_5.4_ts.so
-rw-rw-r-- 1 507 507 1520056 Sep 9 2023 ioncube_loader_lin_5.5.so
-rw-rw-r-- 1 507 507 1602040 Sep 9 2023 ioncube_loader_lin_5.5_ts.so
-rw-rw-r-- 1 507 507 1485192 Sep 9 2023 ioncube_loader_lin_5.6.so
-rw-rw-r-- 1 507 507 1549640 Sep 9 2023 ioncube_loader_lin_5.6_ts.so
-rw-rw-r-- 1 507 507 1254608 Sep 9 2023 ioncube_loader_lin_7.0.so
-rw-rw-r-- 1 507 507 1316080 Sep 9 2023 ioncube_loader_lin_7.0_ts.so
-rw-rw-r-- 1 507 507 1355080 Sep 9 2023 ioncube_loader_lin_7.1.so
-rw-rw-r-- 1 507 507 1438760 Sep 9 2023 ioncube_loader_lin_7.1_ts.so
-rw-rw-r-- 1 507 507 1407568 Sep 9 2023 ioncube_loader_lin_7.2.so
-rw-rw-r-- 1 507 507 1489008 Sep 9 2023 ioncube_loader_lin_7.2_ts.so
-rw-rw-r-- 1 507 507 1316800 Sep 9 2023 ioncube_loader_lin_7.3.so
-rw-rw-r-- 1 507 507 1386880 Sep 9 2023 ioncube_loader_lin_7.3_ts.so
-rw-rw-r-- 1 507 507 1363392 Sep 9 2023 ioncube_loader_lin_7.4.so
-rw-rw-r-- 1 507 507 1430848 Sep 9 2023 ioncube_loader_lin_7.4_ts.so
-rw-rw-r-- 1 507 507 1401736 Sep 9 2023 ioncube_loader_lin_8.1.so
-rw-rw-r-- 1 507 507 1506216 Sep 9 2023 ioncube_loader_lin_8.1_ts.so
-rw-rw-r-- 1 507 507 1439016 Sep 9 2023 ioncube_loader_lin_8.2.so
-rw-rw-r-- 1 507 507 1546568 Sep 9 2023 ioncube_loader_lin_8.2_ts.so
-rw-r--r-- 1 507 507 10768 Aug 5 2022 LICENSE.txt
-rw-r--r-- 1 507 507 181104 Aug 15 2022 loader-wizard.php
-rw-r--r-- 1 507 507 4070 Sep 9 2023 README.txt
-rw-r--r-- 1 507 507 39548 Sep 9 2023 USER-GUIDE.pdf
-rw-r--r-- 1 507 507 11269 Sep 9 2023 USER-GUIDE.txtJak vidíte, archiv obsahuje mnoho různých verzí modulu pro různé verze PHP. Musíme zjistit, které z těchto souborů potřebujeme pro další instalaci.
6. Znáte-li svou verzi PHP (z prvního kroku), je dalším krokem určení umístění adresáře, do kterého je třeba nainstalovat modul IonCube Loader.
php -i | grep extension_dirVýstup
extension_dir => /usr/lib/php/20210902 => /usr/lib/php/20210902Umístění /usr/lib/php/20210902 bude v dalším průběhu instalace potřebné. V operačním systému Centos může takový adresář vypadat jako /usr/lib64/php/modules.
7. Zkopírujte soubory IonCube do potřebného adresáře.
sudo cp /tmp/ioncube/ioncube_loader_lin_8.1.so /usr/lib/php/202109028. Nyní je třeba provést úpravy konfiguračních souborů php.ini. V různých konfiguracích serveru mohou mít různé umístění:
sudo nano /etc/php/8.1/cli/php.ini #для PHP CLI
sudo nano /etc/php/8.1/fpm/php.ini #для PHP-FPM & Nginx
sudo nano /etc/php/8.1/apache2/php.ini #для Apache2Na samý začátek souboru php.ini vložte řádek následujícího typu:
zend_extension = /usr/lib/php/20210902/ioncube_loader_lin_8.1.so9. Proveďte restart webového serveru:
Apache Ubuntu/Debian
sudo systemctl restart apache2
Apache Centos/Rocky/Alma
sudo systemctl restart httpd
Nginx/PHP-FPM
sudo systemctl restart nginx
sudo systemctl restart php-fpm10. Ověřte správnost instalace pomocí příkazu:
php -vPokud je instalace úspěšná, zobrazí se řádek s informacemi o aktuální verzi IonCube následujícím způsobem:
Výstup:
PHP 8.1.2-1ubuntu2.17 (cli) (built: May 1 2024 10:10:07) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
with the ionCube PHP Loader v13.0.2, Copyright (c) 2002-2023, by ionCube Ltd.
with Zend OPcache v8.1.2-1ubuntu2.17, Copyright (c), by Zend TechnologiesKROK 3. Přidání serveru
Přejděte do panelu správce.
System Settings/ServersKlepněte na tlačítko Přidat nový server.
Vyplňte formulář podle obrázku níže.
V poli Modul najděte: PQH
Do pole Hostname nebo IP Address (Název hostitele nebo IP adresa) zadejte: client.the.hosting
Poté zadejte údaje o svém účtu (přihlašovací jméno, heslo) z client.the.hosting.
A klikněte na tlačítko pokračovat.
Na další stránce je pak třeba zadat název serveru (dle vašeho výběru) a kliknout na tlačítko Uložit změny.
KROK 4. Správce modulu
Musíme vytvořit nového správce.
To provedeme v sekci nastavení/správce administrátorů.
Poté klikněte na tlačítko Přidat nového správce
Role: Plný správce
Uživatelské jméno (povinné!): apisystem
Zbytek údajů je na vás
Příklad (snímek obrazovky níže)
KROK 5. Další pole
Pole, jako je například volba operačního systému při nákupu, lze nakonfigurovat v části Nastavení/Systémová nastavení/Nastavitelné možnosti.
Klepněte na tlačítko Vytvořit novou skupinu a poté nastavte název skupiny podle svého přání.
a klikněte na tlačítko Uložit změny, poté klikněte na tlačítko, které se zobrazí Přidat novou konfigurovatelnou možnost.
Poté ve vyskakovacím okně zadejte do pole Option Name (Název možnosti): "VM Template" (Šablona virtuálního počítače).
Poté přidejte hodnotu do pole Add Options.
Zde je seznam všech podporovaných hodnot:
VM6_ISPsystem_Alma-Linux-8
VM6_ISPsystem_Alma-Linux-9
VM6_ISPsystem_Astra-Linux-CE
VM6_ISPsystem_CentOS-8-Stream
VM6_ISPsystem_CentOS-9-Stream
VM6_ISPsystem_Debian-10
VM6_ISPsystem_Debian-11
VM6_ISPsystem_Debian-12
VM6_ISPsystem_FreeBSD-12
VM6_ISPsystem_FreeBSD-13
VM6_ISPsystem_Oracle-Linux-8
VM6_ISPsystem_Rocky-Linux-8
VM6_ISPsystem_Ubuntu-18.04
VM6_ISPsystem_Ubuntu-20.04
VM6_ISPsystem_Ubuntu-22.04
VM6_ISPsystem_VzLinux-8
Na této kartě i na kartě Configurable Option Groups klikněte na tlačítko Save Changes.
KROK 6. Přidání produktů
Přejděte do nabídky Nastavení/Systémová nastavení/ Produkty,Služby.
Vytvořte novou skupinu kliknutím na tlačítko Vytvořit novou skupinu.
Poté vyplňte pole podle svého uvážení
Uložte a znovu přejděte do Nastavení/Systémová nastavení/ Produkty,Služby.
- Klikněte na Vytvořit nový produkt
- Poté (nezapomeňte) vybrat
- Typ produktu: Server/VPS
- Modul: PQH
Zbytek vyplňte podle vlastního uvážení
Po uložení můžete tento produkt přizpůsobit.
Na kartě Podrobnosti (obrázek níže) můžete produkt přizpůsobit podle svých představ (Název produktu,Slogan produktu, Krátký popis produktu, Popis produktu).
Zaškrtávací políčko v poli Vyžadovat hodnotu domény by mělo být odškrtnuté.
Nezapomeňte nastavení produktu uložit
Na kartě Ceny (snímek obrazovky níže) můžete nastavit platbu za produkt. Nezapomeňte uložit nastavení produktu
Na kartě Nastavení modulu (snímek obrazovky níže).
Vyberte (povinné) Název modulu: PQH
Poté vyberte datové centrum a tarif, který bude odpovídat tomuto produktu.
Nezapomeňte nastavení produktu uložit
Na kartě Vlastní pole (obrázek níže) MUSÍTE do pole Název pole vložit hodnotu "VMid".
Zbytek karet přizpůsobte podle vlastního uvážení.
Dále můžeme pro zjednodušení procesu přidávání produktů tyto produkty duplikovat (snímek obrazovky níže).
KROK 7. Testování
Vytvořte uživatele, doplňte mu účet a zkuste si z testovacího účtu objednat službu. Při objednání uživatelem modul předá všechny parametry do BILLmanageru, automaticky objedná server a po aktivaci serveru na straně BILLmanageru se služba aktivuje i na straně WHMCS.
