Kurulum

jekcms iki dosyadan oluşur: jekcms-install.php (kurulum sihirbazı) ve jekcms.zip (çekirdek). Composer çalıştırmaya, Node kurmaya, bir şeyler derlemeye gerek yok. İki dosyayı sitenizin kök dizinine yükleyip sihirbazı tarayıcıda açıyorsunuz; gerisini o hallediyor — çekirdeği açar, yapılandırmayı yazar, veritabanı şemasını kurar ve işi bitince kendini siler.

Temiz bir kurulum tipik olarak on dakikayı geçmez.

Gereksinimler

Sihirbaz açılır açılmaz bir sistem kontrolü yapar ve durumunuzu net söyler. Zorunlu maddeler kurulumu durdurur; önerilen maddeler yalnızca uyarı verir, kuruluma devam edebilirsiniz.

Zorunlu

• PHP 8.0 veya üzeri
• pdo_mysql — veritabanı bağlantısı
• zip — paketin açılması
• mbstring — çok dilli metin işleme
• Yazılabilir kök dizin — sihirbaz bunu is_writable()'a güvenerek değil, gerçekten bir dosya yazmayı deneyerek sınar
• jekcms.zip dosyasının sihirbazla aynı klasörde bulunması

Önerilen

• gd — görsel işleme. Yoksa görsel indirme ve dönüştürme çalışmaz, kurulum yine de tamamlanır.
• curl (ya da allow_url_fopen) — uzak görselleri indirmek için gerekir; en çok WordPress göçünde işe yarar.
• 128 MB PHP bellek limiti, 8 MB yükleme limiti ve zip boyutunun kabaca üç katı boş disk alanı.
• AVIF desteği (imageavif). Yoksa jekcms WebP'ye düşer.

Ayrıca bir MySQL 8.0+ / MariaDB 10.4+ veritabanına, Apache kullanıyorsanız mod_rewrite'a ihtiyacınız var.

"PHP 8 + MySQL" diyen paylaşımlı hosting paketlerinin neredeyse tamamı bu listeyi kutudan karşılar.

Başlamadan önce

1. Paketi indirin. İki dosya da müşteri panelinizde İndirmeler bölümünde, lisansınıza bağlı olarak durur.
2. Boş bir MySQL veritabanı oluşturun. Hosting panellerinin hepsinde (cPanel, Plesk, DirectAdmin) "Veritabanı Oluştur" sihirbazı vardır. Veritabanı adını, kullanıcı adını ve parolayı not edin. Pek çok hosting adın başına hesap önekini koyar (örn. kullanici_jekcms) — sihirbaza önekiyle birlikte tam adı yazacaksınız.
3. jekcms-install.php ve jekcms.zip dosyalarını kök dizininize (çoğunlukla public_html/) yükleyin. Yan yana dursunlar; sihirbaz zip'i kendi yanında arar.

Zip'i elle açmanıza gerek yok, bunu sihirbaz yapıyor.

Sihirbazı çalıştırma

Tarayıcıda siteniz.com/jekcms-install.php adresini açın. Sihirbaz iki dillidir — sağ üstteki düğme Türkçe ve İngilizce arasında geçiş yapar, yanındaki düğme açık/koyu temayı değiştirir.

1. Sistem kontrolü

On iki kontrol otomatik çalışır. Yeşil, hazır demektir. Zorunlu etiketli kırmızı bir madde kurulumu durdurur ve eksik eklentinin adını verir — hosting desteğinize iletmeniz gereken tek bilgi budur. Uyarıları geçip devam etmek güvenlidir.

2. Senaryoyu seçin

• Temiz kurulum — sıfırdan bir site.
• WordPress'ten taşı — mevcut WordPress veritabanınızı doğrudan okur; yazıları, sayfaları, kategorileri, etiketleri, yorumları, yazarları ve görselleri getirir. Ayrıntılar için WordPress İçe Aktarma sayfasına bakın.

3. Veritabanı

Az önce oluşturduğunuz boş veritabanının bilgilerini girin. Sunucu neredeyse her zaman localhost, port 3306'dır; farklıysa hosting paneliniz bunu yazar. Bağlantıyı test et düğmesine basın — kullanıcının yetkisi varsa ve veritabanı yoksa sihirbaz onu oluşturur, sonra erişilebilir olduğunu doğrulamadan sizi ilerletmez.

WordPress senaryosunu seçtiyseniz bir sonraki ekran WordPress veritabanınızı ayrıca sorar; tablo önekiyle birlikte (genelde wp_, ama wp-config.php içindeki $table_prefix satırına bakın). Bağlantı kurulunca içeri aktarılacak yazı, sayfa, kategori ve yorum sayılarını canlı görürsünüz; görseller ve yorumlar için birer onay kutusu da orada.

4. Site ve yönetici

