Cinevault Tema Kullanım Kılavuzu

Tema: Cinevault v1.0
Klasör: Cinevault
DLE: 19.0+ / 20.0 uyumlu (20.0 önerilir)
Tip: Film / dizi sinema portalı (açık zemin, antrasit header, mat altın aksan)
Önerilen eklenti: TMDB Movie Manager Pro v3.0 (çoklu dil admin arayüzü; poster, meta, fragman alanlarını otomatik doldurur)

Bu doküman kurulum, ilave alan (xfield) içe aktarma, anasayfa bileşenleri, fullstory yapısı, menü URL'leri, mobil uyum ve sık sorunları kapsar.

1. Gereksinimler

Gereksinim Açıklama
DataLife Engine 19.0 veya üzeri (20.0 önerilir — AJAX, editör, güvenlik)
PHP / MySQL DLE'nin desteklediği sürümler
Tema klasörü /templates/Cinevault/
İlave alanlar Gerekli — tema xfields.json ile TMDB uyumlu film/dizi alanları kullanır
TMDB Movie Manager Pro Zorunlu değil; manuel doldurma mümkün. Otomasyon için şiddetle önerilir.

2. Kurulum

2.1 Tema dosyaları

  1. Cinevault klasörünü şuraya kopyalayın: 
    /templates/Cinevault/
  2. Admin → Ayarlar → Sistem ayarları → Genel
    Aktif şablon: Cinevault
  3. Önbelleği temizleyin (Admin → Araçlar / Cache).
  4. Tarayıcıda hard refresh (Ctrl+F5).

2.2 İlave alanları içe aktarma

  1. Admin → İlave alanlar (Extra fields).
  2. Cinevault/xfields.json dosyasını içe aktarın veya alanları bu dosyaya göre oluşturun.
  3. Grup adı: Film ve Dizi İlave alanları (film-alanlari).
  4. TMDB eklentisi kullanıyorsanız alan adlarının eşleştiğini (genre, poster, trailer, backdrop vb.) eklenti ayarlarından doğrulayın.

Önemli: genre alanı virgülle ayrılmış metin olarak gelir (ör. Aksiyon, Gerilim, Bilim-Kurgu). Tema bunu otomatik ayrı pill/chip'lere böler — alanı tek parça kaydetmeniz yeterlidir.

2.3 DLE 20.0 notları

3. İlk yapılandırma kontrol listesi

4. Marka ve renkler

CSS değişkenleri (css/styles.css → :root):

Token Değer Kullanım
--mist #f4f4f6 Sayfa arka planı
--porcelain #fbfbfc Kart / panel
--anthracite #1a2123 Header, koyu bantlar
--gold #d4af37 Ana vurgu (altın)
--gold-deep #b8962e Link hover, rozet
--gold-grad gradient Butonlar, CTA
--line #e4e5e9 Kenarlıklar
--max 1200px İçerik genişliği
--display Cormorant Garamond Başlık fontu
--ui Manrope Arayüz fontu

Logo metni: Cinevault — main.tpl → .cv-brand-mark

Footer metinleri ve linkleri main.tpl footer bölümünden düzenlenir.

Fontlar Google Fonts ile yüklenir (main.tpl <head>).

CSS/JS cache: styles.css?v=... ve main.js?v=... sürüm parametrelerini güncelleyerek tarayıcı önbelleğini kırabilirsiniz.

5. Anasayfa bileşenleri

Anasayfa blokları main.tpl içinde [available=main] ile gelir.

Bölüm Şablon / kaynak Açıklama
Hero carousel story_hero.tpl 5 slayt, poster + backdrop, puan/yıl/süre/tür chip'leri
Kategori kartları collection_card.tpl {catmenu template="collection_card"} — yatay kaydırma
Fragman halkaları story_ring.tpl xfields="trailer" olan içerikler; tıklayınca story viewer
Son filmler grid shortstory.tpl {content} — kategori / ana liste
Popüler topnews.tpl Alt bant, numaralı poster sırası
Son yorumlar modules/lastcomments.tpl {customcomments ...}
Etiket bulutu tagscloud.tpl Son yorumların yanında iki sütun (.cv-home-duo)

5.1 Örnek custom etiketleri

