Auteur : garstud

Commentaire : 0

Médias :

Vous avez réfléchi aux champs dont vous aviez besoin pour votre projet, en lisant l’épisode 1. Ce nouvel épisode va vous expliquer comment passer à l’action !

Afin de continuer à avancer sur les Champs Personnalisés (CP), voici un article expliquant les bases pour gérer et afficher vos propres Champs Personnalisés.

Administrer ses Champs Personnalisés

Que vous souhaitiez ajouter des CP pour des articles, des contacts ou des utilisateurs, de nouveaux sous-menus sont disponibles dans les écrans d’administration de ces données :

Dans l'écran de gestion des articles, via le menu d'administration "Contenu > Articles", vous trouverez 2 nouveaux sous-menus à gauche :

  • Champs : l’écran de gestion des champs de saisie
  • Groupes de champs : l’écran de gestion des regroupements de champs dans un même bloc.

 

Dans cet article, nous allons vous présenter comment ajouter un champ Texte qui affiche une information concernant l’auteur d’un article.

 

En cliquant sur le sous-menu “Champs”, vous accédez à l’écran de gestion des CP. Vous pouvez alors créer un nouveau CP :

  1. cliquez sur le bouton “Nouveau”,
  2. renseignez un “Titre” pour ce champ,
  3. sélectionnez un Type de champ selon votre besoin : texte, calendrier , liste…,
  4. renseignez un Nom pour ce champ (facultatif, si vide le système le renseignera en utilisant le titre du champ),
  5. renseignez un Label qui sera affiché devant le champ lors de la de saisie,
  6. renseignez une description qui explique ce que doit contenir le champ. Elle apparaîtra en infobulle sur le champ de saisie,
  7. choisissez si le champ de saisie sera obligatoire ou pas en sélectionnant un choix pour le champ “Requis”,
  8. renseignez une “Valeur par défaut” si vous souhaitez que le champ soit pré-rempli,
  9. Pour le champ de type “Texte” de l’exemple ci-dessous, un champ “Filtre” est disponible. Il permet de contraindre la saisie possible (chiffres uniquement, alpha-numérique, brut (aucun contrôle), Safe HTML (HTML autorisé mais sans code suspicieux), …)
  10. renseignez la longueur maximum du nombre de caractères pouvant être saisie.

Attention : certains paramètres peuvent varier selon le type de champ sélectionné. L’exemple ci-dessus et ci-dessous concerne un champ de type “Texte”.

Formulaire d'un nouveau Champ Personnalisé

 Dans la partie de droite, vous pouvez préciser :

  1. l’état du champ : publié, non publié, …,
  2. le groupe du champ (ce paramètre sera expliqué dans l’épisode 4),
  3. la catégorie, pour limiter l’utilisation de ce champ aux articles de certaines catégories,
  4. l’accès, pour limiter l’utilisation de ce champ aux personnes autorisées,
  5. la langue, pour limiter l’utilisation de ce champ à une langue spécifique dans le cadre d’un site multilingue,
  6. une note d’administration pour mémoriser une information concernant ce champ.

 

L’onglet “Paramètres” permet de gérer des informations qui seront expliquées dans l’épisode 3. Seuls les 3 derniers paramètres de cet onglet sont expliqués dans cet épisode :

  • Afficher le label : le label est toujours afficher en administration. Mais est ce que vous souhaitez que le label soit affiché lors du rendu sur le site ?
  • Afficher sur les sites : le champ doit-il être affiché uniquement sur le site public, sur la console d’administration ou sur les 2 ?
  • Affichage automatique : lors du rendu de l’article, l’utilisateur ou le contact, où souhaitez vous afficher le champ parmi les positions pré-définies ? 
    • après le titre : juste en dessous du titre du contenu
    • avant l’affichage : juste avant l’affichage du corps du contenu
    • après l’affichage : en bas, après l’affichage du corps du contenu
    • ne pas afficher automatiquement : aucun affichage, il faudra alors utiliser la substitution du template pour afficher le rendu du champ directement dans le rendu HTML de l’article (cette technique sera détaillée dans le cadre de l’épisode 6).

Paramètres d'un Champ Personnalisé

 Une fois ces éléments renseignés, vous pouvez enregistrer votre champ. Selon si vous avez créé ce champ pour les articles, les contacts ou les utilisateurs, vous pourrez alors créer un nouveau contenu d’un de ces 3 types et profiter de votre nouveau champ.

 

Votre Joomla ne vous propose pas de champs personnalisés ?

