Ödeme Yöntemleri Abuse

WHMCS modülü kurulum talimatları

26.09.2024, 12:51

WHMCS (Web Host Manager Complete Solution) barındırma şirketleri ve İSS'ler için bir otomasyon sistemidir. Müşteri yönetimi, faturalandırma, destek ve süreç otomasyonu için işlevsellik sunar. İşte bu modülün nasıl kurulacağına dair talimatlar.

ADIM 1: Modülün yüklenmesi

Modülü scp kullanarak komut satırı üzerinden sunucuya yükleyin:

scp /path/to/local/module-whmcs-billmanager.zip
username@remote_server:/path/to/remote/directory

Dosyanın bulunduğu klasördeyseniz örnek:

scp module-whmcs-billmanager.ziproot@77.92.122.212:/var/www/www-root/data/www/data-hub.online/

Daha sonra sunucu şifrenizi girmeniz istenecektir.

Dosyayı sunucuya yükledikten sonra, SSH aracılığıyla sunucuya bağlanın ve dosyayı açın

ssh user@remote_server

Sunucu şifresini girmeniz gerekecektir.

Ardından projenizin klasörüne ve dosyayı yüklediğiniz yere gidin.

cd /var/www/path/to/destination/ 

Arşiv, projenin kök dizinine açılmalıdır

unzip module-whmcs-billmanager.zip

Bu arşivde, whmcs'nin çalıştığı php sürümüne karşılık gelen modülün 3 sürümü vardır, php sürümünüzü öğrenmek için Utilities/System/PHP info'ya gidin.

Daha sonra whmcs'inizin desteklediği sürüm için arşivi tekrar açmanız gerekir.

php 7.1, php 7.2, php 7.4 için şunu girin

unzip version7.1|7.2|7.4.zip

Php 8.1 için şunu girin

unzip version8.1

php 8.2 için şunu girin

unzip version8.2

Daha sonra (zorunlu olarak) dosyalara izin vermelisiniz. Bunu proje klasöründen şu komutu girerek yapabilirsiniz
chmod -R 755 modules/servers/PQH

Modül yüklenir.

Veya FileZilla aracılığıyla modülü sunucuya yükleyin

Bilgisayarınızda module-whmcs-billmanager.zip dosyasını açın

Daha sonra whmcs'nizin desteklediği sürümün arşivini tekrar açmanız gerekir:

Для версии 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.2

Daha sonra filezilla kullanarak sunucunuza bağlanın.

Php sürümünüze karşılık gelen arşivden (aşağıdaki ekran görüntüsündeki gibi) dosyaları sitenin kök klasörüne aktarın.

Daha sonra modüller/servers klasörüne gidip PQH klasörüne sağ tıklayarak ve açılan pencerede dosya özniteliklerini seçerek, alana sayısal değer 755 yazarak ve alt dizinlere yeniden arama onay kutusunu işaretleyerek (aşağıdaki ekran görüntüsündeki gibi) bunu yapmak için klasöre ve dosyalara haklar vermek gerekir (zorunludur).

Modül yüklenmiştir.

ADIM 2. IonCube'ü kontrol edin

Paylaşımlı hostinglerimizde, IonCube desteği ve sürümü kullanıcı için seçilen PHP sürümüne bağlıdır. Bu, tüm barındırma planlarının yanı sıra ISPManager panelinin kurulu olduğu sanal / tahsis edilmiş sunucular için de geçerlidir.

Dikkat: eğer sunucunuzda ISPManager4 paneli yüklüyse - desteklenen tüm sürümler için IonCube zaten yüklüdür. Sunucunun tamamen çalışmaz hale gelmesine neden olabileceğinden, bu talimatı hiçbir durumda uygulamayın. IonCube sürümünün güncellenmesi gerektiğinde - Destek Servisi ile iletişime geçin.

IonCube kurulumu için ön gereksinimler

Herhangi bir kontrol paneli olmayan bir sunucunuz varsa, IonCube'ün manuel kurulumunu yapma zorunluluğu ile karşılaşabilirsiniz.

