Modul editoru
title: Modül editörü description: AACP'deki Modül editörü ile modül dosyalarını panelden düzenlemek: neler düzenlenir, ne zaman güvenlidir, yedek ve geri dönüş.
Modüller → Modül editörü, tema editörünün modüller için karşılığıdır: bir modülün kaynak dosyalarını sunucuya bağlanmadan, panelden düzenlersiniz. Küçük bir düzeltme için (bir çeviri, bir şablon, bir CSS satırı) FTP açmaktan çok daha kısadır.
Bu ekran system.module.manage yeteneğini ister ve modülün kodunu değiştirir. Bu yetki, bir modül zip'i yükleyebilmeye eşdeğerdir; yalnızca tam güvendiğiniz yöneticilere verin.
Kullanım
- Modül listesinden düzenlemek istediğiniz modülü seçin (sayfa yenilenir ve dosya listesi gelir).
- Soldaki listeden dosyayı seçin. Tür etiketi her dosyanın yanında görünür (PHP, TWIG, CSS, JS, YAML, JSON…).
- Dosyayı düzenleyin ve Kaydet'e basın.
- Kayıttan önce söz dizimi denetlenir. Sorun varsa bir uyarı kutusu gösterilir.
Düzenlenebilen dosyalar
php, twig (.html.twig dahil), css, js, yaml/yml, json, md, txt, sql. Dosya boyutu en çok 512 KB'dır. Modülün vendor/ klasörü listelenmez; yol her zaman modülün kendi klasöründe kalır (.. ve nokta ile başlayan gizli dosyalar reddedilir).
Kaydetmeden önce denetim
| Tür | Denetim | Hata varsa |
|---|---|---|
| PHP | PHP sözdizimi (ayrıştırıcıyla) | Kaydedilmez, zorlanamaz |
module.json |
JSON geçerliliği | Kaydedilmez, zorlanamaz |
| JSON, YAML | Geçerlilik | Uyarır; onaylarsanız yine de kaydeder |
| Twig | Söz dizimi | Uyarır; onaylarsanız kaydeder |
| CSS, JS | Parantez dengesi | Uyarır; onaylarsanız kaydeder |
PHP için zorlama olmamasının nedeni basittir: modül sınıfındaki bir ayrıştırma hatası bir sonraki istekte tüm siteyi düşürebilir. Önyükleme sırasında modül hataları izole edilir (karantina), ama bozuk bir dosyayı baştan kaydetmemek en güvenlisidir.
Yedek ve geri dönüş
Her kayıttan önce dosyanın eski hâli cp-core/var/module-editor/<Modül>/ altına dosya.uzantı.YYYYMMDD-SSDDSS.bak adıyla kopyalanır. Bir şeyi bozduysanız yedeği sunucudan eski adına geri koyun. Kayıttan sonra önbellek temizlenir; şablon, çeviri ve yol değişiklikleri hemen görünür.
Ne zaman kullanmamalı
- Modül mağazadan güncellenecekse. Panelden yaptığınız düzenleme, modülün bir sonraki güncellemesinde ezilir. Kalıcı bir değişiklik istiyorsanız modülün kaynağında yapın ve yeni sürüm yayınlayın.
- Büyük değişiklikler için. Birden çok dosyaya yayılan iş sürüm denetimi, test ve gözden geçirme ister.
- Canlı sitede ilk deneme olarak. Önce yerelde deneyin.
Düzenlemeniz sonrası cp:doctor çalıştırmak iyi bir alışkanlıktır: modülün hâlâ geçerli olduğunu doğrular.