DLE Real Series PRO v1.0.8 — Hiyerarşik Film, Dizi, Sezon ve Bölüm Yönetimi (TMDB)

DLE Real Series PRO nedir?

DLE Real Series PRO DataLife Engine için hiyerarşik Film → Dizi → Sezon → Bölüm yönetim eklentisidir. TMDB’den tek tıkla metadata çeker, cron ile yeni bölümleri takip eder, SEO başlık şablonları ve xfield eşleştirme sunar.

• Paket: dle-real-series-pro.xml veya ZIP
• Sürüm: 1.0.8
• Uyumluluk: DLE 18.0+ / DLE 21
• Yönetim menüsü: Dizi Yönetimi
• Sekmeler: Keşfet · Filmler · Diziler · Sezonlar · Bölümler · Ayarlar · Değişiklik Denetle

Her dizi, sezon ve bölüm ayrı bir haber kaydıdır. Aralarındaki bağ _post tablosundaki şu kolonlarla kurulur:

• is_series — 0 film, 1 dizi, 2 sezon, 3 bölüm
• series_parent — bağlı olduğu dizi / üst kayıt
• series_season — sezon numarası
• series_episode — bölüm numarası

Kurulum

1. Yönetim paneli → Eklentiler → paketi yükleyin ve etkinleştirin.
2. Aşağıdaki iki noktayı kontrol edin (ikon elle, şablonlar otomatik).

DLE eklenti paketi yalnızca .php ve .lng dosyası oluşturabilir. Bu bir DLE kısıtıdır (engine/ajax/plugins.php içinde clearfilepath(..., array("php","lng"))).

1) Panel ikonu (elle)

plugins/dle_series/series_icon.png  →  public/adminpanel/images/series_icon.png

engine/inc/options.php ikonu DLE kök dizinine göre çözer. Dosya yoksa panel sessizce varsayılan ikonu gösterir; eklenti çalışmaya devam eder. Bu yüzden _admin_sections.icon alanına tam yol yazılmıştır.

2) Şablon dosyaları (eklenti kendi yazar)

.tpl dosyaları phpinstall / phpupgrade / phpenable içinde file_put_contents ile üretilir (FAQ eklentisiyle aynı desen).

Kurallar:

• Yazıldığı yer: ROOT_DIR/templates/<aktif_tema>/
• Var olan dosya asla ezilmez — tema özelleştirmeleriniz korunur.
• Eksik şablon varsa eklentiyi pasife alıp yeniden aktif edin.
• Kaldırmada (phpdelete) şablonlar silinmez.
• fullstory.tpl bulunamazsa 3 detay şablonu yazılmaz; sayfa yine normal fullstory.tpl zinciriyle çalışır.

Şablon	Ne işe yarar	Nasıl üretilir
season_list.tpl	Bir sezonun kartı (dizi sayfasında tekrar eder)	Sabit içerik, eklentiye gömülü
episode_list.tpl	Bir bölümün kartı (sezon/bölüm sayfasında tekrar eder)	Sabit içerik, eklentiye gömülü
series_details.tpl	Dizi tam sayfa düzeni	Sizin fullstory.tpl kopyalanır + dizi bloğu eklenir
season_details.tpl	Sezon tam sayfa düzeni	Aynı yöntem
episode_details.tpl	Bölüm tam sayfa düzeni	Aynı yöntem

Temanın kullanabileceği tüm etiketler

Bu dosyaları düzenleyerek tasarımı tamamen değiştirebilirsiniz. Aşağıdaki listeler eklentinin sağladığı sözleşmedir.

season_list.tpl — her sezon için tekrar eder

Etiket	İçerik
{full-link}	Sezon sayfasının tam adresi
{title}	Sezon başlığı (HTML-escape edilmiş)
{news-id}	Sezon kaydının haber ID’si
{season_number}	Sezon numarası (sayı)
{series_title}	Bağlı olduğu dizinin adı
{date} / {date=d.m.Y}	Yayın tarihi

XField blokları (her alan için üçlü: [xfgiven_ALAN] · [xfnotgiven_ALAN] · [xfvalue_ALAN]):

Alan	Blok örneği
season_poster	[xfgiven_season_poster]...[/xfgiven_season_poster]
season_year	aynı üçlü
season_overview	aynı üçlü
season_episode_count	aynı üçlü
season_vote_average	aynı üçlü

episode_list.tpl — her bölüm için tekrar eder

season_list.tpl etiketlerinin tümü geçerlidir, artı:

Etiket	İçerik
{episode_number}	Bölüm numarası (sayı)
{current-class}	Şu an okunan bölümde is-watching, değilse boş

Koşullu bloklar:

[current-episode] ... [/current-episode]           <!-- şu an okunan bölüm -->
[not-current-episode] ... [/not-current-episode]   <!-- diğerleri -->
[new] ... [/new]
[not-new] ... [/not-new]                           <!-- DLE "yeni" işareti -->

Ek XField alanları (yine her biri [xfgiven_X] / [xfnotgiven_X] / [xfvalue_X]):

