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

• ✓ Şablon movie seçildi, cache temizlendi
• ✓ İlave alanlar tema ile aynı isimlerde
• ✓ Kategoriler oluşturuldu (Film / Dizi vb.)
• ✓ main.tpl içindeki slider category="1,2,3,4,5,6" ID’lerini kendi kategori ID’lerinize göre düzenlediniz
• ✓ Menü linkleri (/filmler/, /diziler/, /imdb-top/, /populer/) gerçek kategori veya özel sayfa URL’lerinize uyarlandı
• ✓ random.php kökte
• ✓ movie_stats.php engine/modules altında
• ✓ TMDB eklentisi kurulu, mapping kaydedildi
• ✓ Sidebar sosyal linkleri (#) gerçek hesap URL’leriyle değiştirildi

---

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

• Sadece anasayfada: [available=main]
• Kaynak: {custom limit="15" template="story_item" ...}
• Poster alanı (poster) dolu olmalı
• Tıklanınca modal açılır; sonraki/önceki story, progress bar, izlendi (gri halka) desteklenir

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"}

• category değerlerini kendi kategori ID’lerinizle değiştirin
• Şablon: modules/slider.tpl
• Alanlar: backdrop_path, poster, imdb_rating, year, runtime

5.3 Haber grid

• shortstory.tpl → kart görünümü
• Kalite rozeti: [xfvalue_quality]
• Puan: imdb_rating (yoksa vote_average)

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)

• DLE xfield içine ham <iframe> yazmayın; sistem temizler.
• Sadece URL kaydedin; JS iframe oluşturur.
• Sekmeler: Player 1 / Player 2 / Fragman
• Sinema modu: "Işıkları Kapat / Aç"

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

• Her TMDB verisi bir DLE xfield’a bağlanır
• "— Kaydetme —" seçilirse o veri yazılmaz
• Şablon ipucu formatı: [xfvalue_alanadi] (süslü parantez değil)

Ö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

• Yeni haber: TMDB panelinden ara → Habere ekle
• Mevcut haber: Düzenle → tmdb_id yanında Info Güncelle → alanlar forma dolar → mutlaka Güncelle ile kaydedin

8.4 Dikkat

• player, player2, quality eklenti tarafından yazılmaz
• TMDB’de sosyal ID yoksa Facebook/Twitter/Instagram boş kalır
• Eklenti güncellemesinden sonra mapping’i bir kez kaydedin

---

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)

• Avatar yoksa: /templates/movie/dleimages/noavatar.png
• Form alan adlarını değiştirmeyin (name, subj, add, submit, sec_code)
• [sec_code] / [recaptcha] sadece yeni mesaj formunda
• {user-dialog} yalnızca [readpm] içinde

---

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])

• Xfield etiketleri: [xfvalue_alan] (köşeli)
• Etiket yanlış sayfada / yanlış blokta olabilir (örn. PM’de author-dialog yerine user-dialog)

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ı

• Çekirdek DLE dosyalarını fiziksel olarak düzenlemeyin; eklentiler VFS (plugin.xml) ile gelsin.
• Tema güncellemesinde xfields.json ve mapping’i yedekleyin.
• Custom {custom category=...} satırlarındaki kategori ID’lerini her ortamda gözden geçirin.

---

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