Modül ve tema yönetimi
Modüller ve temalar AACP → Sistem altında yönetilir (yetki: system.module.manage; temalar için system.settings.manage).
Modüller
AACP → Sistem → Modüller: diskteki tüm modüller, durumları (etkin / etkin değil / karantinada) ve sürümleriyle listelenir.
Etkinleştirmek
Bir modülü etkinleştir dediğinizde sistem şunları yapar:
- Bağımlılıkları denetler (gerekli modüller açık mı, çekirdek sürümü uygun mu).
- Modülü yalıtılmış bir süreçte deneme derlemesinden geçirir.
- Geçerse modülü etkinleştirir, tablolarını kurar (migration), varsayılan yeteneklerini ekler.
Herhangi bir adım başarısız olursa modül açılmaz ve sebebi ekranda görürsünüz; siteniz etkilenmez. Örnek mesaj: "Docs requires CPalius core >=2.2.52, but 2.2.51 is installed" (önce çekirdeği güncelleyin).
Devre dışı bırakmak
Devre dışı bırak modülü kapatır; veriyi silmez. Tekrar açınca her şey yerinde olur. Modülün bir başka etkin modülün bağımlılığı olduğu durumda devre dışı bırakma engellenir.
Veriyi de silmek (kaldırma) için komut satırında cp:module:deactivate <Ad> --purge kullanılır; modülün tabloları ve ayarları silinir. Bu geri alınamaz, önce yedek alın.
Zip'ten kurmak
Modül zip'ini panelden yükleyebilirsiniz (aynı adlı modül varsa üzerine yazma onayı sorulur). Paket önce sözleşme denetiminden geçer: çekirdek dosyalarına yazamaz, App\ ad alanını kullanamaz, manifest ve kurulum sınıfı eksiksiz olmalı. Başarısız paket reddedilir. Yalnızca güvendiğiniz kaynaklardan modül kurun: denetim yapısal bir güvence verir, kötü niyetli mantığı tek başına elemez.
Mağaza
AACP → Modüller → Modül mağazası (temalar için Görünüm → Tema mağazası): imzalı bir katalogdan modül ve temaları görsellerle inceleyip kurarsınız.
- Katalog imzalıdır; paketin SHA-256 özeti kurulumdan önce doğrulanır. İmza geçersiz, süresi dolmuş ya da sürümü geriye düşmüşse katalog reddedilir.
- Her kart: ad, özet, kategori, ücretsiz mi, çekirdekle uyum durumu ("Bu sürümle uyumlu / çekirdeği güncelleyin") ve ekran görüntüsü.
- Kur / Güncelle: ücretsiz paketler doğrudan kurulur. Etkin bir modülün güncellemesi, veritabanı anlık görüntüsü ve geri alma korumasıyla yapılır (aynı çekirdek güncellemesi gibi).
- Ücretli paketler için satın alma akışı henüz eklenmemiştir.
- Görüntüler panelin kendisi tarafından önbelleğe alınır; tarayıcınız güncelleme sunucusuna bağlanmaz.
Katalog arka planda saatte bir yenilenir; güncellenebilir paket sayısı mağaza menüsünde görünür.
Karantina
AACP → Sistem → Karantina: çalışma sırasında hata verip devre dışı kalan ya da etkinleştirme denemesini geçemeyen modüller, sebebiyle birlikte listelenir. Bir modül:
- Kalıcı karantinadadır: derleme denetimini geçemedi; düzeltilip yeniden denenmelidir.
- Ya da bir hook'u hata verdi: bu durumda sayfa çalışmaya devam eder, hata günlüğe yazılır (
cp-core/var/log/module_quarantine.log).
Karantinadaki bir modülün sorunu için modül geliştiricisine günlükteki ayrıntıyı iletin.
Eklentiler (plugins)
AACP → Sistem → Eklentiler: bir modülün içindeki alt özellikleri, modülün tamamını kapatmadan aç/kapa yaparsınız. Hangi eklentilerin olduğunu modülün belgesi söyler.
Temalar
AACP → Görünüm → Tema listesi: kurulu temalar, önizleme görselleri ve Etkinleştir düğmesiyle.
- Zip yükleme: tema paketi önce denetlenir (kebab-case dizin adı,
theme.json,layout.html.twig, sunucu tarafı kod yok). Başarısız paket sebebiyle reddedilir. - Etkinleştirme: Twig yolları yeniden kurulur; birkaç saniye sürebilir.
- Yedek tema: etkin tema bozulursa sistem yedek temaya (
cpalius-website) düşer; sitenizin görünümü bozulur ama sayfa açılmaya devam eder. - Tema geliştiriciyseniz: Tema geliştirme.
Sistem güncellemeleri
AACP → Sistem → Güncellemeler: çekirdeğin yeni sürümünü görürsünüz.
- Sürüm bilgisi imzalıdır; imza doğrulanamazsa güncelle düğmesi pasifleşir.
- Güncelle düğmesi: bakım modu → veritabanı anlık görüntüsü → dosya yazma → migration → önbellek yenileme; hata olursa otomatik geri alma.
- Güncellemeden önce yedek almanız yine de iyi bir alışkanlıktır (Yedekleme ve bakım).
- Güncelleme sonrası yeni modül sürümleri varsa mağazadan modülleri güncelleyin.
Ayrıntı: Güncelleme sistemi.