episode_image, episode_name, episode_vote, episode_year, ep_runtime, ep_vote_count, ep_guest_stars, ep_crew, ep_production_code, kalite, dil — artı sezon alanları (season_poster vb.).

series_details.tpl · season_details.tpl · episode_details.tpl

fullstory.tpl’in aldığı tüm DLE etiketleri geçerlidir. Eklenti bunlara şunları ekler:

Etiket	İçerik
{content_type}	Film / Dizi / Sezon / Bölüm
{series_link}	Dizinin ana sayfa adresi
{series_title}	Dizi adı
{season_number}	Sezon numarası
{episode_number}	Bölüm numarası
{series_list}	Sezon / bölüm kartlarının HTML listesi
{season_navigation}	Sezonlar arası ileri / geri
{series_navigation}	Bölümler arası önceki / sonraki / TÜM BÖLÜMLER

Koşullu bloklar:

[series_list] ... [/series_list]           <!-- liste varsa -->
[not-series_list] ... [/not-series_list]   <!-- liste yoksa -->
[season_nav] ... [/season_nav]             <!-- sezon navigasyonu varsa -->
[series_nav] ... [/series_nav]             <!-- bölüm navigasyonu varsa -->

Kritik: {series_list} veya [series_list] şablonda yoksa liste hiç görünmez. DLE bilinmeyen etiketi sessizce siler. Eklentinin otomatik oluşturduğu detay şablonları bu etiketi içerir. Elle kopyaladığınız eski fullstory.tpl’de yoksa eklemeniz gerekir.

Nasıl kullanılır? (yönetim paneli)

1. Ayarlar → 1. Temel API: TMDB v3 API anahtarını girin, kaydedin.
2. Ayarlar → 3. Yayın ve SEO: Film / Dizi / Sezon / Bölüm için 4 varsayılan kategoriyi seçin. Seçilmezse panel uyarı gösterir.
3. Ayarlar → xfield eşleştirme: TMDB alanlarını kendi xfield’larınızla bağlayın. Boş bırakılanlar eşleştirilmez.
4. Eksik alanları kur: Gerekli xfield’ları engine/data/xfields.json dosyasına ekler.
5. Keşfet: TMDB’den içerik bulun, tek tıkla ekleyin.
6. Diziler → Sezon Çek / Bölüm Çek: Hiyerarşiyi oluşturun.

Cron (otonom bölüm takibi)

Panelin gösterdiği adres:

https://siteniz/index.php?controller=ajax&mod=series_cron&key=<CRON_KEY>

engine/ajax/series_*.php dosyalarına doğrudan girilemez (engine/.htaccess dizini kapatır). Çağrı DLE AJAX denetleyicisi üzerinden yapılır. cron_enable kapalıysa cron çalışmaz.

Ön yüz stilleri

Ön yüzde site temasının CSS’ine güvenilmez. DLE 21 varsayılan temaları (Air, Chronicle, Cover, Flow, Overview) Bootstrap değildir; FontAwesome da yüklenmez. Eklenti kendi stillerini basar:

• engine/modules/series_list.php → <style> + .rsp-* sınıfları
• engine/modules/show.full.php yaması → {season_navigation} / {series_navigation} değerlerinin başına kısa stil

Sınıflar .rsp- öneklidir, şablonunuzla çakışmaz. Kendi <style> bloğunuzda ezebilirsiniz. Stil gövdeye basılır (tema <head>’ine erişim yok); tarayıcılar uygular, HTML doğrulayıcı uyarı verebilir.

Güvenlik

• Tüm AJAX uçları ve ayar kaydı user_hash (CSRF) ister.
• Cron key parametresiyle korunur; kapalıysa çalışmaz.
• SQL’de sayılar intval(), tablolar PREFIX sabitidir.
• Yazılan ayar dosyası: engine/data/series_config.php — içerik var_export() ile üretilir (PHP enjeksiyonu yok).
• TMDB istekleri önce TLS sertifika doğrulamasıyla gider. Sunucuda CA yoksa (bazı paylaşımlı hostingler) bir kez doğrulamasız tekrar denenir.

Kaldırma

phpdelete şu dosyaları siler:

engine/inc/series_admin.php
engine/ajax/series_fetch.php
engine/ajax/series_tmdb.php
engine/ajax/series_cron.php
engine/modules/series_list.php
engine/modules/rsp_series_title.php
engine/data/series_config.php
engine/cache/system/xfields.php

Tema şablonlarına dokunulmaz. season_list.tpl, episode_list.tpl ve *_details.tpl sizin düzenlemeniz olabilir, silinmez.

mysqldelete _post tablosundan is_series, series_parent, series_season, series_episode kolonlarını ve _admin_sections kaydını kaldırır.

Eklenti XML olarak yüklenirse DLE filelist alanını boş bırakabilir; filedelete işe yaramaz. Dosya temizliği bu yüzden phpdelete ile yapılır.

Üçü de bu eklenti için temiz geçer.