Ce qu’est un attribut d’annonce

Un attribut d’annonce est un champ que vous ajoutez au formulaire d’annonce, en plus du titre, du prix et de la description : une marque, un état, une couleur, une date de fabrication… Chaque attribut est lié à une ou plusieurs catégories d’annonce, et le formulaire présente au vendeur les attributs de la catégorie qu’il a choisie.

La valeur saisie peut ensuite s’afficher sur la fiche annonce, servir de filtre de recherche et être utilisée par votre thème. Deux réglages de l’attribut en décident, présentés plus bas : Visibilité et Lecture seule.

Créer un attribut

  1. Dans le menu, rubrique Configuration, cliquez sur Paramètres, puis sur Catalogue, dans le groupe Ventes & catalogue.
  2. En haut de l’écran Paramètres généraux des annonces, cliquez sur Attributs d’annonce.
  3. Cliquez sur Ajouter un attribut.
  4. Remplissez la fiche, décrite ci-dessous, puis cliquez sur Enregistrer.

La liste des attributs indique l’Alias de chacun : c’est le nom qui sert dans le thème et dans les fichiers d’import. Faites glisser une ligne pour changer l’ordre des attributs dans le formulaire et sur la fiche annonce.

Les champs de la fiche

  • Titre : le nom du champ, affiché au vendeur et sur la fiche annonce.
  • Message d’aide à afficher dans une info-bulle : le texte de l’infobulle placée à côté du champ, dans le formulaire d’annonce. Vide, aucune infobulle.
  • Type : la forme du champ.
  • Champs obligatoires : Oui oblige le vendeur à remplir le champ pour publier son annonce.
  • Visibilité et Lecture seule : décrits plus bas, dans « Qui remplit, où la valeur s’affiche ».
  • Appliquer à toutes les catégories : Oui lie l’attribut à toutes les catégories, y compris celles créées plus tard. Non affiche la liste des catégories, où vous cochez celles qui le reçoivent.

Les types

Type Ce que saisit le vendeur
Texte court Une ligne de texte. Le champ Motif peut imposer un format, sous forme d’expression régulière.
Texte long Plusieurs lignes de texte.
Oui/Non Un choix entre Oui et Non. Le champ Valeur par Défaut fixe la réponse proposée.
Nombre Un nombre.
Liste déroulante Une option, parmi celles que vous définissez.
Case à cocher Une ou plusieurs options, parmi celles que vous définissez.
Date Une date.
Lien Une adresse web complète, affichée en lien cliquable.
Prix Un montant.
JSON Une donnée structurée, destinée au thème.

Pour une Liste déroulante ou une Case à cocher, saisissez les options une par une : Ajouter une option en ajoute une ligne. Deux réglages propres à ces types :

  • Utiliser dans les filtres de recherche : Oui propose l’attribut comme filtre dans les résultats de recherche (voir Filtrer et rechercher à l’aide d’attributs d’annonce).
  • Afficher les attributs non sélectionnés : Oui affiche sur la fiche annonce toutes les options, et pas seulement celles choisies par le vendeur ; chaque option porte une classe CSS qui permet au thème de distinguer les deux.

Qui remplit, où la valeur s’affiche

Deux réglages indépendants :

  • Lecture seule décide qui remplit le champ : le vendeur, ou seulement l’administrateur.
  • Visibilité décide où la valeur s’affiche : dans la liste d’attributs de la fiche annonce, dans le thème seul, ou dans l’espace d’administration seul.

Visibilité : où la valeur s’affiche

  • Tout le monde : la valeur s’affiche dans la liste d’attributs de la fiche annonce. Elle est aussi transmise au thème et peut servir de filtre de recherche.
  • Thème uniquement : la valeur est transmise au thème et à la recherche, et peut servir de filtre, mais elle est absente de la liste d’attributs automatique de la fiche annonce. C’est le réglage d’une valeur que le thème affiche à sa façon : un badge, une pastille, une mention dans un bandeau.
  • Seulement visible par l’admin : la valeur reste dans l’espace d’administration. Elle n’est transmise ni au thème ni à la recherche, et l’attribut est absent du formulaire du vendeur.

Dans le thème, la valeur d’un attribut se lit avec listing.attributes. suivi de son alias, par exemple listing.attributes.annonce_verifiee. Le détail est sur le hub développeurs, en anglais.

