TMDB Movie Manager Pro — Kullanım Kılavuzu

Eklenti: TMDB Movie Manager Pro v3.0
Kurulum dosyası: tmdb-movie-manager-pro-v3.0.xml
DLE: 20.0 önerilir (19.x uyumlu mimari)
Admin arayüz dilleri: Türkçe · English · Русский · Français
İlave alan: JSON (xfields.json) ve klasik pipe formatı birlikte desteklenir
Yapımcı: Elegance

Bu doküman yalnızca eklenti içindir. Kurulum, çoklu dil, v2.1'den yenilikler, sekme rehberi, ilave alan eşlemesi ve sık sorunları kapsar. HTML olarak DLE statik sayfa editörüne yapıştırılabilir.

---

1. Gereksinimler

Gereksinim	Açıklama
DataLife Engine	20.0 önerilir — native admin panel, AJAX (index.php?controller=ajax) ve güvenlik yapısı
TMDB API anahtarı	Ücretsiz: themoviedb.org/settings/api
Yetki	Yalnızca yönetici grubu (grup 1) modülü kullanabilir
İlave alanlar	En az tmdb_id ve type; poster, genre, trailer vb. isteğe bağlı eşleştirilir
Tema	Herhangi bir DLE teması ile çalışır; şablonlarınız ilave alan etiketlerini kullanmalıdır

---

2. Kurulum

2.1 Eklenti yükleme

1. Admin → Eklentiler → Eklenti yükle.
2. tmdb-movie-manager-pro-v3.0.xml dosyasını seçin.
3. Eklentiyi etkinleştirin.

Kurulum sırasında otomatik olarak:

• Admin menüsüne TMDB Film Yönetimi kaydı eklenir
• Modül ikonu public/adminpanel/images/tmdb-logo.png konumuna yazılır (DLE 19+ standardı)
• Dil dosyaları kurulur: language/Turkish/tmdb.lng, English, Russian, French
• Modül dosyaları engine/inc/, engine/modules/, engine/ajax/, engine/classes/ altına eklenir

2.2 İlk açılış

1. Admin → Diğer Bölümler → TMDB Film Yönetimi.
2. Temel Ayarlar → TMDB API anahtarınızı kaydedin.
3. Alan Eşleştirme → site ilave alanlarınızı TMDB verilerine bağlayın veya TMDB Alanlarını Oluştur ile otomatik kurun.
4. İçerik Aktar sekmesinden test filmi veya dizisi ekleyin.

v2.1'den güncelleme: Eski sürümde menü ikonu fa-film olabilir. v3.0 kurulumu tmdb-logo.png kullanır. Güncelleme sonrası eklentiyi yeniden etkinleştirip modül sayfasını yenileyin.

---

3. Çoklu dil desteği

v3.0 ile birlikte eklenti admin arayüzü dört dilde sunulur. v2.1 yalnızca Türkçe arayüze sahipti.

DLE admin panel dili	Eklenti dil dosyası
Türkçe	language/Turkish/tmdb.lng
English	language/English/tmdb.lng
Russian (Русский)	language/Russian/tmdb.lng
French (Français)	language/French/tmdb.lng

3.1 Neler çevrilir?

• Modül sekmeleri, butonlar, tablo başlıkları, uyarı mesajları
• Dashboard istatistik etiketleri ve Sistem Bilgileri paneli
• AJAX işlem bildirimleri (DLEPush metinleri)

3.2 Neler çevrilmez?

• TMDB'den çekilen film/dizi başlık ve açıklamaları — bunlar Gelişmiş Ayarlar → TMDB API Dili ile belirlenir (tr-TR, en-US vb.)
• Site ön yüzü (ziyaretçi teması) — DLE site dil paketinizden gelir
• Admin menü kaydı kurulum metni (veritabanında sabit Türkçe başlık)

Admin dilini değiştirmek: DLE yönetim paneli dil ayarınızı güncelleyin, modül sayfasını yeniden açın.

---

4. v2.1'den v3.0'a — yenilikler