Les CP ne sont disponibles que depuis Joomla 3.7. La première vérification consiste à contrôler que votre Joomla est bien à jour.

Ensuite, sachez que par défaut, les sites Joomla 3.7 ou plus, activent les CP par défaut, donc si vous ne les voyez pas, ou si vous souhaitez les masquer, il vous faudra régler les paramètres de votre Joomla.

 

Que vous ayez besoin de personnaliser le contenu des articles, des contacts ou des utilisateurs, vous devez activer (ou désactiver) les Champs Personnalisés dans chacun de ces 3 types de contenu. 

Pour cela, vous devez, pour chaque type de contenu, accéder à ses paramètres via le bouton en haut à droite intitulé “Paramètres” :

Accès aux paramètres des Champs Personnalisés

 

Note : si vous ne voyez pas ce bouton dans les articles, contacts ou utilisateurs, c’est que vous n’avez sans doute pas les droits suffisants pour régler les paramètres de Joomla. Dans ce cas, nous vous invitons à vous rapprocher de votre administrateur pour qu’il le fasse pour vous.

 

Dans ces paramètres, vous trouverez dans l’onglet “Intégration” un choix nommé “Activer les champs personnalisés” : 

Paramètre : activer les champs personnalisés

 

Note : Il y a fort à parier que des extensions proposeront dans un futur proche le support des CP afin de vous permettre de personnaliser vos données, comme pour les articles, contacts et utilisateurs. Nous vous en reparlerons dans un prochain épisode.

Ces extensions proposeront alors aussi le paramètre d’intégration pour activer/désactiver les CP.

 

 L’activation des CP dans les paramètres aura pour effet d’ajouter les 2 sous-menus dédiés aux CP dans l’interface d’administration du type de contenu concerné :

  • Champs : l’écran de gestion des champs de saisie
  • Groupes de champs : l’écran de gestion des regroupements de champs dans un même bloc.

 

Saisie d’un Champ Personnalisé dans un article

Dans notre exemple nous avons créé un champ “Spécialité de l’auteur” qui ne sera disponible que pour les articles de la catégorie “Articles d’auteur” !

 

Note : En créant un article, aucun Champ Personnalisé n’est disponible ! Cela est normal.

Joomla attend que vous renseigniez la catégorie de l’article pour vous afficher uniquement les CP liés à cette catégorie !

 

Une fois la catégorie renseignée, un onglet “Champs” est ajouté à l’écran. Il contient les champs de saisie créés pour cette catégorie.

Les champs s’affichent avec :

  • leur Label à gauche,
  • suivi du champ de saisie,
  • le champ sera pré-renseigné avec la valeur par défaut (si vous en avez renseigné une)
  • si vous avez coché “Requis” à Oui, alors ce champ de saisie sera obligatoire. 

Saisir un Champ Personnalisé dans un article

 En passant la souris sur le Label, une infobulle affichera la description renseignée dans le champ.

Infobulle d'un Champ Personnalisé dans un article

 

Afficher les contenus et leurs champs sur le site

Lors de l’affichage de votre article sur le site, les champs personnalisés apparaîtront dans l’une des 3 positions choisies dans l’onglet “Paramètres” de chaque champ :

  • après le titre : juste en dessous du titre du contenu
  • avant l’affichage : juste avant l’affichage du corps du contenu
  • après l’affichage : en bas, après l’affichage du corps du contenu

Positions d'affichage d'un Champ Personnalisé

 Le positionnement libre du champ est possible en utilisant la surcharge de template de Joomla (cette technique sera détaillée dans le cadre de l’épisode 6).

Une conférence du JoomlaDay Paris des 18-19 mai 2018 vous présentera la surcharge (override) de Layout avec les Champs Personnalisés.

 

Afficher les champs dans le texte de l’article

En plus des 3 positions disponibles, il est possible d’intégrer les champs à l'intérieur du corps de l’article en utilisant le plugin de contenu “field”. Pour se faire, l'éditeur de texte de Joomla propose un bouton “Champ”. Il permet d’afficher une fenêtre Modal listant tous les champs disponibles. Sélectionnez le champ souhaité et une balise "field [ID du champ]" sera intégrée dans le contenu de l'article.

Insérer un Champ Personnalisé dans la description d'un article

 

 Les balises “field [ID du champ]” sont remplacées par leurs valeurs de champs lors de l’affichage sur le site :

Rendu affichage d'un Champ Personnalisé

 Le label devant la valeur du champ est affiché selon les paramètres du champ.

 

