Guide d'utilisation du thème Cinevault

Thème : Cinevault v1.0 ;
Dossier : Cinevault
DLE : compatible 19.0+ / 20.0 (20.0 recommandé) ;
Type : Portail de films et séries (fond clair, en-tête anthracite, accents or mat) ;
Extension recommandée : TMDB Movie Manager Pro v3.0 (interface d’administration multilingue ; remplissage automatique des champs affiche, métadonnées et bande-annonce)

Ce document traite de la configuration, de l'importation de champs supplémentaires (xfields), des composants de la page d'accueil, de la structure de l'article complet, des URL du menu, de la compatibilité mobile et des problèmes courants.

1. Exigences

2. Installation

2.1 Fichiers de thème

1. CinevaultCopiez le dossier à cet emplacement :

   /templates/Cinevault/

   
   
2. Administration → Paramètres → Paramètres système → Général
   Modèle actif : Cinevault
3. Vider le cache (Admin → Outils / Cache).
4. Actualisation forcée dans le navigateur (Ctrl+F5).

2.2 Importation de champs supplémentaires

1. Admin → Champs supplémentaires .
2. Cinevault/xfields.jsonImportez le fichier ou créez les champs à partir de ce fichier.
3. Nom du groupe : Films et séries Champs supplémentaires ( film-alanlari).
4. Si vous utilisez un plugin TMDB, vérifiez que les noms de domaine correspondent (genre, affiche, bande-annonce, arrière-plan, etc.) dans les paramètres du plugin.

Important : genre Le champ est fourni sous forme de texte séparé par des virgules (par exemple : Action, Thriller, Science-fiction ). Le thème le divise automatiquement en plusieurs éléments ; il vous suffit de l’enregistrer en un seul bloc.

2.3 DLE 20.0 notes

• Recherche en direct : index.php?controller=ajax(l’ancienne engine/ajax/méthode ne fonctionne plus)
• Éditeur de commentaires et interface principale DLE :css/engine.css
• dleimages/Le dossier contient des images d'avatar, d'icônes de partage et de marqueurs.

3. Liste de contrôle de la configuration initiale

