Créer des modèles de fragment de contenu

Ce chapitre décrit les étapes à suivre pour créer cinq modèles de fragment de contenu :

  • Informations de contact
  • Adresse
  • Personne
  • Emplacement
  • Équipe

Les modèles de fragment de contenu permettent de définir des relations entre les types de contenu et de conserver des relations telles que des schémas. Utilisez les références aux fragments imbriqués, divers types de données de contenu et le type d’onglet pour l’organisation du contenu visuel. Types de données plus avancés tels que les espaces réservés d’onglets, les références aux fragments, les objets JSON et le type de données de date et heure.

Ce chapitre traite également de l’amélioration des règles de validation pour les références de contenu telles que les images.

Prérequis

Il s’agit d’un tutoriel avancé. Avant de poursuivre ce chapitre, assurez-vous d’avoir terminé la configuration rapide. Assurez-vous d’avoir également lu le chapitre d’aperçu précédent pour plus d’informations sur la configuration du tutoriel avancé.

Objectifs

  • Créer des modèles de fragment de contenu.
  • Ajoutez des espaces réservés d’onglet, la date et l’heure, des objets JSON, des références à des fragments et des références de contenu aux modèles.
  • Ajoutez la validation aux références de contenu.

Présentation du modèle de fragment de contenu

La vidéo suivante présente brièvement les modèles de fragment de contenu et leur utilisation dans ce tutoriel.

Créer des modèles de fragment de contenu

Créons des modèles de fragment de contenu pour l’application WKND. Si vous avez besoin d’une introduction de base à la création de modèles de fragment de contenu, reportez-vous au chapitre approprié dans la section tutoriel de base.

  1. Accédez à Outils > Ressources > Modèles de fragment de contenu.

    Chemin d’accès aux modèles de fragment de contenu

  2. Sélectionner Site WKND pour afficher la liste des modèles de fragment de contenu existants pour le site.

Modèle Contact Info

Créez ensuite un modèle contenant les coordonnées d’une personne ou d’un emplacement.

  1. Sélectionner Créer dans le coin supérieur droit.

  2. Attribuez au modèle le titre "Contact Info", puis sélectionnez Créer. Dans le modal de succès qui s’affiche, sélectionnez Ouvrir pour modifier le modèle nouvellement créé.

  3. Commencez par faire glisser un Texte sur une seule ligne sur le modèle. Donnez-lui Libellé du champ de "Phone" dans la variable Propriétés . Le nom de la propriété est automatiquement renseigné sous la forme phone. Cochez la case pour que le champ soit Obligatoire.

  4. Accédez au Types de données , puis ajoutez un autre Texte sur une seule ligne sous le champ "Téléphone". Donnez-lui Libellé du champ de "Email" et définissez-le également sur Obligatoire.

Adobe Experience Manager est fourni avec certaines méthodes de validation intégrées. Ces méthodes de validation vous permettent d’ajouter des règles de gouvernance à des champs spécifiques de vos modèles de fragment de contenu. Dans ce cas, ajoutons une règle de validation afin de nous assurer que les utilisateurs ne peuvent saisir que des adresses électroniques valides lorsqu’ils remplissent ce champ. Sous , Type de validation menu déroulant, sélectionnez Courrier électronique.

Votre modèle de fragment de contenu complété doit ressembler à ceci :

Chemin du modèle Contact Info

Une fois l’opération terminée, sélectionnez Enregistrer pour confirmer vos modifications et fermer l’éditeur de modèle de fragment de contenu.

Modèle d’adresse

