FilmHD Tema Kullanım Kılavuzu

Tema: FilmHD v1.0.0
DLE: 19.0+
Tip: Koyu film / dizi teması

Bu doküman kurulum, ilave alanlar, TMDB eklentisi, şablon etiketleri, menü ayarları ve sık karşılaşılan sorunları kapsar.

1. Gereksinimler

Gereksinim Açıklama
DataLife Engine 19.0 veya üzeri
PHP DLE’nin desteklediği sürüm
TMDB API anahtarı Film verisi çekmek için (opsiyonel ama önerilir)
OMDB API anahtarı IMDb / Rotten / Metacritic için (opsiyonel)

2. Kurulum

2.1 Tema dosyaları

  1. movie klasörünün içeriğini site kökündeki şu yola kopyalayın: 
    /templates/movie/
  2. Admin → Ayarlar → Sistem ayarları → Genel
    Aktif şablon: movie (veya klasör adınız)
  3. Önbelleği temizleyin (Admin → Araçlar / Cache).

2.2 İlave alanlar (xfields.json)

  1. Temadaki xfields.json dosyasını yedekleyin.
  2. Admin’de mevcut ilave alanlarınız yoksa veya tema ile uyumlu hale getirmek istiyorsanız:
    • templates/movie/xfields.json içeriğini engine/data/xfields.json ile senkronlayın
    • veya Admin → İlave alanlar üzerinden aynı Alan Adı’ları oluşturun.
  3. Önemli: Şablonlar alan açıklamasına değil, alan adına (poster, player vb.) bakar.

2.3 Rastgele film (random.php)

  1. Temadaki random.php dosyasını site köküne kopyalayın (DLE’nin index.php ile aynı seviye).
  2. Menüde şu adresi kullanın: /random.php

2.4 İstatistik modülü

engine/modules/movie_stats.php dosyasını sunucudaki şu yola atın:

/engine/modules/movie_stats.php

Sidebar bu dosyayı {include file="engine/modules/movie_stats.php"} ile çağırır.

2.5 TMDB eklentisi

  1. Admin → Eklentiler → Eklenti yükle
  2. engine/tmdb-film-dizi-eklentisi.xml dosyasını yükleyin / güncelleyin
  3. Admin menüsünden TMDB Film & Dizi bölümüne girin
  4. API anahtarlarını kaydedin
  5. Alan Eşleştirme sekmesinde bir kez Kaydet basın

3. İlk yapılandırma kontrol listesi

4. Marka ve renkler

CSS değişkenleri / Tailwind tema renkleri:

Token Renk Kullanım
movie-bg #1a1d29 Sayfa arka planı
movie-card #252836 Kart / panel
movie-accent #f59e0b Vurgu (sarı/turuncu)

Logo metni main.tpl içinde FilmHD olarak geçer; değiştirmek için main.tpl + offline.tpl + preloader metinlerini aratın.

5. Anasayfa bileşenleri

5.1 Stories

5.2 Hero slider

{custom category="1,2,3,4,5,6" template="modules/slider" from="0" limit="5" order="date" sort="desc" cache="yes"}

5.3 Haber grid

5.4 Sidebar (sidebar.tpl)

Blok Açıklama
Mood butonları Etiket linkleri (aksiyon, komedi…) — tag slug’larınızı uyarlayın
Kategoriler {catmenu}
Popüler Filmler Okunma sırasına göre custom liste
Son Yorumlar {customcomments ...}
İstatistikler movie_stats.php
Popüler Etiketler {tags}
Sosyal Site geneli takip linkleri (elle doldurun)
IMDb Top 10 sidebar bloğu temadan kaldırılmıştır; Popüler yeterlidir.

6. Film detay sayfası (fullstory.tpl)

6.1 Player

Alan Kullanım
player Player 1 — manuel URL (iframe değil, sadece URL)
player2 Player 2 — manuel
trailer Fragman (YouTube / embed URL)

6.2 Galeriler

Alan Format
backdrops Virgülle ayrılmış backdrop URL listesi
poster_gallery Virgülle ayrılmış poster URL listesi