{custom category="1-50" template="story_hero" limit="5" order="date" cache="no"}
{custom category="1-50" xfields="trailer" template="story_ring" limit="16" order="date" cache="no"}
{customcomments name="homecomments" template="modules/lastcomments" available="global" from="0" limit="5" order="date" sort="desc" cache="yes"}

category="1-50" yer tutucudur. Kendi film/dizi kategori ID aralığınızla değiştirin.

5.2 Fragman story viewer

5.3 Canlı arama

6. Film / dizi detay (fullstory.tpl)

6.1 Üst bant (hero)

6.2 Alt bölümler

6.3 Fragman modal

Poster altındaki Fragman butonu veya JS ile inline oynatıcı; YouTube embed destekler. Trailer alanı boşsa buton gizlenir.

7. Kullanılan ilave alanlar (özet)

Tam liste xfields.json içindedir. Şablonda en çok kullanılanlar:

Alan adı Açıklama
poster Poster URL
backdrop Arka plan görsel URL
trailer YouTube / embed fragman
genre Türler (virgülle ayrılmış)
year, runtime, age_rating Yıl, süre, yaş sınırı
vote_average, vote_count TMDB puanı
overview Özet / konu metni
original_title, tagline Orijinal ad, slogan
director, writer, main_actors Ekip bilgisi
videos Oynatıcı kaynakları (JSON)
backdrops Ek arka plan galerisi
keywords, alternative_titles Anahtar kelime, diğer adlar
imdb_id, tmdb_id, tvdb_id Harici ID linkleri
number_of_seasons, number_of_episodes Dizi sezon/bölüm

8. Liste kartları

Şablon Kullanım
shortstory.tpl Kategori / ana grid — poster, puan, yıl, süre rozeti
topnews.tpl Popüler şerit — büyük sıra numarası + poster
relatednews.tpl Fullstory benzer içerikler
searchresult.tpl Gelişmiş arama sonucu
fastsearchresult.tpl Header canlı arama satırı

9. Kullanıcı arayüzü sayfaları

Dosya Görev
login.tpl Giriş formu + kompakt kullanıcı dropdown menüsü (ikonlu)
userinfo.tpl Profil görüntüleme / düzenleme
pm.tpl Özel mesajlar
registration.tpl / lostpassword.tpl Üyelik
feedback.tpl İletişim formu
addnews.tpl İçerik ekleme (kullanıcı)
stats.tpl Site istatistikleri
comments.tpl / addcomments.tpl Yorum listesi ve form

10. Menü ve URL'ler