Kurulum süreci işletim sisteminize bağlı olarak farklılık gösterebilir. İşletim sistemi ne olursa olsun, ilk adım her zaman SSH üzerinden bağlanmak ve root erişimi elde etmektir.

IonCube'ü kurmak için aktif ve çalışan bir web sunucusuna, Apache veya Nginx'e ve IonCube Loader tarafından desteklenen listeden yüklü bir PHP sürümüne sahip bir makineye ihtiyacınız vardır.

Dikkat: IonCube Loader belirli bir özelliğe sahiptir - genellikle PHP'nin "sıfır" sürümlerini desteklemez, örneğin PHP 8.0. Ancak, PHP 8.1 veya PHP 8.2'yi desteklemektedir.

IonCube'ün adım adım kurulumu

Önemli: IonCube Loader'ı yüklemek için kullanılan komutların değeri bazı değişkenlere bağlı olarak değişir: sunucudaki PHP sürümü, PHP dizininin konumu ve sunucu mimarisinin sürümü. Burada ve ileride, bu değişkenlerin değerlerini vurgulayacağız. Bunların yerine, kurulum sırasında sunucunuz için uygun değerleri değiştirmeniz gerekecektir.

1. SSH aracılığıyla sunucuya bağlanın.

2. Mevcut sunucunun mimarisini kontrol edin:

uname -m
Exit
x86_64

x86_64'ten de görebileceğimiz gibi, mevcut sunucumuz 64 bit mimaride çalışıyor. İ686 şeklindeki değerler bunun tam tersini, yani 32 bit mimariyi gösterir.

Ardından, tmp dizinine gidin ve gerekli arşivi indirin:

64 bit sistemler için:

cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz

32 bit sistemler için:

cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gz

Arşivi indirdikten sonra açmalısınız:

Örnekte 64 bit mimariye sahip olduğumuz için, böyle bir arşivi indirdik ve açtık.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. ioncube dizinine gidin ve dosyaların listesine bakın.

cd ioncube/
ls -l

Sonuç

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.txt

Gördüğünüz gibi, arşiv farklı PHP sürümleri için modülün birçok farklı sürümünü içeriyor. Daha fazla kurulum için bu dosyalardan hangisine ihtiyacımız olduğunu bulmamız gerekiyor.

6. PHP sürümünüzü bildikten sonra (ilk adımdan itibaren), bir sonraki adım IonCube Loader'ı yüklemeniz gereken dizinin konumunu belirlemektir.

php -i | grep extension_dir

Çıktı

extension_dir => /usr/lib/php/20210902 => /usr/lib/php/20210902

Kurulum işleminin devamında /usr/lib/php/20210902 konumuna ihtiyaç duyulacaktır. Centos OS'de bu klasör /usr/lib64/php/modules gibi görünebilir.

7. IonCube dosyalarını gerekli dizine kopyalayın.

sudo cp /tmp/ioncube/ioncube_loader_lin_8.1.so /usr/lib/php/20210902

8. Şimdi php.ini yapılandırma dosyalarında düzenlemeler yapmak gerekir. Farklı sunucu yapılandırmalarında farklı konumlara sahip olabilirler:

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      #для Apache2

php.ini dosyasının en başına aşağıdaki türde bir satır ekleyin:

zend_extension = /usr/lib/php/20210902/ioncube_loader_lin_8.1.so

9. Web sunucusunu yeniden başlatın:

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-fpm

10. Komutu ile kurulumun doğru olduğunu doğrulayın:

php -v

Kurulum başarılı olursa, IonCube'ün mevcut sürümü hakkında bilgi içeren satır aşağıdaki gibi görüntülenecektir:

Çıktı

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 Technologies

ADIM 3. Sunucu ekleyin

Yönetici paneline gidin.

System Settings/Servers

Yeni Sunucu Ekle'ye tıklayın.

Formu aşağıdaki ekran görüntüsündeki gibi doldurun.

Modül alanında şunu bulun: PQH

Ana Bilgisayar Adı veya IP Adresi alanına şunu girin: client.the.hosting

Ardından client.the.hosting adresinden hesap bilgilerinizi (kullanıcı adı, şifre) girin.