v2.1	v3.0
Film Arama + Dizi Arama (ayrı sekmeler)	İçerik Aktar — tek sekme, film/dizi seçici
Popüler Keşfet (ayrı sekme)	İçerik Aktar → Keşfet motoru
Toplu İçe Aktar (ayrı sekme)	İçerik Aktar → Toplu mod + hızlı listeler
Türkçe admin arayüzü	TR / EN / RU / FR admin arayüzü
DLE 17+ arayüz stili	DLE 20 native panel, navbar, switch, DLEPush
Pipe ilave alan formatı	JSON + Legacy birlikte desteklenir
Yok	Platformlar sekmesi (Netflix, Disney+ vb.)
Yok	İçerikler sekmesi — mevcut kayıtları TMDB'den güncelleme
Yok	editnews sayfasında «TMDB: Bilgileri Güncelle» butonu
Yok	Dashboard Sistem Bilgileri paneli (sürüm, API, film/dizi dağılımı)
Yok	Gelişmiş backdrop galeri çekimi (imagegalery alanı)
engine/skins/images/ menü ikonu	public/adminpanel/images/tmdb-logo.png

---

5. Modül sekmeleri

5.1 Kontrol Paneli

• Özet kartlar: TMDB içerik sayısı, varsayılan kategori, otomatik onay, TMDB dili
• Sistem Durumu: API durumu, backdrop ayarı, kısa kurulum ipuçları
• Sistem Bilgileri: sürüm (v3.0), yapımcı, API durumu, toplam içerik, film/dizi dağılım çubukları

5.2 İçerik Aktar

• İsimle ara — TMDB'de başlık arayıp tek tıkla habere ekleyin
• Keşfet motoru — popülerlik, puan, yayın tarihi, tür ve yıl filtreleri
• Film / dizi türü ve hedef kategori seçimi
• Toplu mod — listeden çoklu seçim ve sırayla içe aktarma
• Hızlı listeler: trend, vizyonda, yakında, yayında

5.3 Platformlar

• Netflix, Disney+, Amazon Prime vb. platform kataloglarından içerik keşfi
• Gelişmiş Ayarlar → İzleme bölgesi (watch region) platform listesini etkiler

5.4 Alan Eşleştirme

• Her TMDB verisi için sitedeki ilave alanı seçin
• Liste engine/data/xfields.json (veya klasik xfields.txt) üzerinden otomatik oluşur
• TMDB Alanlarını Oluştur — eksik alanları siteye ekler
• tmdb_id ve type zorunludur (mükerrer kayıt kontrolü)
• Kullanmak istemediğiniz alanları «Boş bırakın» olarak bırakın

5.5 Temel Ayarlar

• TMDB API anahtarı
• Varsayılan kategori ve varsayılan içerik türü (film / dizi)
• İçerik hedefi: kısa yazı, tam yazı veya her ikisi
• Poster ve backdrop boyutu, resimleri sunucuya indirme
• Otomatik onay, otomatik etiket oluşturma

5.6 Gelişmiş Ayarlar

• TMDB API dili, izleme bölgesi
• Minimum puan ve yıl aralığı filtreleri, aktarma limiti
• Meta açıklama / anahtar kelime otomatik doldurma
• Etiket kaynağı: anahtar kelimeler veya türler
• Backdrop galeri: açık/kapalı, adet (1–10), URL modu

5.7 İçerikler

• TMDB ile eklenmiş mevcut haberleri listeler
• Güncelle — yalnızca eşleştirdiğiniz alanları TMDB'den yeniler
• Tümünü güncelle — toplu senkron; atlanan alanlar raporlanır
• Elle girdiğiniz, eşleştirilmemiş alanlar korunur

5.8 Kayıtlar

• Son işlemler (içe aktarma, güncelleme, hata) — sayfa açılışında otomatik yüklenir
• Log dosyası: engine/data/dbmovies_logs.txt (son 50 kayıt gösterilir; dosya maks. 1 MB, otomatik kısaltılır)

---

6. TMDB API anahtarı

1. themoviedb.org hesabı oluşturun.
2. Settings → API bölümünden API key (v3) talep edin.
3. Anahtarı kopyalayıp modül → Temel Ayarlar → TMDB API Key alanına yapıştırın.
4. Kaydedin. Dashboard → Sistem Bilgileri'nde API durumu Aktif görünmelidir.

---

7. İlave alan (XField) eşlemesi

