NAPC Demo  

Essayez gratuitement NAPContent sur notre site demo !

Devenez membre

 et bénéficiez de toutes nos solutions!

Devenez membre

Découvrez les sites

qui utilisent NAPContent !

Voir
plus

Templates

Définition

Les templates représentent les fichiers qui vont être utilisés pour effectuer l'affichage des données des différents contenus.

Dans NAPContent il existe 5 types de template différents :

  • Affichage d'un seul contenu :
    • Item : Affiche les données d'un seul contenu
    • Formulaire : Permet de créer ou modifier les données d'un type de contenu en backend comme en frontend.
  • Affichage d'une liste de contenus :
    • Liste : Affiche une liste de contenus selon une catégorie et des filtres déterminés
    • Module : Affiche une liste de contenus dans un module du site selon les paramètres définis
    • Liste Admin : Utilisable uniquement dans l'administration. Permet d'afficher une liste de contenus selon un type prédéterminé

Le répertoire des fichiers des templates par défaut est situé dans /components/com_napc/templates

Gestion des templates

Accès à la gestion des templates

Allez dans l'administration de NAPContent, puis sélectionnez dans le menu la rubrique "Templates". Vous accédez alors à la liste des templates existants.

Lors de l'installation deux templates par défaut sont créés :

  • default : Utiliser pour l'ensemble des vues par défaut.
  • frontend : Utiliser pour la soumission d'item en frontend

Ajouter / Modifier un template

Cliquez sur le titre du template pour le modifier, ou bien cliquez sur le bouton Nouveau pour créer un nouveau template. (le template defaut ne peut pas être modifier ou supprimer)template edit 01  

Un template est composé des informations suivantes :

Nom : Nom qui permet d'identifier le template. Tout type de caractère peux être utilisé.

Chemin du template : C'est ici que vous sélectionner le répertoire qui contient les fichiers de template à utiliser. La liste contiendra tous les répertoires incluent dans /components/com_napc/templates et /templates/template_par_defaut/html/com_napc/templates. Dans le cas où il y aurait un répertoire identique dans les deux sources c'est le chemin du template (et pas celui du composant) qui sera exploité.

 Il est possible d'utiliser plusieurs fois le même chemin de template pour des templates différents. Cela permet par exemple de charger des champs différents ou bien de définir des paramètres différents, tout en gardant une seule source de template.

Suppression d'un template

Une fois que vous êtes dans la liste des templates, sélectionner via la case à cocher le type à supprimer puis cliquez sur le bouton supprimer. Attention il n'y a pas de gestion de corbeille, une fois que celui-ci est supprimé il n'est pas possible de revenir en arrière. 

Le fait de supprimer une template ne supprime pas les fichiers du répertoire auquel il est associé. Les fichiers ne peuvent être supprimés que manuellement par l'hébergeur. 

Associer des champs à un template

Introduction

Chaque template est représenté par un ensemble de positions et des paramètres.

Une position de template est une zone (qui peut être définie via le fichier xml de configuration du template) qui peut être associée à une liste de champ à afficher.

Il est impératif afin d'exploiter le champ que ce dernier soit dans une position de template sinon les données associées à ce champ ne seront pas chargées. Il est donc courant d'utiliser une position technique nommée "render" permettant de charger un champ manuellement.

Association d'un champ à une position de template

Allez dans l'administration de NAPContent, puis sélectionnez dans le menu la rubrique "Templates". Vous accédez alors à la liste des templates existants.

Vous pourrez constater que les templates n'ont pas toujours un rendu possible pour l'ensemble des types d'affichage, cela dépend de la configuration du template. Seul l'intégrateur peut ajouter ou supprimer ce paramétrage en mettant les bons fichiers à disposition.

template edit 02

Afin d'associer un champ à une position pour affichage donnée, repérer tout d'abord la ligne du template que vous souhaitez modifier, puis cliquer sur l'icône de modification dans la colonne correspondante. Par exemple, cliquez sur la ligne du template "Default" dans la colonne "Affichage Item" et vous obtiendrez la page suivante :

template edit 03

 Les informations du template apparaissent en haut à droite.

Juste en dessous apparaissent d'éventuels paramètres. Les paramètres techniques et standard qui peuvent être utilisés sont les suivants !

Autoriser le template via url : Permet de surcharger la sélection d'un template via le paramètre d'url "naptpl". Il faut indiquer l'ID du template. Si l'autorisation n'est pas levée (ou le paramètre non défini)  alors le template ne pourra pas être utilisé via le paramètre d'url.

Return URL : Ce paramètre n'est utilisé que pour la saisie de contenu en frontend. Il permet de définir sur quel page l'utilisateur doit être redirigé à la fin de sa saisie.

Return Message : Ce paramètre n'est utilisé que pour la saisie de contenu en frontend. Il permet d'afficher un message à l'utilisateur à la fin de sa saisie.

Les autres paramètres dépendent de la structure du template mis en place par l'intégrateur. 

Dans la partie de droite est affichée l'ensemble des positions associés à un template. Pour chaque position il est possible d'associer aucun ou plusieurs champs.

Pour associer un nouveau champ il faut cliquer sur le bouton d'ajout situé à droite de la position. Une popup apparait et vous permet de chercher et associer votre champ à la position, il suffit de cliquer sur le titre du champ.

template edit 04

Une fois que vous avez cliqué le nom du champ de vient rouge et est barré. Cela vous indique que le champ a déjà été ajouté dans une position du template en cours d'édition. Il est toutefois possible (en dehors des affichages de type formulaire), d'associer plusieurs fois un même champ (par exemple pour en faire des rendus différents).

Une fois que vous avez terminé d'associer vos champs à la position en cours, vous pouvez fermer la fenêtre de sélection et vous constaterez que l'ensemble de vos champs apparaissent dans la position. 

Vous pouvez ensuite déplacer vos champs par des glisser / déposer, en laissant appuyer sur le libellé,afin de les ordonner dans la position (cela sera repris pour l'ordre d'affichage) ou bien les changer de position.

Pour retirer un champ d'une position cliquer sur l'icône de la corbeille associé au champ en question.

L'icône verte de modification associée au champ permet d'outrepasser les paramètres d'affichage du champ ainsi que de gérer les traductions spécifiques. Par défaut, ceux seront les paramètres définis dans la configuration du champ qui seront utilisés.

Remarque : L'ajout ou la suppression d'un champ dans un position prend effet immédiatement. Le bouton enregistrer ne permet que de sauvegarder les paramètres ainsi que l'ordre des champs.  

Il existe également deux types de position technique :

  • Filters : Permet d'ajouter des filtres dans une vue liste (frontend ou backend)
  • Global : Permet d'ajouter un champ qui n'est pas directement associé à un item mais plutôt à une catégorie. Cette position est utilisée par exemple pour le champ de partage sur les réseaux sociaux (socialshare) ou bien encore le champ d'abonnement (subscribe) à une catégorie.
×
Ce site utilise des cookies pour vous offrir le meilleur service. En continuant, vous acceptez de recevoir les cookies sur ce site.