# PrestaShop eklentisi kurulmuyor veya yönetim panelinden kayboluyor

> «Kur işlemi mümkün değil», bir güncellemeden sonra artık görünmeyen bir eklenti, ya da daha kötüsü, bir eklentinin kurulmasının hemen ardından erişilemez hâle gelen bir yönetim paneli: bu üç belirtinin, neredeyse her zaman birkaç olağan şüpheli arasında yer alan kesin nedenleri vardır.

- Source canonique : [https://allaux.fr/tr/prestashop/problemes/module-refuse-installation](https://allaux.fr/tr/prestashop/problemes/module-refuse-installation)
- Langue : TR
- Dernière mise à jour : 2026-09-30

## Doğrudan yanıt

> İşe modules/ klasörünün yazma izinlerinden başlayın: izin yoksa dosya kopyalama, genel bir hata mesajının arkasında başarısız olur. Modül diskte duruyor ama Modüller > Modül Yöneticisi ekranında görünmüyorsa sınıf önbelleğinin yeniden oluşması için var/cache/ klasörünü boşaltın. 1.6 için yazılmış bir modül, artık var olmayan bir kancaya bağlanamaz.

## Bir kurulum neden sessizce başarısız olur

Bir eklentiyi kurmak, sunucudaki /modules klasörüne dosya kopyalar. Bu klasörde yeterli yazma izni yoksa kopyalama başarısız olur, genellikle bir izin sorununu net şekilde belirtmeyen genel bir hata mesajıyla. «Kur işlemi mümkün değil» olduğunda ilk kontrol edilmesi gereken budur.

Bir diğer sık görülen neden: biri, zaten kurulu başka bir eklenti tarafından kullanılan bir PHP sınıfı veya veritabanı tablosu bildirdiğinde, iki eklenti arasındaki bir isim çakışmasıdır. Bu durumda install() yöntemi başarısız olur, ancak iki eklentiden hangisinin sorumlu olduğunu her zaman net şekilde belirtmez.

## Başka bir PrestaShop sürümü için yazılmış bir eklenti

Bir eklentinin install() yöntemi genellikle bir veya birden fazla hook'a bağlanmaya çalışır. Eklenti PrestaShop 1.6 için yazılmışsa ve uyarlama yapılmadan bir 1.7 veya 8 sürümüne kuruluyorsa, kurulu sürümde artık var olmayan bir hook'u hedeflediğinde kurulum başarısız olur. Bu, eski veya iyi bakımı yapılmamış eklentiler için sık görülen bir nedendir.

Yönetim panelinden değil FTP ile elle kurulmuş bir eklenti de, PrestaShop'un çekirdek sınıf önbelleği yeniden oluşturulana kadar görünmez kalabilir: dosya sunucuda mevcuttur, ancak PrestaShop henüz onu görmez.

## Bir eklenti kurulduktan hemen sonra erişilemez hâle gelen yönetim paneli

> Bu en ciddi durumdur: kötü kurulmuş bir eklenti yüklenirken ölümcül bir PHP hatası tetikler ve her yönetim sayfasında çalıştığı için tüm yönetim paneli erişilemez hâle gelir. Acil çözüm, hatanın kesin nedenini aramadan önce erişimi geri kazanmak için ilgili eklentinin klasörünü FTP ile devre dışı bırakmak veya silmektir.

## Yapılandırma mı, geliştirme mi?

Yazma izinlerini düzeltmek veya FTP ile elle yapılan bir kurulumdan sonra sınıf önbelleğini yeniden oluşturmak, hızlı bir temizlik işidir. Üçüncü taraf eklentinin kendisi bozuk olduğunda — uyarlanması gereken eski bir hook, yeniden adlandırılması gereken bir sınıf çakışması veya kurulu sürüm için yeniden yazılması gereken başka bir PrestaShop sürümü için yazılmış kod — bu bir geliştirme konusu hâline gelir.

## İlgili sayfalar

- **PrestaShop yönetim paneline erişilemiyor** — Yalnızca bir eklenti kurulumundan sonra değil, yönetici erişiminin engellendiği tüm durumlar için. ([/prestashop/back-office-inaccessible](/prestashop/back-office-inaccessible))
- **PrestaShop'ta 500 hatası veya boş sayfa** — Bir eklentinin tetiklediği ölümcül hata yalnızca yönetim panelini değil tüm siteyi etkilediğinde. ([/prestashop/erreur-500](/prestashop/erreur-500))
- **Özel PrestaShop eklenti geliştirme** — Bozuk bir üçüncü taraf eklentiyi kurulu PrestaShop sürümüne uyarlamak için. ([/prestashop/module-sur-mesure](/prestashop/module-sur-mesure))

## FAQ

### Bir eklenti kurulduktan hemen sonra yönetim paneline erişilemez oldu, önce ne yapmalıyım?

FTP ile sunucuya bağlanın ve /modules klasöründeki eklenti klasörünü devre dışı bırakın veya silin. Bu, eklentinin neden başarısız olduğunu aramadan önce yönetim paneli erişimini en hızlı şekilde geri getirir.

### «Kur» butonu griye dönüyor veya işlem mümkün değil, neden?

Genellikle sunucudaki /modules klasöründe bir yazma izni sorunudur, bazen zaten mevcut ama devre dışı bırakılmış aynı isimde bir eklentiyle çakışmayla birleşir.

### Bir eklentiyi FTP ile kurdum ama yönetim panelinde görünmüyor, neden?

PrestaShop, elle eklenmiş bir eklentiyi algılamak için yeniden oluşturulması gereken bir sınıf önbelleği tutar. Bu yeniden oluşturma yapılmadan, dosya sunucuda mevcuttur ama yönetim paneli tarafında görünmez kalır.

### Uzun süredir kullandığım bir eklenti bir PrestaShop güncellemesinden sonra kayboldu, bu bağlantılı mı?

Evet, bu sık görülür: eski bir sürüm için yazılmış bir eklenti, kullandığı hook'lar sürümler arasında değiştiyse çalışmayı durdurabilir. Bu, basit bir yeniden kurulum değil, eklentinin uyarlanmasını gerektirir.

### Çakışmanın kendi eklentimden mi yoksa zaten kurulu başka birinden mi geldiğini nasıl anlarım?

Yakın zamanda kurulmuş eklentileri geçici olarak tek tek devre dışı bırakıp her adımda kurulumu yeniden test ediyorum, bu da koda daha derinlemesine bakmadan önce çakışan eklentiyi izole etmeyi sağlar.