• Site adı ve slogan — SEO başlığınızı oluştururlar; Google markanızı buradan okur.
• Site URL'si — kanonik adres. https:// olup olmadığına ve www var mı yok mu dikkat edin; SEO meta etiketleri ve giden e-postalar bu adresten üretiliyor.
• Logo — şimdi PNG, JPEG, SVG veya WebP yükleyin, ya da atlayıp sonra Ayarlar → Genel içinden ekleyin.
• Tema — pakete dahil temalardan birini seçin. İstediğiniz zaman Görünüm → Temalar üzerinden değiştirebilirsiniz.
• Yönetici hesabı — ad, e-posta, parola. Yeni yorum ve destek talebi bildirimleri bu e-postaya gider.

5. Kurulum

Sihirbaz çekirdeği çıkarır, ihtiyaç duyduğu yazılabilir klasörleri (cache, logs, temp, backups) oluşturur, .env dosyanızı yazar, bütün tabloları kurar, ayarlarınızı, yönetici hesabınızı ve varsayılan bir kategoriyi tohumlar, sonra kurulumu tamamlanmış olarak işaretler. Siteniz boş başlar — ilk yazı sizin.

WordPress göçü buradan itibaren zaman bütçeli parçalar halinde, canlı ilerleme çubuğuyla sürer. Sekmeyi kapatmanız sorun değil: sihirbazı yeniden açtığınızda size kaldığı yerden devam etmeyi önerir. Aynı sunucudaki göçlerde görseller için disk kısayolu kullanılır; 1.200 yazı, 600 yorum ve görselleri olan bir site bu yüzden tipik olarak bir dakikanın epey altında iner.

6. Bitti

Bu ekranda kurulum jekcms.zip'i siler, ardından kendini siler. Kök dizininizde bir saldırganın yeniden çalıştırabileceği hiçbir şey kalmaz. Silmeyi hatırlamanız gereken bir install.php yok.

Yönetim paneline git bağlantısını izleyip az önce oluşturduğunuz hesapla giriş yapın.

Kurulumun yazdığı dosyalar

• .env — kök dizinde; veritabanı bilgileri ve site URL'si. Canlı sunucuda ayrıca .env-production kopyası yazılır.
• config/.installed — jekcms'e "kurulu" olduğunu, sihirbaza da bir daha çalışmamasını söyleyen işaretçi.
• .htaccess — jekcms'in kendi yönlendirme kuralları. Mevcut bir WordPress sitesinin üzerine kurduysanız, onun .htaccess dosyası (genelde jekcms'in temiz URL'lerini bozacak Yoast/Rank Math kurallarıyla dolu olur) değiştirilmeden önce .htaccess.wp-backup olarak saklanır.

İlk on dakikanız

/admin üzerinden giriş yapın. Panelin üstünde beş adımlık bir ilk-yayın rayı açılır. Her adım her sayfa yüklenişinde veritabanına karşı denetlenir; işi hangi ekranda bitirirseniz bitirin ray doğruyu gösterir.

1. Site kimliği — Ayarlar → Genel içinde ad ve slogan, Ayarlar → SEO içinde varsayılan meta açıklama.
2. Logo — sihirbazda atladıysanız Ayarlar → Genel.
3. İlk kategoriniz — Kategoriler. Hazır gelen "Genel" kategorisi sayılmaz.
4. İlk yazınız — Yazılar → Yeni Ekle.
5. Güçlü bir yönetici parolası — Profil.

Beş adım da yeşile döndüğünde ray kendiliğinden kaybolur. Sonrası için temanızı özelleştirin ve entegrasyonlarınızı bağlayın.

Sık karşılaşılan sorunlar

"jekcms.zip açılamadı." Yükleme yarıda kalmış, dosya eksik inmiş. Yeniden yükleyin — suçlu genelde FTP istemcileridir, zip için hosting dosya yöneticisini tercih edin.

"Dosyalar çıkarılamadı." Kök dizininiz yazılabilir değil. Hosting dosya yöneticisinden klasöre 755 verip sihirbazı tekrar çalıştırın.

"Veritabanı bağlantısı başarısız." On seferin dokuzunda sebep veritabanı adıdır. Hosting adın başına önek koyuyorsa (kullanici_jekcms), o önek adın parçasıdır.

Göç sırasında "wp_..." tablosu bulunamadı. WordPress tablo önekiniz wp_ değil. wp-config.php dosyasını açıp $table_prefix satırını okuyun.

İlk sayfa yüklemesinde 500 hatası. Neredeyse her zaman mod_rewrite. .htaccess dosyasının yüklemeden sağ çıktığını ve Apache yapılandırmasında kök dizin için AllowOverride All tanımlı olduğunu doğrulayın.

Admin'e giriyor, login ekranına geri atıyor. Oturum çerezleri saklanmıyor — genelde site URL'sindeki sondaki eğik çizgi tutarsızlığı ya da yazılamayan PHP oturum klasörü.

Görsel yükleyemiyorum. uploads/ dizininin yazılabilir olması gerekir: klasöre 0755, içindeki dosyalara 0644.