Créez ensuite un modèle pour une adresse.

  1. Dans la Site WKND, sélectionnez Créer dans le coin supérieur droit.

  2. Saisissez le titre "Adresse", puis sélectionnez Créer.

    i. Dans le modal de succès qui s’affiche, sélectionnez Ouvrir pour modifier le modèle nouvellement créé.

  3. Faites glisser et déposez un Texte sur une seule ligne sur le modèle et lui donnez un Libellé du champ de "Adresse de la rue". Le nom de la propriété est ensuite renseigné en tant que streetAddress. Sélectionnez la Obligatoire .

  4. Répétez les étapes ci-dessus et ajoutez quatre champs "Une seule ligne de texte" supplémentaires au modèle. Utilisez les libellés suivants :

    • Ville
    • État
    • Code postal
    • Pays
  5. Sélectionner Enregistrer pour enregistrer les modifications apportées au modèle Address.

    Le modèle de fragment "Adresse" complété doit ressembler à ceci :
    Modèle d’adresse

Modèle Personne

Créez ensuite un modèle contenant des informations sur une personne.

  1. Dans le coin supérieur droit, sélectionnez Créer.

  2. Donnez au modèle le titre "Personne", puis sélectionnez Créer. Dans le modal de succès qui s’affiche, sélectionnez Ouvrir pour modifier le modèle nouvellement créé.

  3. Commencez par faire glisser un Texte sur une seule ligne sur le modèle. Donnez-lui Libellé du champ de "Nom complet". Le nom de la propriété est automatiquement renseigné sous la forme fullName. Cochez la case pour que le champ soit Obligatoire.

    Options de nom complet

  4. Les modèles de fragment de contenu peuvent être référencés dans d’autres modèles. Accédez au Types de données puis effectuez un glisser-déposer de l’élément Référence de fragment et donnez-lui le libellé "Contact Info".

  5. Dans le Propriétés sous l’onglet Modèles de fragment de contenu autorisés , sélectionnez l’icône de dossier, puis choisissez l’option Coordonnées modèle de fragment créé précédemment.

  6. Ajouter un Référence de contenu et lui donner un Libellé du champ de "Profile Picture". Sélectionnez l’icône de dossier sous Chemin racine pour ouvrir le modal de sélection de chemin. Sélectionnez un chemin racine en sélectionnant content > Ressources, puis en cochant la case pour Site WKND. Utilisez la variable Sélectionner en haut à droite pour enregistrer le chemin d’accès. Le chemin de texte final doit être lu /content/dam/wknd.

    Chemin racine de référence de contenu

  7. Sous Accepter uniquement les types de contenu spécifiés, sélectionnez "Image".

    Options d’image de profil

  8. Pour limiter la taille et les dimensions du fichier image, examinons certaines options de validation pour le champ de référence du contenu.

    Sous Accepter uniquement la taille de fichier spécifiée, sélectionnez "Inférieur ou égal à", et des champs supplémentaires apparaissent ci-dessous.
    Accepter uniquement la taille de fichier spécifiée

  9. Pour Max, saisissez "5" et pour Sélectionner une unité, sélectionnez "Mégaoctets (Mo)". Cette validation permet uniquement de sélectionner les images de la taille spécifiée.

  10. Sous Accepter uniquement la largeur d’image spécifiée, sélectionnez "Largeur maximale". Dans le Max (pixels) qui s’affiche, saisissez "500". Sélectionnez les mêmes options pour Accepter uniquement une hauteur d’image spécifiée.

    Ces validations garantissent que les images ajoutées ne dépassent pas les valeurs spécifiées. Les règles de validation doivent maintenant se présenter comme suit :
    Règles de validation de référence du contenu

  11. Ajouter un Texte multi-lignes et lui donner un Libellé du champ de "Biographie". Laissez le champ Type par défaut comme option par défaut "Texte enrichi".

    Options de biographie

  12. Accédez au Types de données puis faites glisser un Énumération champ sous "Profile Picture". Au lieu de la valeur par défaut Render As option, sélectionnez Liste déroulante. Saisissez une sélection d’options de niveau d’expérience de l’instructeur, telles que Expert, Avancé, Intermédiaire.

  13. Faites ensuite glisser un autre Énumération sous "Niveau d’expérience de l’instructeur" et cochez les "cases" sous Render As . Entrer dans des domaines tels que l'escalade, le surf, le cyclisme, le ski et le randonnée. Le libellé de l’option et la valeur de l’option doivent correspondre comme ci-dessous :

    Enumération des compétences

  14. Enfin, créez un libellé de champ "Détails de l’administrateur" à l’aide d’un Texte multi-lignes champ .