TMDB eklentisi bunları otomatik doldurabilir.

6.3 Künye ve puanlar

Gösterilen başlıca alanlar: imdb_rating, imdb_votes, rotten, meta, director, writer, producer, composer, genres, cevirmen, budget, revenue, profit, studios, networks, akas, dizi alanları (number_of_seasons vb.), sosyal (facebook, twitter, instagram).

Boş alanlar [xfgiven_...] ile gizlenir.

7. İlave alanlar (tam liste)

Şablon etiketi: [xfvalue_ALAN] · Koşul: [xfgiven_ALAN]...[/xfgiven_ALAN]

Otomatik (TMDB / OMDB — mapping’e bağlı)

Alan adı Açıklama Not
tmdb_id TMDB ID Info Güncelle için gerekli
poster Poster URL
backdrop_path Ana arka plan
original_title Orijinal isim
release_date Vizyon / çıkış tarihi
year Yıl Link olarak da kullanılabilir
vote_average TMDB puanı
vote_count TMDB oy sayısı
runtime Süre (dk)
tagline Slogan
homepage Resmi site
imdb_id tt…
genres Türler
director Yönetmen
writer Senarist
cast Oyuncular
trailer Fragman URL
popularity Popülerlik
original_language Dil kodu
studios Stüdyo
countries Ülke
spoken_languages Diller
budget Bütçe
revenue Hasılat
profit Kâr
status Durum
keywords Anahtar kelimeler
certification Sertifika
release_dates Sertifika tarihi vb.
overview Kısa açıklama
plot Detaylı özet OMDB Plot veya overview
watch_providers Platform rozetleri HTML gelebilir
collection Seri / koleksiyon
imdb_rating IMDb puanı OMDB
imdb_votes IMDb oy OMDB
rotten Rotten Tomatoes OMDB rt_rating → rotten
meta Metacritic OMDB mc_rating → meta
awards Ödüller OMDB
producer Yapımcı
composer Müzik
backdrops Galeri
poster_gallery Afiş galerisi
networks TV kanalı
akas Diğer isimler
number_of_seasons Sezon Dizi
number_of_episodes Bölüm Dizi
last_air_date Son yayın Dizi
next_episode_to_air Gelecek bölüm Dizi
in_production Yapımda (1/0) Dizi
facebook Facebook URL TMDB external_ids
twitter Twitter/X URL
instagram Instagram URL

Manuel (otomatik doldurulmaz)

Alan adı Açıklama
player Player 1 embed URL
player2 Player 2 embed URL
quality Kalite listesi (1080p, 4K…) — kartlarda
kalite İkinci kalite listesi (isterseniz)
download İndirme linki
cevirmen Altyazı çevirmeni

8. TMDB eklentisi kullanımı

8.1 Ayarlar

  1. TMDB API Key
  2. Dil: örn. tr-TR
  3. Bölge: örn. TR
  4. OMDB: açıp anahtar girin (IMDb / RT / Meta için)
  5. Görselleri indirme: isteğe bağlı

8.2 Mapping

Admin → TMDB → Alan Eşleştirme

Önerilen kritik eşlemeler:

TMDB anahtarı Xfield
rt_rating rotten
mc_rating meta
imdb_votes imdb_votes
facebook / twitter / instagram aynı isimler

8.3 Haber ekleme / güncelleme

8.4 Dikkat

9. Menü ve URL’ler

main.tpl üst menü (örnek — kendi URL’lerinize uyarlayın):

Metin Örnek URL
Ana Sayfa /
Filmler /filmler/
Diziler /diziler/
IMDb Top 250 /imdb-top/
Popüler /populer/
Rastgele Film /random.php

Kategori SEO URL’leri Admin → Kategoriler’den ayarlanır.

10. Tailwind / CSS derleme

Tema Tailwind kullanır. Şablon veya input.css değişince:

cd templates\movie
.\tailwind.exe -i .\assets\css\input.css -o .\assets\css\style.css -c .\tailwind.config.js --minify
Copy-Item .\assets\css\style.css .\assets\css\output.css -Force