Üst menü main.tpl içinde sabit tanımlıdır; mobilde hamburger menü (#cv-mobile-nav) açılır.

Footer linkleri: İletişim, İstatistik, Arama — main.tpl içinden özelleştirilebilir.

Kategori kartları için Admin → Kategoriler'den kategori ikonu (görsel) atayabilirsiniz — collection_card.tpl kullanır.

11. TMDB Movie Manager Pro v3.0 entegrasyonu

v3.0 yenilikleri (v2.1'e göre): DLE 20 native admin arayüzü; admin panelde Türkçe, English, Русский, Français dil desteği; JSON + Legacy ilave alan uyumu; birleşik İçerik Aktar sekmesi; Platformlar keşfi; mevcut içerikleri güncelleme (İçerikler + editnews butonu); dashboard Sistem Bilgileri paneli.

11.1 Kurulum

  1. tmdb-movie-manager-pro-v3.0.xml dosyasını Admin → Eklentiler'den yükleyin ve etkinleştirin.
  2. Admin → Diğer Bölümler → TMDB Film Yönetimi.
  3. Temel Ayarlar → TMDB API anahtarınızı kaydedin (themoviedb.org).
  4. Alan Eşleştirme → tema xfields.json adlarıyla aynı isimleri seçin veya TMDB Alanlarını Oluştur.

11.2 Çoklu dil (admin arayüzü)

Eklenti admin paneli, DLE yönetim dilinize göre otomatik çevrilir:

11.3 Tema ile eşleşen alanlar

  1. Film/dizi eklerken İçerik Aktar sekmesinden TMDB'den içe aktarın — poster, backdrop, tür, ekip, fragman otomatik dolar.
  2. genre alanı eklenti tarafından Aksiyon, Gerilim, ... formatında yazılır; tema bunu pill/chip olarak böler.
  3. trailer dolu olursa anasayfa fragman halkalarında görünür.
  4. Mevcut içerikleri İçerikler sekmesinden veya haber düzenleme sayfasındaki TMDB: Bilgileri Güncelle butonu ile yenileyin.

Detaylı eklenti kılavuzu: tmdb-movie-manager-pro-v3.0-dle_kullanim_kilavuzu_editor.html (DLE editörüne HTML olarak yapıştırılabilir).

12. İçerik ekleme önerileri

  1. Doğru kategoriyi seçin (Film / Dizi)
  2. Poster ve mümkünse backdrop yükleyin veya TMDB'den çekin
  3. Fragman (trailer) doldurun — anasayfa halkalarında görünür
  4. Konu metnini overview veya tam habere yazın
  5. Oynatıcı için videos JSON alanını doldurun (veya tam habere embed)
  6. Etiketleri ekleyin (fullstory pill etiketleri)
  7. Tür alanını virgülle ayırın; tema otomatik pill yapar

13. Önerilen DLE ayarları

Ayar Öneri
Kategori sıralama Açık — [sort]{sort}[/sort] çubuğu görünür
Benzer içerikler Açık — fullstory altında
Yorum WYSIWYG Açık — altın editör stili hazır
SEO friendly URL Açık — menü linklerini buna göre güncelleyin
Önbellek Değişiklik sonrası mutlaka temizleyin

14. Mobil uyum

15. Tema dosya yapısı

Cinevault/
├── main.tpl              Ana iskelet
├── fullstory.tpl         Film/dizi detay
├── shortstory.tpl        Liste kartı
├── story_hero.tpl        Hero slayt
├── story_ring.tpl        Fragman halkası
├── collection_card.tpl   Kategori kartı
├── topnews.tpl           Popüler şerit
├── tagscloud.tpl         Etiket widget
├── login.tpl             Giriş / kullanıcı menüsü
├── css/
│   ├── styles.css        Tema stilleri
│   └── engine.css        DLE çekirdek UI (Cinevault Theme)
├── js/
│   └── main.js           Hero, arama, fragman, sürükle-kaydır
├── dleimages/            Avatar, sprite, marker SVG/PNG
├── images/               favicon, no-poster
├── modules/
│   └── lastcomments.tpl
└── xfields.json          İlave alan tanımları

16. Sık karşılaşılan sorunlar

Sorun Çözüm
Hero / fragman boş category= ID'lerini düzeltin; içerikte trailer alanı dolu olsun
Poster görünmüyor poster xfield veya {image-1}; no-poster.svg yedek
Türler birleşik data-fs-split-chips + main.js yüklü olmalı; cache temizleyin
Çift arama kutusu Eski önbellek; #searchsuggestions gizli — Ctrl+F5
CSS eski DLE cache + ?v= parametresini artırın
dleimages 404 dleimages/ klasörünü eksiksiz yükleyin (SVG + PNG)
Menü / kategori 404 SEO URL'lerinize göre main.tpl linklerini güncelleyin
İlave alan ham etiket görünüyor Alan adı şablondaki ile aynı değil veya xfields.json import edilmedi
Fragman oynamıyor trailer alanında geçerli YouTube URL / embed kodu olmalı

17. Siteyi yayına almadan önce

  1. xfields.json içe aktarıldı; TMDB kullanıyorsanız alan eşlemesi yapıldı
  2. main.tpl içindeki kategori ID'leri ve menü URL'leri siteye göre güncellendi
  3. En az bir film ve bir dizi örneği poster, fragman ve fullstory ile test edildi
  4. Anasayfa bölümleri (hero, fragman, popüler, yorumlar) içerik gösteriyor
  5. Masaüstü ve mobil görünüm kontrol edildi
  6. Giriş, kayıt, mesajlar ve iletişim formları çalışıyor
  7. Canlı arama sonuç döndürüyor
  8. Şablon önbelleği temizlendi; favicon görünüyor

Cinevault v1.0 · DataLife Engine 19/20 uyumlu sinema teması
Sorunlarda önce şablon önbelleğini temizleyin; ardından kategori ID, ilave alan ve menü URL'lerini kontrol edin.

Dosya İndirme Kilitli