Lecture seule : qui remplit le champ

  • Non : le vendeur remplit le champ dans son formulaire d’annonce.
  • Oui : seul l’administrateur remplit le champ. Le formulaire du vendeur ne le présente pas, et la plateforme écarte toute valeur qu’un vendeur enverrait pour cet attribut. Pour le remplir : dans le menu, rubrique Catalogue & clients, cliquez sur Catalogue, ouvrez l’annonce et remplissez le champ dans la carte Attributs.

Une valeur en lecture seule s’affiche ensuite selon la Visibilité de l’attribut, comme les autres.

Combiner les deux

Besoin Visibilité Lecture seule
Une caractéristique saisie par le vendeur et affichée sur l’annonce : une marque, un état Tout le monde Non
Un badge « Annonce vérifiée » posé par votre équipe et affiché par le thème Thème uniquement Oui
Une valeur saisie par le vendeur que le thème met en forme : une pastille de couleur Thème uniquement Non
Une note interne de votre équipe sur l’annonce Seulement visible par l’admin Oui ou Non : le vendeur ne voit pas le champ

Importer et exporter des attributs

Sur la liste des attributs, Exporter télécharge un fichier CSV, une ligne par attribut, et Importer charge un fichier au même format (.csv, .xls, .xlsx ou .ods). Une ligne dont l’alias existe déjà met à jour l’attribut ; une ligne avec un nouvel alias crée un attribut.

La colonne visibility (ou visibilite) accepte trois valeurs, en anglais ou en français :

Visibilité à l’écran Valeur du fichier
Tout le monde Everyone ou Tout le monde
Thème uniquement Theme only ou Thème uniquement
Seulement visible par l’admin Admin only ou Admin seulement

Les colonnes Oui/Non acceptent Yes, No, Oui et Non.

Personnaliser l’affichage de la liste d’attributs

Dans Thème › Général, le réglage Attributs d’annonce choisit la mise en page de la liste sur la fiche annonce : Grille ou Largeur de la page (full width).

Pour aller plus loin, chaque attribut de la liste porte la classe CSS listing-attribut- suivie de son alias, que votre CSS peut cibler (voir Modifier le code de mon thème).

Une page par valeur d’attribut

Un attribut peut servir de condition à une collection, et un modèle de collection crée une page par valeur de l’attribut, par exemple une par marque. Voir Créer une collection et Créer des collections avec un modèle.

Ce que vos utilisateurs voient

Les vendeurs trouvent dans leur formulaire d’annonce les attributs de la catégorie choisie, avec leur infobulle ; un astérisque signale un champ obligatoire. Les attributs dont la Lecture seule est sur Oui, ou dont la Visibilité est Seulement visible par l’admin, n’y figurent pas.

Les visiteurs voient, sur la fiche annonce, la liste des attributs dont la Visibilité est Tout le monde et qui ont une valeur. Les attributs en visibilité Thème uniquement s’affichent là où le thème les place. Les attributs dont Utiliser dans les filtres de recherche est sur Oui apparaissent dans les filtres des résultats de recherche, sauf en visibilité Seulement visible par l’admin.

Cas particuliers et limites

  • Type figé : le type d’un attribut se choisit à la création et ne se modifie plus ensuite, ni dans la fiche ni par import.
  • Attribut lié à aucune catégorie : il n’apparaît dans aucun formulaire.
  • Changement de catégorie : une annonce affiche seulement les attributs de sa catégorie actuelle. Les valeurs des attributs de l’ancienne catégorie disparaissent de la fiche annonce et de la recherche, mais restent enregistrées : si l’annonce retourne dans sa catégorie d’origine, elles réapparaissent, sans rien ressaisir. Les attributs liés à toutes les catégories restent toujours affichés.
  • Attribut obligatoire absent du formulaire du vendeur : avec Champs obligatoires sur Oui, un attribut dont la Lecture seule est sur Oui, ou dont la Visibilité est Seulement visible par l’admin, n’est pas exigé du vendeur, qui n’a pas le champ.
  • Webhooks : ils transmettent toutes les valeurs à vos propres systèmes, y compris celles des attributs dont la Visibilité est Seulement visible par l’admin.
  • Import : une valeur de visibilité hors du tableau ci-dessus est refusée pour un nouvel attribut, et donne la visibilité Tout le monde à un attribut existant. Le fichier ne contient pas Lecture seule : réglez-la dans la fiche de l’attribut.