• ✓ Modèle Cinevaultsélectionné, cache vidé.
• ✓ xfields.jsonimporté
• ✓ Des catégories Films et Séries TV ont été créées (Films, Séries TV, etc.)
• ✓ Remplacez les valeurs main.tplà l'intérieur par votre plage d'ID de catégorie réelle .category="1-50"
• ✓ Les liens du menu principal ( filmler, diziler) ont été adaptés à vos propres URL SEO.
• ✓ TMDB Movie Manager Pro v3.0 a été installé, la clé API a été saisie et le mappage de domaine a été effectué (recommandé).
• ✓ Testé avec au moins 1 film + 1 série télévisée (affiche/bande-annonce).
• ✓ Page d'accueil principale, anneaux de bande-annonce, populaire, article complet vérifié pour mobile et ordinateur
• ✓ Recherche en direct (icône de recherche dans l'en-tête) testée

4. Marques et couleurs

Variables CSS ( css/styles.css→ :root) :

Texte du logo : Coffre-fort cinématographique — main.tpl→.cv-brand-mark

Le texte et les liens du pied de page main.tplsont modifiés dans la section pied de page.

Les polices sont installées à l'aide de Google Fonts ( main.tpl<head>).

Cache CSS/JS : Vous pouvez désactiver la mise en cache du navigateur en modifiant les paramètres de version styles.css?v=....main.js?v=...

5. Composants de la page d'accueil

main.tplIl apparaît dans les blocs de la page d'accueil [available=main].

5.1 Exemples d'étiquettes personnalisées

{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" » est un espace réservé. Remplacez-le par votre propre plage d'identifiants de catégories de films/séries.

5.2 Visionneuse d'histoires de bandes-annonces

• Cliquer sur les icônes circulaires de la page d'accueil ouvre le lecteur de bande-annonce en plein écran ( main.tpl→ #cv-story-viewer).
• Logique : js/main.js— Lit les URL YouTube/iframe trailerà partir de son champ xfield.
• Cliquer sur les anneaux de la bande-annonce ouvre le lecteur ; le défilement horizontal est pris en charge dans la collection et les bandes populaires.

5.3 Recherche en direct

• La loupe dans l'en-tête ouvre le panneau de recherche.
• Les résultats #qs-resultss'affichent dans l'encadré de résultats, sur toute la largeur du champ de recherche.
• La fenêtre contextuelle étroite de DLE #searchsuggestionsest désactivée par le thème.
• Carte de résultats :fastsearchresult.tpl

6. Détails du film/de la série ( fullstory.tpl)

6.1 Bande supérieure (héros)

• Arrière-plan (le cas échéant), affiche, bouton de bande-annonce, case de notation TMDB
• Liens externes : IMDb, TMDB, TVDB, site officiel, réseaux sociaux
• Séquence de la puce : année → heure → statut → type (comprimé séparé) → limite d’âge
• Tableau des crédits : réalisateur, scénario, acteurs, pays, studio, etc.

6.2 Sous-sections

• Sujet — {full-story}ou overviewchamp x
• Étiquettes{tags} — Style de pilule DLE
• Mots clés / Autres noms — champ croisé à virgule flottante, autopill
• Joueur — videosChamp JSON (ressources à onglets)
• Images de fond — backdropsgalerie
• Contenu similaire —relatednews.tpl
• Commentaires — comments.tpl+addcomments.tpl

6.3 Modal de remorque

Le bouton de bande-annonce situé sous l'affiche , ou le lecteur intégré via jаvascript, permet l'intégration de vidéos YouTube. Ce bouton est masqué si la zone de bande-annonce est vide.

7. Champs supplémentaires utilisés (résumé)

Il figure dans la liste complète xfields.json. Les modèles les plus fréquemment utilisés sont :

8. Liste des cartes

9. Pages d'interface utilisateur

10. Menus et URL

Il est défini de manière permanente dans le menu supérieur main.tpl; sur mobile, le menu hamburger ( #cv-mobile-nav) s'ouvre.

• Page d'accueil →/
• Films → /index.php?do=cat&category=filmler(À modifier selon votre URL SEO)
• Série →/index.php?do=cat&category=diziler
• Nouveautés →/index.php?do=lastnews
• Rechercher → icône d'en-tête ou/index.php?do=search

Liens du pied de page : Contact, Statistiques, Recherche — main.tplpersonnalisables depuis l’intérieur.

Vous pouvez attribuer une icône de catégorie (image) aux cartes de catégorie depuis Admin → Catégories — collection_card.tplil utilise.

11. Intégration de TMDB Movie Manager Pro v3.0

Innovations de la v3.0 (par rapport à la v2.1) : interface d’administration native DLE 20 ; prise en charge des langues turque, anglaise, russe et française dans le panneau d’administration ; compatibilité avec les champs supplémentaires JSON et Legacy ; onglet de transfert de contenu unifié ; découverte de la plateforme ; mise à jour du contenu existant ( bouton Contenu + modifier les actualités) ; panneau d’informations système du tableau de bord .

11.1 Installation

1. tmdb-movie-manager-pro-v3.0.xmlTéléchargez et activez le fichier depuis Admin → Plugins.
2. Admin → Autres sections → Gestion des films TMDB .
3. Paramètres de base → Enregistrez votre clé API TMDB ( themoviedb.org ).
4. Correspondance des champs → xfields.jsonSélectionnez les noms qui correspondent aux noms du thème ou créez des champs TMDB .

11.2 Multilingue (interface d'administration)

Le panneau d'administration du plugin est automatiquement traduit en fonction de la langue de gestion de votre DLE :

• Turc, anglais, russe, français — noms d'onglets, boutons, alertes et tableaux.
• La langue du texte des films/séries sur TMDB est différente : Paramètres avancés → Langue de l’API TMDB (par exemple tr-TR)
• Les visiteurs du site voient le pack de langue de votre thème ; les fichiers de langue du plugin n’affectent que le module d’administration.

11.3 Zones correspondant au thème

1. Lors de l'ajout d'un film ou d'une série, importez-le depuis TMDB via l' onglet Importer du contenu : l'affiche, le décor, le genre, l'équipe et la bande-annonce seront automatiquement renseignés.
2. genreLa zone est formatée par l'extension Aksiyon, Gerilim, ...; le thème la divise en pilule/puce.
3. trailerSi elle est pleine, elle apparaîtra dans les anneaux de la bande-annonce de la page d'accueil.
4. Actualisez le contenu existant à partir de l'onglet Contenu ou en utilisant le bouton TMDB : Mettre à jour les informations sur la page d'édition des actualités .

Guide détaillé du plugin : tmdb-movie-manager-pro-v3.0-dle_kullanim_kilavuzu_editor.html(Peut être collé dans l’éditeur DLE au format HTML).

12. Suggestions d'ajout de contenu

1. Sélectionnez la catégorie appropriée (Film / Série télévisée)
2. Téléchargez l'affiche et, si possible, le fond, ou récupérez-le sur TMDB.
3. Remplissez la bande-annonce ( trailer) — elle apparaîtra dans les anneaux de la page d'accueil.
4. Indiquez l'objet overviewou le texte intégral de l'article.
5. Remplissez le champ JSON pour le lecteur videos(ou intégrez-le dans l'article complet).
6. Ajouter des balises (balises de pilule Fullstory)
7. Séparez le champ type par une virgule ; le thème créera automatiquement une pilule.

13. Paramètres DLE recommandés

14. Compatibilité mobile

• Points de rupture : 900 px , 600 px , 420 px
• En-tête : menu hamburger, tablette utilisateur compacte
• Format principal : une seule colonne, affiche centrée, hauteur réduite.
• Grille de l'image : 2 colonnes sur le téléphone.
• Fullstory : générique sur une seule colonne, affiche centrée, bande-annonce en quasi plein écran.
• Visionneuse d'histoires : feuille plein écran sur mobile
• Formulaires, tableau PM, protection contre le débordement des listes déroulantes.
• Prise en charge de la zone de sécurité (encoche) d'iOS

15. Structure des fichiers du thème

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. Problèmes courants

17. Avant le lancement du site

1. xfields.jsonImporté ; mappage des champs effectué si TMDB est utilisé.
2. main.tplLes identifiants de catégorie et les URL des menus ont été mis à jour conformément au site.
3. Au moins un film et une série télévisée ont été testés avec des affiches, des bandes-annonces et des synopsis complets.
4. Les sections de la page d'accueil (article principal, bande-annonce, articles populaires, commentaires) affichent du contenu.
5. Les versions pour ordinateur et mobile ont été vérifiées.
6. La connexion, l'inscription, la messagerie et les formulaires de contact fonctionnent.
7. La recherche en direct renvoie des résultats.
8. Cache du modèle vidé ; l'icône apparaît.

Cinevault v1.0 · Thème cinéma compatible avec DataLife Engine 19/21.
En cas de problème, commencez par vider le cache du modèle ; vérifiez ensuite l’ID de la catégorie, les champs supplémentaires et les URL du menu.