CyberPanel 3.x ile birlikte paneldeki tek tıkla WordPress kurulumu, ücretli WordPress Manager lisansına bağlandı. Lisansınız yoksa “Deploy WordPress” sayfası sizi fiyatlandırma sayfasına yönlendiriyor. Panel ücretsiz kalsa da WordPress kurmak isteyen herkes ya lisans almak ya da kurulumu elle yapmak zorunda kalıyor.
Bu sorunu çözmek için Webonya olarak WordPress Kurucu eklentisini geliştirdik. Eklenti, CyberPanel’in ücretli özelliğini kırmıyor veya atlatmıyor. Tamamen bağımsız, açık kaynaklı bir kurucu; ücretsiz ve kendi sunucunuzda çalışıyor.

Kurulumdan sonra her sitenin sayfasında bir WordPress Kurucu kutusu görünür. Kutuya tıklayıp site başlığını yazmanız yeterli: veritabanı, Türkçe dil, SEO dostu bağlantılar ve önbellek eklentisi dahil her şey otomatik hazırlanır.
Eklenti Ne Yapar?
Eklenti, CyberPanel’deki her sitenin sayfasına (websites/alanadi.com/workspace, Genel Bakış sekmesi) bir WordPress Kurucu kutusu ekler. Kutu açıldığında alan adı zaten o siteye ayarlıdır; PHP sürümü ve SSL durumu da sitenin kendi ayarından okunur.
Formda sadece dört alan var: site başlığı, e-posta, kullanıcı adı ve şifre. Kullanıcı adı ve güçlü şifre otomatik üretilir. Gerisini kurucu kendisi yapar:

- Önce kontrol eder: Sitede WordPress zaten varsa ya da klasörde başka dosyalar varsa kurulum yapmaz. Mevcut bir sitenin üzerine yanlışlıkla yazılmasını böylece engeller.
- Veritabanını panel üzerinden açar: Veritabanı CyberPanel’in Veritabanları listesinde görünür, paket limitleri de geçerlidir.
- Türkçe kurar: Dil Türkçe, saat dilimi İstanbul olur.
- SEO ayarlarını yapar: Kalıcı bağlantılar
/yazi-adi/yapısına geçer. - Temizlik yapar: Örnek yazı, örnek sayfa, Hello Dolly ve Akismet silinir.
- Güvenliği artırır: Veritabanı tabloları rastgele bir önekle oluşturulur.
- İsteğe bağlı olarak LiteSpeed Cache kurar: OpenLiteSpeed ile uyumlu önbellek eklentisi tek anahtarla eklenir.
- SSL varsa https kurar: Geçerli bir sertifika bulursa siteyi https ile kurar ve http → https yönlendirmesi ekler.
Kurulum sırasında adım adım ilerleme ekranı ve canlı log görürsünüz. Sonunda site adresi, yönetim paneli linki ve giriş bilgileri gösterilir.
Otomatik güncellemelere dokunulmaz; WordPress’in kendi varsayılan ayarları geçerli kalır.
Gereksinimler
Eklenti aşağıdaki ortamda gerçek bir sunucuda kurulup test edildi:
| Bileşen | Test edilen | Durum |
|---|---|---|
| CyberPanel | 3.0.8 | Test edildi |
| İşletim sistemi | AlmaLinux 9 | Test edildi |
| Web sunucusu | OpenLiteSpeed | Test edildi |
| PHP | lsphp 8.2 | Test edildi |
| İşletim sistemi | Ubuntu 22.04 / 24.04, AlmaLinux 8 | Henüz test edilmedi |
| Web sunucusu | LiteSpeed Enterprise | Henüz test edilmedi |
| CyberPanel | 3.0.8 dışındaki sürümler | Henüz test edilmedi |
Kurulum için sunucuya root olarak SSH ile bağlanabilmeniz gerekir. WP-CLI sunucuda yoksa eklenti onu kendisi indirir.
Kurulum
Kurulum iki adımda biter. Başlamadan önce sunucunuzun yedeğini ya da anlık görüntüsünü (snapshot) almanızı öneririz.
wordpress-kurucu.zipdosyasını sunucunun/rootklasörüne yükleyin. FileZilla veya WinSCP’de protokolü SFTP, portu 22 ve kullanıcıyı root seçin. CyberPanel’in FTP hesapları sadece kendi sitesinin klasörünü gördüğü için bu iş için uygun değildir.- SSH ile root olarak bağlanıp şu komutu çalıştırın:
cd /root && rm -rf wordpress-kurucu && unzip -o wordpress-kurucu.zip && cd wordpress-kurucu && bash install.sh
En sonda yeşil Kurulum tamamlandı yazısını görmelisiniz. Kurulum scripti, değiştirdiği panel dosyalarını önce /root/wpAutoInstaller-yedek-TARİH/ altına yedekler. Bir hata olursa her şeyi otomatik olarak eski haline getirir.
Aynı komut güncelleme için de kullanılır: yeni zip’i /root‘a yükleyip komutu tekrar çalıştırmanız yeterli.
Kullanım
- CyberPanel’de siteyi her zamanki gibi oluşturun (Websiteler › Web Sitesi Oluştur).
- Alan adının DNS kayıtları sunucuyu gösteriyorsa önce SSL alın (SSL › Issue). Kurucu geçerli bir sertifika bulursa siteyi https ile kurar.
- Websiteler listesinden siteyi açın. Genel Bakış sekmesindeki ilk kutu WordPress Kurucu‘dur.
- Formda site başlığını yazın; e-posta, kullanıcı adı ve şifreyi kontrol edin. LiteSpeed Cache’i açık bırakın ya da kapatın.
- WordPress’i kur butonuna basın. Kurulum genellikle bir dakikadan kısa sürer.
- Sonuç ekranındaki şifreyi kaydedin. Sayfadan çıkınca tekrar gösterilmez.
Site başlığında : ; $ & ( ) ' < > karakterleri kullanılamaz, çünkü CyberPanel’in güvenlik filtresi bunları reddeder. Bu karakterleri içeren bir başlığı kurulumdan sonra WordPress’ten girebilirsiniz.
Güvenlik
Eklenti sunucuda root yetkisiyle çalıştığı için güvenliğe özellikle dikkat ettik:
- Sadece kendi siteniz: Kurucu sayfası CyberPanel’in kendi sahiplik kontrolünü kullanır. Her kullanıcı yalnızca kendi sitesini görür; bayi kendi müşterilerinin sitelerini, admin tüm siteleri.
- Root, sitenin dosyalarına dokunmaz: İndirme, yazma ve izin işlemlerinin hepsi sitenin kendi kullanıcısıyla yapılır. Root yalnızca doğrulama yapar, veritabanını panel üzerinden açar ve web sunucusunu yeniden yükler.
- Doğru klasör garantisi: Site kullanıcısı panel kaydından alınır.
public_htmlbaşka bir yere yönlendirilmişse (sembolik link) ya da sahibi kayıtla uyuşmuyorsa kurulum yapılmaz. - Şifreler görünmez: Yönetici ve veritabanı şifreleri komut satırında, işlem listesinde ya da loglarda yer almaz. Geçici iş dosyası okunur okunmaz silinir.
- Sitenin PHP ayarları korunur: CyberPanel’in güvenlik için kapattığı PHP fonksiyonları yalnızca kurulum komutları sırasında açılır. Sitenin web tarafındaki PHP ayarları değişmez.
- Panel dosyaları güvende: Kurulum ve kaldırma, panel dosyalarını önce yedekler, değişiklikleri yarım kalmayacak şekilde yazar ve hata olursa geri yükler.
Kurulum Hata Verirse Nereye Bakmalıyım?
| Ne | Nerede |
|---|---|
| Kurulum logu | /home/cyberpanel/wpauto/<işno>.log |
| Kurulum durumu | /home/cyberpanel/wpauto/<işno>.state |
| Panel hata logu | /home/cyberpanel/error-logs.txt |
Kaldırma
Eklentiyi kaldırmak için:
cd /root/wordpress-kurucu && bash uninstall.sh
Kaldırma işlemi kurulmuş WordPress sitelerine dokunmaz; yalnızca panel dosyalarını eski haline getirir.
Lisans ve indirme
WordPress Kurucu, CyberPanel ile aynı lisans olan GPL v3 ile ücretsiz dağıtılır. Eklentinin içinde Poppins yazı tipi (SIL Open Font License 1.1) ve Font Awesome Free ikonları (CC BY 4.0) yer alır. Bunlar pakete gömülüdür; eklenti hiçbir dış kaynağa bağlanmaz.
WordPress Kurucu, CyberPanel’in resmi bir ürünü değildir ve CyberPanel ekibiyle bir bağlantısı yoktur.
İndirme: wordpress-kurucu.zip
Sık Sorulan Sorular
WordPress’in yeni sürümü yeni çıkmışsa site yine Türkçe kurulur mu?
Evet. Yeni bir sürümün Türkçe paketi genellikle birkaç saat sonra yayınlanır. Paket henüz yoksa kurucu en yeni sürümü indirir ve Türkçe dil paketini ayrıca kurar. Yeni sürümün çevirisi yayınlanınca WordPress onu kendisi günceller; isterseniz Başlangıç › Güncellemeler sayfasından elle de güncelleyebilirsiniz.
Otomatik güncellemeler açık mı?
Kurucu bu ayara dokunmaz; WordPress’in varsayılanı geçerlidir. WordPress yeni kurulumlarda çekirdek güncellemelerini otomatik yapar. Eklenti ve tema güncellemeleri ise varsayılan olarak kapalıdır.
SEO dostu bağlantılar WordPress güncellenince bozulur mu?
Hayır. Ayar WordPress veritabanında saklanır; WordPress, eklenti ve tema güncellemeleri bu ayara dokunmaz.
CyberPanel’i güncelledim, kutu kayboldu. Ne yapmalıyım?
CyberPanel güncellemeleri panelin şablon dosyalarının üzerine yazar. Kurulum komutunu tekrar çalıştırmanız yeterli:cd /root/wordpress-kurucu && bash install.sh
Kurucu “Klasör boş değil” diyor. Sitenin public_html klasöründe başka dosyalar var. Veri kaybını önlemek için kurulum yapılmaz. Dosyaları Dosya Yöneticisi’nden silin veya taşıyın, sonra sayfayı yenileyin. CyberPanel’in koyduğu varsayılan index.html, .htaccess ve .well-known engel oluşturmaz.


