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

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.

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

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

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

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.