Recherche sur le contenu des champs

Par défaut, la recherche est active sur les Champs Personnalisés. Si vous recherchez le terme “joomleur” dans le moteur de recherche du site, vous retrouverez l’article ou le contact ayant cette information (pas les utilisateurs, car ils ne font pas parti du périmètre du moteur de recherche).

Recherche de contenus dans les Champs Personnalisés

 Note : le surlignage n’est pas effectif dans le premier résultat de recherche car le mot recherché a été trouvé dans un CP et pas dans le corps de l’article.

 

Nouvelle Rubrique : Quoi de neuf ce mois-ci en CP Joomla ?

Cet article est terminé, mais au vu des retours positifs des joomleurs sur le premier épisode, nous recevons des réalisations de sites en CP. Nous vous proposons donc d’ajouter une nouvelle rubrique pour présenter au moins 1 site en CP à chaque épisode !

Si vous avez réalisé un site avec des CP, contactez-nous pour paraître dans un prochain épisode !

Ce mois-ci, c’est un site de fiches de randonnées multilingue réalisé par Pascal Conreaux, que nous vous présentons.

Site de randonnées

Ce site pour la promotion de randonnées sur des îles de Norvège est disponible en 3 langues (FR, DE, EN).

Chaque fiche de randonnée est construite avec des CP :

https://www.rando-lofoten.net/fr/randonnees-lofoten

  • durée,
  • distance,
  • ile sélectionnée,
  • visibilité sentier,
  • difficulté,
  • type de parcours,
  • … etc

Certaines informations sont représentées par des pictogrammes.

Recherche multi-critères sur les Champs Personnalisés du site rando-lofoten.net

 La particularité de ce site est l’utilisation du moteur de recherche multi-critères "JA Megafilter". Cette extension (payante), déjà connue pour être compatible avec d'autres extensions de contenu (HikaShop, Virtuemart, K2 ...), est désormais compatible avec les Champs Personnalisés (Custom Fields). 

Elle permet d’enrichir la recherche sur les contenus en ajoutant des filtres de recherche sur les Champs Personnalisés de vos contenus. C’est tout a fait le genre d’extension qui va valoriser l’utilisation des Champs Personnalisés sur des sites avancés (agences immobilières, catalogues produits, bases de connaissance, …).

 

Pour afficher le détail d’une fiche de randonnée, une surcharge de la vue article a été effectuée pour obtenir le rendu suivant :

Fiche détaillée d'un article avec Champs Personnalisés du site rando-lofoten.net

 Les techniques de surcharge pour les Champs Personnalisés seront présentées dans un prochain épisode, ainsi que lors du JoomlaDay de Paris des 18-19 mai.

 

Pascal donne quelques astuces et explique plus en détail la mise en place des Champs Personnalisés pour ce projet, sur son Blog Pro.

 

 

Et après ?

Voilà pour ce deuxième épisode. Il vous donne les bases pour commencer à utiliser les CP, en attendant le prochain épisode sur “CP Episode 3 : Paramètres de configuration des Champs Personnalisés” qui vous donnera des explications pratiques sur le paramétrage des CP.

Viendront ensuite, dans les prochains mois, d'ici l'été : 

  • CP Episode 4 : Utiliser les groupes de Champs Personnalisés
  • CP Episode 5 : Astuces pour les Champs Personnalisés
  • CP Episode 6 : Surcharge de template pour les Champs Personnalisés
  • CP Episode 7 : Aller plus loin avec les Champs Personnalisés

Si vous souhaitez participer à la rédaction partielle ou complète d'un de ces articles, contactez l'AFUJ.

 

Médias

 

Image(s)

  • 01-nouveau_champ.png
  • 02-parametres.png
  • 03-CP-integration.png
  • 04-CP-integration.png
  • 05-CP-mon_article.png
  • 06-CP-mon_article.png
  • 07-CP-positions.png
  • 08-CP-inserer.png
  • 09-CP-Rendu-position.png
  • 10-CP-recherche.png
  • Rando Lofoten
    ©Rando Lofoten
  • Rando Lofoten
    ©Rando Lofoten
 
Laisser un commentaire

La soumission de commentaires est réservée aux adhérents de l'AFUJ. Merci de vous connecter pour soumettre un commentaire.

Connexion

Ce site utilise des cookies pour vous offrir le meilleur service.

En poursuivant votre navigation, vous acceptez l’utilisation de cookies sur ce site. En savoir plus

J'ai compris