7.1 Önerilen temel alanlar

Alan adı	Açıklama
tmdb_id	TMDB kimliği — zorunlu
type	movie veya tv — zorunlu
poster	Poster görseli
backdrop	Arka plan görseli
genre	Türler (virgülle ayrılmış metin)
trailer	Fragman (YouTube vb.)
vote_average	TMDB puanı
overview	Özet / konu
runtime	Süre (film) veya bölüm bilgisi
release_date	Vizyon / ilk yayın tarihi

7.2 Tema uyumu

Şablonlarınızda [xfvalue_poster], [xfvalue_genre] gibi etiketler kullanıyorsanız eklenti eşlemesinde aynı alan adlarını seçin. Tema ve eklenti alan adları birebir eşleşmelidir.

---

8. Haber düzenleme (editnews) entegrasyonu

v3.0, DLE haber düzenleme sayfasına ek bir buton ekler:

• TMDB: Bilgileri Güncelle — kayıtta TMDB ID varsa eşleşen ilave alanları yeniden çeker
• İşlem sonrası atlanan alanlar varsa rapor gösterilir
• Onay ile sayfa yenilenerek güncel değerler editörde görülebilir

---

9. İlk kurulum kontrol listesi

• ✓ tmdb-movie-manager-pro-v3.0.xml yüklendi ve etkinleştirildi
• ✓ TMDB API anahtarı kaydedildi (Dashboard: API Aktif)
• ✓ tmdb_id ve type alan eşlemesi yapıldı
• ✓ Varsayılan kategori ve içerik türü ayarlandı
• ✓ En az bir film ve bir dizi test içe aktarıldı
• ✓ Site şablonunda poster / meta alanları görünüyor
• ✓ İçerikler sekmesinden güncelleme test edildi
• ✓ Admin panel dili değiştirilince arayüz çevrildi (çoklu dil testi)

---

10. Sık karşılaşılan sorunlar

Sorun	Çözüm
API Anahtarı Eksik	Temel Ayarlar → TMDB API Key alanını doldurun
Modül menüde yok	Eklentiyi etkinleştirin; DLE önbelleğini temizleyin
Menü ikonu kırık	public/adminpanel/images/tmdb-logo.png dosyasını kontrol edin; eklentiyi yeniden etkinleştirin
Aynı içerik iki kez eklendi	tmdb_id eşlemesi yapılmalı; JSON ve pipe formatı birlikte taranır
İlave alanlar boş	Alan Eşleştirme'de ilgili satır boş bırakılmamalı; alan sitede tanımlı olmalı
AJAX Hacking Attempt	Oturum açık olmalı; DLE 20'de URL: index.php?controller=ajax&mod=dbmovies
Güncelleme veriyi sildi	Yalnızca eşleştirilen alanlar yazılır; korumak istediğiniz alanı eşlemeden çıkarın
Resimler gelmiyor	Temel Ayarlar → resim indirme açık mı; sunucu uploads/ yazma izni

---

11. Eklenti dosya yapısı

engine/
├── inc/dbmovies.php          Admin modül girişi
├── modules/dbmovies.php      Panel arayüzü
├── ajax/dbmovies.php         AJAX işlemleri
├── classes/TMDB.php          TMDB API istemcisi
└── data/
    ├── dbmovies_config.php   Ayarlar (kurulumda oluşur)
    └── dbmovies_logs.txt     İşlem kayıtları

language/
├── Turkish/tmdb.lng
├── English/tmdb.lng
├── Russian/tmdb.lng
└── French/tmdb.lng

public/adminpanel/images/
└── tmdb-logo.png             Modül menü ikonu

---

12. Kaldırma notları

• Eklenti devre dışı bırakıldığında admin menü kaydı silinir
• engine/data/dbmovies_config.php ve log dosyası kalabilir — gerekirse manuel silin
• Kaldırma öncesi veritabanı ve engine/data/ yedeği alın

---

TMDB Movie Manager Pro v3.0 · DataLife Engine 20.0 native
Admin arayüz: TR / EN / RU / FR · JSON & Legacy XFields
dlehub.com.tr · Elegance
Sorunlarda önce API anahtarı, alan eşlemesi ve DLE önbelleğini kontrol edin.