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

Vues

Généralités

Il y a quatre vues différentes disponibles dans NAPContent pour l'affichage en frontend :

  • Formulaire permet d'afficher un formulaire de saisie, idéal pour créer par exemple des formulaires de contact
  • Item permet d'afficher un article
  • Liste permet quant à elle d'afficher une liste d'items d'une catégorie
  • Liste Catégorie (ou annuaire) permet d'afficher la liste des sous-catégories d'une catégorie

Chacune de ces vues pourra être templaté de manière à avoir le rendu visuel voulu.

Pour afficher une de ces vues sur le site en frontend, il faut créer un lien de menu, choisir le type NAP Content et sélectionner la vue désirée (Exemple ci-dessous).

vues edit01

 

Vue formulaire

La vue formulaire permet d'afficher un formulaire de saisie en frontend. Cela peut être utilisé pour créer un formulaire de contact accessible à tout le monde, ou d'afficher de complexe formulaire pour des adhérents par exemple...
La saisie des formulaires peut être couplée au système de Workflow et au système d'envoi d'E-mail de NAP Content pour de plus grandes possibilités.

 

Configurer les champs

Dans un premier temps il faut régler les droits des champs que l'on va vouloir afficher pour permettre au groupe d'utilisateur Public d'avoir accès l'utilisation de ces champs.
Pour chacun de ces champs il faut mettre le paramètre - Frontend : Accès à ce champ sur Autorisé.

 

Configurer le type

Dans un second temps il faut régler les droits pour le type. Il faut permettre au groupe d'utilisateur Public de soumettre un item de ce type.
Au niveau des droits dans le type vous avez deux paramètres :

  • Frontend : Soumettre des items pour ce type : à mettre sur Autorisé
  • Frontend : Modifier les items de ce type : ce paramètre n'est pas obligatoire, il permet à l'auteur de l'article de pouvoir le modifier une fois qu'il a été soumis

Configurer le template

Ensuite il faut affecter les champs voulus dans le template Formulaire du type. Par défaut à l'installation vous avez un type frontend qui est créé, vous pouvez directement utiliser ce type pour faire votre formulaire. Pour plus de précisions voir Les layouts des formulaires.

 

Configuration du lien de menu

Au niveau du lien de menu il y a deux paramètres obligatoires à configurer qui sont Type et Catégorie principale.

vues formulaire02

Type : doit être le type dont on veut afficher la layout Formulaire.

Catégorie principale : est la catégorie dans laquelle on va sauvegarder les items créés à partir de ces formulaires.

Les autres paramètres que l'on retrouvera dans l'onglet "Paramètres du template" sont facultatifs, ils outrepassent les paramètres saisis dans la layout Formulaire.

vues formulaire03

Template : permet de choisir le template du type, par défaut il est sur "Héritage global", si on le change par exemple pour le passer sur frontend, les autres paramètres en dessous apparaissent.

Autoriser le template via URL : Permet d'autoriser l'utilisateur à charger un template spécifique via l'URL avec le paramètre naptpl. Saisir l'ID du template.

Return URL : permet de définir l'URL de retour après validation du formulaire.

Return Message : permet de définir un message après validation du formulaire. Ce message est ensuite géré par Joomla!.

 

Exemple

Dans l'exemple ci-dessous nous avons décidé de faire un formulaire de soumission d'image, nous avons sélectionné trois champs :

  • le champ Title qui est obligatoire pour toute création d'item, il représentera ici le nom donné à l'image (A noter que le libellé du champ peut être modifié dans la configuration du champ au niveau du template. Par exemple pour un formulaire de contact on pourra modifier le libellé Title en Nom).
  • un champ Image qui permettra de déposer directement une image sur la zone.
  • un champ Tag qui permettra de classifier l'image.

vues formulaire01

Les boutons "Annuler" et "Sauver" peuvent être modifiés directement dans le layout de la vue, par exemple on pourrait dans cet exemple changer la clé langue du bouton "Sauver" pour avoir à la place "Envoyer".

 

Workflow et envoi d'E-mail

Vous pouvez coupler l'envoi de formulaire avec la gestion du workflow et d'Email de NAP Content (voir Workflow / Accès).
Dans le cas par exemple d'un formulaire de contact, on paramétrera l'envoi d'un mail personnalisé à l'administrateur, en envoyant le contenu du formulaire saisi par l'utilisateur.

 

Vue item

La vue Item permet l'affichage d'un article (item) de NAPContent, cet item est composé des différents champs du type qui lui est affecté et qui forment le gabarit de la page.
Ces champs peuvent être classés et ordonnés dans une ou plusieurs positions du template (voir Gestion des Templates).
Ces positions devront être agencées via l'HTML et le CSS pour obtenir le rendu d'item désiré.

