Introduction

Les attributs sont une entité qui permet de configurer la structure de votre application. Ils vous offrent une flexibilité maximale et vous évitent le code en dur.

Un ensemble d'attributs ressemble à une collection de propriétés dont vous gérez les valeurs depuis le panneau d'administration. Les ensembles diffèrent par le type de liaison aux entités. Pour en savoir plus sur les types, consultez la section "Types". (s'ouvre dans un nouvel onglet)

Un ensemble d'attributs définit une structure de données que vous pouvez ensuite utiliser dans votre projet. Par exemple, vous pouvez définir que la structure d'un produit contient un nom, une image, un prix et une description textuelle. La structure d'un article de blog, elle, peut contenir un texte avec titre et un ensemble d'images.

Certains attributs ont une structure similaire et servent dans plusieurs entités : vous pouvez donc réutiliser un même ensemble d'attributs pour différentes entités.

Structure

Chaque ensemble d'attributs contient une collection configurable d'attributs qui stockent le contenu de votre projet. Vous gérez ces attributs depuis le système de gestion. Vous n'avez donc plus besoin de modifier le code de l'application pour faire évoluer votre projet. Placez dans des attributs tous les éléments de contenu susceptibles de changer.

Marqueurs

Un marqueur ne peut pas contenir d'espaces ni commencer par un chiffre. Si vous saisissez une valeur incorrecte dans le champ du marqueur, le système ignore la saisie.

Nom

Pour vous repérer plus facilement, chaque attribut a un nom obligatoire, une chaîne qui n'a pas besoin d'être unique. Choisissez des noms qui vous facilitent le travail.

Marqueur

Chaque attribut a un identifiant obligatoire, le marqueur, qui est une chaîne unique. Le marqueur sert aussi de clé pour accéder aux attributs dans le code de votre projet. Tenez-en compte lorsque vous choisissez le marqueur d'un attribut, afin d'éviter les conflits de syntaxe.

Type de données

Choisissez le type de données que chaque champ d'attribut va stocker.

Les types de données disponibles sont les suivants :

• Chaîne (String) : texte simple, par exemple « Bonjour, le monde ! ».
• Texte (Text) : texte plus long, souvent mis en forme, par exemple un article ou une lettre.
• Texte avec titre (Text with header) : texte accompagné d'un titre, qui peut indiquer un sujet ou une catégorie.
• Entier (Integer) : nombre entier, par exemple 5, 100, -2.
• Nombre réel (Real) : comme Float, mais avec une précision plus élevée.
• Nombre à virgule flottante (Float) : nombre à virgule flottante pouvant avoir une partie décimale, par exemple 3.14, 1.5, -0.25.
• Date et heure (Date and Time) : combinaison d'une date et d'une heure, par exemple 2023-10-27 10:00:00.
• Date (Date) : date, par exemple 2023-10-27.
• Heure (Time) : heure, par exemple 10:00:00.
• Fichier (File) : n'importe quel fichier de votre ordinateur, par exemple un document, une image ou de la musique.
• Image (Image) : image, par exemple une photo ou un dessin.
• Groupe d'images (Group of Images) : collection d'images, par exemple un album photo.
• Bouton radio (Radio Button) : bouton de sélection qui ne permet de choisir qu'une seule option.
• Liste (List) : liste d'éléments, par exemple une liste de tailles de produits.
• Protection contre le spam (Spam Protection) : captcha qui protège le formulaire contre les envois automatiques.
• Bouton (Button) : bouton avec une valeur définie.
• Entité (Entity) : entité représentant un objet du monde réel, par exemple une personne, un lieu ou une organisation.
• Intervalle de temps (Time interval) : calendrier pour créer, planifier et gérer des intervalles de temps.
• JSON : stocke des données au format JSON.

Pour en savoir plus sur chaque type, consultez la section "Types". (s'ouvre dans un nouvel onglet)

L'interface de saisie du contenu dépend du type de données choisi pour chaque champ d'attribut.

Ensemble d'attributs système

Vous pouvez créer un ensemble d'attributs système distinct. Il n'est associé à aucune collection et permet de stocker des données arbitraires. Pour remplir l'ensemble d'attributs système, ouvrez la page d'édition de l'ensemble.

Fonctionnalités

Vous pouvez ajouter des validateurs aux attributs. Ce mécanisme est décrit en détail dans la section "Validators". (s'ouvre dans un nouvel onglet)

Attributs

Si un même ensemble d'attributs est utilisé par plusieurs entités, modifiez ses attributs avec précaution. Si vous supprimez un attribut, il est supprimé, avec son contenu, partout où il est utilisé. Si vous ajoutez un attribut à l'ensemble, il est ajouté partout où cet ensemble d'attributs est utilisé.