# 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
```smarty
{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:
```powershell
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:**
```
```
**Yanlış:**
```html
<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