Par défaut la vue Item dispose de quatre positions de template : Top, Content, Bottom et Render.
Dans l'exemple ci-dessous, nous avons positionné le champ Title dans la position Top, un champ Image et un champ Textarea dans la position Content, et le champ Tag dans la position Bottom.
La position Render permet de charger des champs dans l'item qui n'ont pas vocation à être visibles, mais qui ont une utilité au niveau du code.

Le rendu des champs peut être paramétré dans l'édition du champ (rendu global) ou dans le template (rendu en fonction du type). Cette façon de fonctionner permet pour chaque type et layouts différents d'avoir une configuration adaptée et donc ne pas avoir à multiplier le même champ pour pouvoir avoir des configurations et rendus visuels différents (Voir Gestion des Templates).

vues item01

Paramètres du lien de menu

Vous trouverez un paramètre au niveau du lien de menu dans l'onglet Paramètres du template :

Template : ce paramètre permet d'overrider le template du type de l'item.

Vue liste

La vue Liste permet d'afficher l'ensemble des items d'une catégorie.

Les champs affichés dans cette vue dépendent du type des items que vous aurez préalablement ajoutés dans les différentes positions de template de la vue Liste.
Il existe actuellement quatre positions prédéfinies pour la vue Liste : Filters, Global, Columns et Render :

  • Filters permet de générer un filtre en fonction d'un champ (celui-ci doit être un champ filtrable), dans l'exemple ci-dessous, on a mis le champ Tag en Filtre. 
  • Global permet de mettre un champ qui sera affiché au niveau de la page mais pas au niveau de chaque item.
  • Columns permet de générer l'ensemble des champs pour chaque item. Dans l'exemple ci-dessous cela se traduit par un tableau, reprenant quatre champs (Title, Image, Field Textarea, Field Tag). Chaque item est représenté par une ligne.
  • Render permet de charger des champs qui n'ont pas vocation à s'afficher sur la page, mais qui ont une utilité au niveau du code.

Des positions de templates peuvent être rajoutée pour modifier le rendu de la vue. Par défaut on a un tableau pour générer le rendu, mais l'HTML du template peut être modifié pour avoir des rendus différents tels que des items sous forme de blocs affichés en colonne par exemple.

Le rendu des champs peut être paramétré dans l'édition du champ (rendu global) ou dans le template (rendu ciblé). Cette façon de fonctionner permet pour chaque type et vue différentes d'avoir une configuration adaptée et donc ne pas avoir à multiplier le même champ pour pouvoir avoir des configurations et rendus différents (Voir Gestion des Templates).

Le nombre d'item affiché dépend du nombre saisi dans le champ "Limite de la liste" de la catégorie (voir Gestion des catégories).
Si le nombre d'item est supérieur à la valeur de ce champ, une pagination apparait.

vues liste01

Paramètres du lien de menu

Vous trouverez les paramètres au niveau du lien de menu dans l'onglet Paramètres du template, modifier les paramètres à cet endroit override les paramètres saisies au niveau de la catégorie.

Inclure les sous-catégories : Ce paramètre permet un choix entre quatre options :

  • Héritage global : le paramètre reprendra la configuration au niveau de la catégorie
  • Premier niveau : le paramètre permet d'avoir les items des catégories de premier niveau seulement
  • Toutes les sous-catégories : le paramètre permet de remonter les items de toutes les sous-catégories de la catégorie sélectionnée peu importe le niveau de profondeur
  • Non : le paramètre n'affichera pas les items issus des sous-catégories de la catégorie sélectionnée

Limite de la liste : Ce paramètre permet de définir le nombre d'articles affichés par page.

Trier par : Ce paramètre permet de modifier l'ordre d'affichage des items. Dans le premier sélecteur on peut choisir la direction : ascendante ou descendante.
Dans le second sélecteur on a un ensemble de choix de tri par exemple : titre, ordre de la catégorie, aléatoire...
Dans le troisième sélecteur on peut choisir de filtrer à l'aide de champs personnalisés, seuls les champs ayant la possibilité de filtrer apparaîtront dans les choix disponibles.

Trier par (niveau 2) : Deuxième possibilité, reprenant les mêmes possibilités que Trier par.

 

Vue annuaire

La vue Liste catégorie ou Annuaire permet d'afficher l'arborescence des sous-catégories d'une catégorie, avec entre paranthèses le nombre d'items affectés à chacune.
Au clic sur un des liens on arrive sur la vue Liste de cette catégorie.

vues annuaire01

Paramètres du lien de menu

Il n'y a actuellement aucun paramètre modifiable au niveau du lien de menu.

×
Ce site utilise des cookies pour vous offrir le meilleur service. En continuant, vous acceptez de recevoir les cookies sur ce site.