Kurulum
Gerekenler: PHP 8.2 + Apache (mod_rewrite açık) veya Nginx + php-fpm. Veritabanı yok, composer yok, kurulum sihirbazı yok.
Adımlar
- Klasörü web köküne koy (
htdocs/gibi) — tek klasör, taşınabilir. data/,data/*/yazılabilir olsun (içerik +.bakyedekleri + sayaçlar buraya yazılır)..htaccessSEF kuralları içinAllowOverride Allgerekir; yoksa?slug=parametreli düz URL'ler de çalışır (blog.php?slug=ornekgibi).- Aç: site çalışır. Panel:
/admin/(kimlikconfig.php'de:ADMIN_USER+ADMIN_HASH). - Boş açılmasın istersen örnek veriyi yükle:
data-ornek-kurulum/içindekileridata/içine kopyala (1 novel + 2 bölüm + 1 sayfa + 1 yazı + 1 yazar + hazır ayar/anket). Detay klasördekiREADME.md'de.
Sihirbazlı kurulum (install.php)
Formu doldur, bitsin: /install.php adresinde admin adı + şifre alanları (şifre tekrarlı, en az 8 karakter), opsiyonel site başlığı ve örnek veri onayı var. Yaptıkları: config.php'ye ADMIN_USER + ADMIN_HASH yazar (PASS_PEPPER korunur — üye girişleri ölmez), eksik dosyaları data-ornek-kurulum/'dan kopyalar, data/install.lock kilidi koyar. Kilit varken sayfa açılmaz; bitince sayfadaki butonla install.php'yi sil.
Nginx ile kurulum
Kökteki nginx-hexabee.conf .htaccess'in birebir karşılığıdır (SEF kuralları, güvenlik başlıkları, önbellek, gzip, gizli dosyalar):
mapbloğununginx.conf'unhttp{}seviyesine koy (dosya başında tarifli —server{}içine konmaz).- Dosyayı vhost olarak bağla,
example.com+__DOCROOT__+ php-fpm soketini düzenle. sudo nginx -t && sudo systemctl reload nginx.- PHP limitleri (
upload_max_filesize=10Mvb.) nginx'tephp.ini/ FPM pool'dan verilir —.htaccess'tekiphp_valuesatırları sadece mod_php içindir, nginx'te yok sayılır.
İlk ayar
| İş | Yer |
|---|---|
| Site adı/açıklama/adres | Panel → Ana Sayfa & Header, veya data/settings.md |
| Logo + özel gün logoları | Panel → Logo & Özel Gün |
| Eklenti aç/kapa | Panel → Eklentiler (data/plugins.json) |
| Tema seçimi | Panel → Temalar (data/theme.json) |
| Admin şifresi | Panel → Şifre Oluşturucu çıktısını config.php'ye yapıştır |
Yedekleme
Veri = dosya. data/ klasörünü kopyalamak tam yedektir (içerik + ayar + sayaç + .bak'lar). Tam sistem yedeği için kökü zipleyip tarihli sakla (htdocs-backup-YYYYMMDD-HHMM.zip kalıbı).
Sorun giderme
| Belirti | Bakılacak yer |
|---|---|
| Sayfalar 404 veriyor | Apache: mod_rewrite + AllowOverride All · Nginx: try_files + @sef bloğu aktif mi, nginx -t temiz mi |
| Yazma hatası / değişiklik kayboluyor | data/ yazma izni |
| Boş sayfa (500) | Apache error.log; genelde data/*.json bozulmuştur — .bak'tan geri yaz |
| Eklenti listede yok | Klasör adı + plugin.json JSON geçerliliği |