main.tpl şu dosyayı yükler:

{THEME}/assets/css/style.css
{THEME}/assets/css/engine.css

Önemli: Derlenmemiş Tailwind sınıfları (özellikle w-[68px] gibi arbitrary değerler) CSS’te yoksa düzen bozulur. Değişiklik sonrası mutlaka build alın.

11. Önemli dosya haritası

templates/movie/
├── main.tpl # Ana iskelet, Stories, slider, header/footer
├── fullstory.tpl # Film detay + player + künye
├── shortstory.tpl # Kart listesi
├── sidebar.tpl # Sağ sütun
├── story_item.tpl # Stories öğesi
├── pm.tpl # Özel mesajlar
├── search.tpl / searchresult.tpl
├── comments.tpl / addcomments.tpl
├── xfields.json # İlave alan şeması
├── info.json # Tema meta
├── .htaccess # Güvenlik
├── assets/css/
│ ├── style.css # Derlenmiş Tailwind (yayın)
│ ├── output.css # Yedek kopya
│ ├── input.css # Kaynak
│ └── engine.css # DLE bileşen stilleri
├── modules/
│ ├── slider.tpl
│ ├── sidebar-mini.tpl
│ └── lastcomments.tpl
└── engine/ # Paket içi kopyalar (sunucuya ayrı konumlara)
├── tmdb-film-dizi-eklentisi.xml
└── modules/movie_stats.php

Site kökü:
└── random.php

12. Eksik Default şablonlar (isteğe bağlı)

Default temada olup FilmHD kökünde olmayanlar:

Dosya Ne zaman gerekir
tagscloud.tpl {tags} görünümü için önerilir
vote.tpl {vote} kullanırsanız
addnews.tpl / preview.tpl Ön yüzden haber ekleme
print.tpl / static_print.tpl Yazdır
attachment.tpl Habere dosya eki
informer.tpl RSS bilgilendirici

Gerekirse Default’tan kopyalayıp temaya uyarlayın.

13. Player / fragman URL kuralları

Doğru örnekler:

https://www.youtube.com/watch?v=XXXX
https://www.youtube.com/embed/XXXX
https://player.ornek.com/embed/film123

Yanlış:

<iframe src="..."></iframe>

14. Özel mesajlar (pm.tpl)

15. SSS / sorun giderme

Stories kocaman / bozulmuş görünüyor

Tailwind build alınmamış olabilir. style.css’i yeniden derleyip sunucuya atın.

Panelde veri var, sitede yok

  1. Alan adı ile şablon etiketi aynı mı?
  2. [xfgiven_alan] boşsa blok gizlenir
  3. Info Güncelle sonrası Güncelle’ye basıldı mı?
  4. Doğru habere mi bakıyorsunuz?

Player sekmesi çıkmıyor

player / player2 boştur; manuel doldurun. Fragman için trailer dolu olmalı.

Ham etiket basıyor ({xfvalue_...} veya [sec_code])

Sosyal ikonlar film sayfasında yok

facebook / twitter / instagram boş — TMDB’de ID yoksa veya mapping kaydedilmemiş olabilir.

Slider boş

category="..." ID’lerini kontrol edin; o kategorilerde onaylı haber olmalı.

İstatistikler 0

movie_stats.php yolu doğru mu? Cache temizlendi mi?

16. Yayın checklist

  1. Tüm tema dosyaları /templates/movie/
  2. style.css (+ gerekirse output.css) güncel
  3. random.php kökte
  4. movie_stats.php → /engine/modules/
  5. TMDB XML yüklü, mapping kaydedildi
  6. Menü / kategori URL’leri canlıya göre
  7. Sidebar sosyal # linkleri gerçek URL
  8. Test: anasayfa Stories + slider, bir film detayı (player/künye/galeri), arama, PM, yorum
  9. DLE cache temizle

17. Destek notları

FilmHD — DLE 19 film/dizi teması kullanım kılavuzu · v1.0.0

Dosya İndirme Kilitli