Ve devam et'e tıklayın.

Ardından bir sonraki sayfada sunucu adını (sizin seçiminiz) girmeniz ve Değişiklikleri Kaydet'e tıklamanız gerekir

ADIM 4. Modül Yöneticisi

Yeni bir yönetici oluşturmamız gerekiyor.

Bu, ayarlar/yöneticileri yönet bölümüne giderek yapılabilir

Ardından Yeni Yönetici Ekle'ye tıklayın

Rol: Tam yönetici

Kullanıcı adı (zorunlu!): apisystem

Verilerin geri kalanı size kalmış

Örnek (aşağıdaki ekran görüntüsü)

ADIM 5. Ek alanlar

Satın alma sırasında işletim sistemi seçimi gibi alanlar ayarlar/sistem ayarları/Yapılandırılabilir Seçenekler bölümüne gidilerek yapılandırılabilir

Yeni Grup Oluştur düğmesine tıklayın, ardından grubun adını istediğiniz gibi ayarlayın.

ve Değişiklikleri Kaydet'e tıklayın, ardından Yeni Yapılandırılabilir Seçenek Ekle görünen düğmeye tıklayın.

Ardından açılan pencerede Seçenek Adı alanına şunu girin: "VM Şablonu".

Ardından Seçenek Ekle alanına değeri ekleyin.

Burada desteklenen tüm değerlerin bir listesi bulunmaktadır:

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

Hem bu sekmede hem de Yapılandırılabilir Seçenek Grupları sekmesinde Değişiklikleri Kaydet'e tıklayın.

6. ADIM Ürün Ekleme

Ayarlar/Sistem ayarları/ Ürünler, Hizmetler bölümüne gidin

Yeni Grup Oluştur'a tıklayarak yeni bir grup oluşturun.

Ardından alanları uygun gördüğünüz şekilde doldurun

Kaydedin ve tekrar Ayarlar/Sistem ayarları/Ürünler,Hizmetler bölümüne gidin.

  1. Yeni Ürün Oluştur'a tıklayın
  2. Ardından (seçtiğinizden emin olun)
  3. Ürün Türü: Sunucu/VPS
  4. Modül: PQH

Gerisini uygun gördüğünüz şekilde doldurun

Kaydettikten sonra bu ürünü özelleştirebilirsiniz

Ayrıntılar sekmesinde (aşağıdaki ekran görüntüsü) ürünü istediğiniz gibi özelleştirebilirsiniz (Ürün Adı, Ürün Sloganı, Ürün Kısa Açıklaması, Ürün Açıklaması).

Etki Alanı Gerektir değerindeki onay kutusunun işareti kaldırılmalıdır.

Ürün ayarlarını kaydetmeyi unutmayın

Fiyatlandırma sekmesinde (aşağıdaki ekran görüntüsü), ürün için ödemeyi yapılandırabilirsiniz. Ürün ayarlarını kaydetmeyi unutmayın

Modül Ayarları sekmesinde (aşağıdaki ekran görüntüsü)

Seçiniz (zorunlu) Modül Adı: PQH

Ardından bu ürünle eşleşecek veri merkezini ve tarifeyi seçin.

Ürün ayarlarını kaydetmeyi unutmayın

Özel Alanlar sekmesinde (aşağıdaki ekran görüntüsü), Alan Adı alanına "VMid" değerini eklemelisiniz

Sekmelerin geri kalanını uygun gördüğünüz şekilde özelleştirin.

Ayrıca, ürün ekleme sürecini basitleştirmek için bunları çoğaltabiliriz (aşağıdaki ekran görüntüsü).

ADIM 7. Test Etme

Bir kullanıcı oluşturun, hesabına para yükleyin ve test hesabından bir hizmet sipariş etmeyi deneyin. Kullanıcı tarafından sipariş verildiğinde, modül tüm parametreleri BILLmanager'a iletecek, sunucuyu otomatik olarak sipariş edecek ve sunucu BILLmanager tarafında etkinleştirildiğinde, hizmet WHMCS tarafında da etkinleştirilecektir.