Sélectionner Enregistrer pour confirmer vos modifications et fermer l’éditeur de modèle de fragment de contenu.

Modèle d’emplacement

Le modèle de fragment de contenu suivant décrit un emplacement physique. Ce modèle utilise des espaces réservés d’onglet. Les espaces réservés d’onglets permettent d’organiser les types de données dans l’éditeur de modèles et le contenu dans l’éditeur de fragments, respectivement, en catégorisant le contenu. Chaque espace réservé crée un onglet, semblable à un onglet dans un navigateur Internet, dans l’éditeur de fragments de contenu. Le modèle Emplacement doit comporter deux onglets : Détails de l’emplacement et adresse de l’emplacement.

  1. Comme précédemment, sélectionnez Créer pour créer un autre modèle de fragment de contenu. Pour le titre du modèle, saisissez "Emplacement". Sélectionner Créer suivie de Ouvrir dans le modal success qui s’affiche.

  2. Ajouter un Espace réservé de tabulation sur le modèle et étiquetez-le "Détails de l’emplacement".

  3. Faites glisser et déposez un Une seule ligne de texte et étiquetez-le "Nom". Sous ce libellé de champ, ajoutez une texte multiligne et étiquetez-le "Description".

  4. Ajoutez ensuite une Référence de fragment et étiquetez-le "Contact Info". Dans l’onglet Propriétés, sous Modèles de fragment de contenu autorisés, sélectionnez la variable Icône Dossier et sélectionnez le modèle de fragment "Contact Info" créé précédemment.

  5. Ajouter un Référence de contenu sous "Contact Info". Nommez-le "Image de l’emplacement". Le Chemin racine should /content/dam/wknd. Sous Accepter uniquement les types de contenu spécifiés, sélectionnez "Image".

  6. Ajoutons également un Objet JSON sous "Image de l’emplacement". Ce type de données étant flexible, il peut être utilisé pour afficher toutes les données que vous souhaitez inclure dans votre contenu. Dans ce cas, l’objet JSON est utilisé pour afficher des informations sur la météo. Étiqueter l’objet JSON "Météo par saison". Dans le Propriétés , ajoutez une Description il est donc clair pour l'utilisateur quelles données doivent être entrées ici : "Données JSON concernant la météo de l’emplacement de l’événement par saison (printemps, été, automne, hiver)."

    Options d’objet JSON

  7. Pour créer l’onglet Adresse de l’emplacement, ajoutez une Espace réservé de tabulation sur le modèle et étiquetez-le "Adresse de l’emplacement".

  8. Faites glisser et déposez un Référence de fragment et dans l’onglet propriétés, sous Modèles de fragment de contenu autorisés, sélectionnez la variable Adresse modèle.

  9. Sélectionner Enregistrer pour confirmer vos modifications et fermer l’éditeur de modèle de fragment de contenu. Le modèle d’emplacement complété doit apparaître comme suit :

    Options de référence du contenu

Modèle d’équipe

Enfin, créez un modèle qui décrit une équipe de personnes.

  1. Dans la Site WKND page, sélectionnez Créer pour créer un autre modèle de fragment de contenu. Pour le titre du modèle, saisissez "Équipe". Comme précédemment, sélectionnez Créer suivie de Ouvrir dans le modal success qui s’affiche.

  2. Ajouter un Texte multi-lignes au formulaire. Sous Libellé du champ, saisissez "Description".

  3. Ajouter un Date et heure sur le modèle et étiquetez-le "Date de création de l’équipe". Dans ce cas, conservez la valeur par défaut Type sur "Date", mais notez qu’il est également possible d’utiliser "Date et heure" ou "Heure".

    Options de date et d’heure

  4. Accédez au Types de données . Sous "Date de création de l’équipe", ajoutez une Référence de fragment. Dans le Render As , sélectionnez "multifield". Pour Libellé du champ, saisissez "Membres de l’équipe". Ce champ est lié au modèle Personne créé précédemment. Le type de données étant un champ multiple, plusieurs fragments de personne peuvent être ajoutés, ce qui permet de créer une équipe de personnes.

    Options de référence des fragments

  5. Sous Modèles de fragment de contenu autorisés, utilisez l’icône de dossier pour ouvrir le modal Sélectionner le chemin , puis sélectionnez l’option Personne modèle. Utilisez la variable Sélectionner pour enregistrer le chemin.

    Sélectionner le modèle Personne

  6. Sélectionner Enregistrer pour confirmer vos modifications et fermer l’éditeur de modèle de fragment de contenu.

Ajouter des références de fragments au modèle d’aventure

Tout comme le modèle Équipe comporte une référence de fragment au modèle Personne, les modèles Équipe et Emplacement doivent être référencés à partir du modèle Adventure pour afficher ces nouveaux modèles dans l’application WKND.

  1. Dans la Site WKND , sélectionnez Adventure modèle, puis sélectionnez Modifier dans la barre de navigation supérieure.

    Chemin de modification aventure

  2. Au bas du formulaire, sous "Que nous amener", ajoutez une Référence de fragment champ . Saisissez un Libellé du champ de "Emplacement". Sous Modèles de fragment de contenu autorisés, sélectionnez la variable Emplacement modèle.

    Options de référence des fragments d’emplacement

  3. Ajouter un Référence de fragment et étiquetez-le "Équipe instructrice". Sous Modèles de fragment de contenu autorisés, sélectionnez la variable Équipe modèle.

    Options de référence des fragments d’équipe

  4. Ajouter un autre Référence de fragment et étiquetez-le "Administrateur".

    Options de référence des fragments d’administrateur

  5. Sélectionner Enregistrer pour confirmer vos modifications et fermer l’éditeur de modèle de fragment de contenu.

Bonnes pratiques

Il existe quelques bonnes pratiques relatives à la création de modèles de fragment de contenu :

  • Créez des modèles qui mappent les composants UX. Par exemple, l’application WKND dispose de modèles de fragment de contenu pour les aventures, les articles et l’emplacement. Vous pouvez également ajouter des en-têtes, des promotions ou des clauses de non-responsabilité. Chacun de ces exemples constitue un composant UX spécifique.

  • Créez autant de modèles que possible. Limiter le nombre de modèles permet d’optimiser la réutilisation et de simplifier la gestion du contenu.

  • Imbriquez les modèles de fragment de contenu aussi profondément que nécessaire, mais uniquement si nécessaire. Rappelez-vous que l’imbrication s’effectue avec des références de fragment ou de contenu. Envisagez un maximum de cinq niveaux d’imbrication.

Félicitations !

Félicitations ! Vous avez maintenant ajouté des onglets, utilisé les types de données d’objet Date et Heure et JSON, et en savoir plus sur les fragments et les références de contenu. Vous avez également ajouté des règles de validation de référence de contenu.

Étapes suivantes

Le chapitre suivant de cette série couvre : création de fragments de contenu des modèles que vous avez créés dans ce chapitre. Découvrez comment utiliser les types de données introduits dans ce chapitre et créer des stratégies de dossier pour limiter les modèles de fragment de contenu pouvant être créés dans un dossier de ressources.

Bien qu’il soit facultatif pour ce tutoriel, veillez à publier tout le contenu dans des situations de production réelles. Pour une révision des environnements de création et de publication dans AEM, reportez-vous à la section
Série vidéo AEM sans affichage et GraphQL.

Sur cette page