Ce qu’est une collection

Une collection est une page de votre vitrine, à sa propre URL, qui présente une liste d’annonces ou d’utilisateurs. Des conditions les choisissent, et la liste suit votre catalogue : une annonce qui remplit les conditions y apparaît d’elle-même. La collection a aussi ses textes, son image et ses réglages pour les moteurs de recherche, comme une page.

L’interrupteur Utiliser en front office, en haut de sa fiche, décide de son usage :

  • activé, la collection est une page de la vitrine, signalée Page vitrine dans la liste, et elle est En ligne ou Hors ligne ;
  • désactivé, la collection regroupe des annonces sans avoir de page : elle n’est ni affichée ni indexée, et la liste la signale Données uniquement.

Cet article décrit les collections qui ont une page.

Créer une collection

  1. Dans le menu, rubrique Configuration, cliquez sur Paramètres, puis sur Collections, dans le groupe Ventes & catalogue.
  2. Cliquez sur Nouvelle collection.
  3. Remplissez la fiche, carte par carte : chacune est décrite ci-dessous.
  4. Cliquez sur Enregistrer, dans la barre « Modifications non enregistrées » qui apparaît en bas de l’écran dès le premier changement.

La collection est créée hors ligne. Une fois enregistrée, le lien Voir la page, en haut de la fiche, ouvre sa page : vous la voyez avant vos visiteurs.

Nom et titre de la page

Dans la carte Détails de la collection :

  • Nom : le nom de la collection dans l’espace d’administration.
  • Titre de la page : le titre affiché sur la page. Vide, la page affiche le nom. Pour une nouvelle collection, l’URL se remplit à partir de ce titre, ou du nom tant que le titre est vide, jusqu’à ce que vous la modifiiez vous-même.
  • Sous-titre et Description : les textes de la page. La description accepte la mise en forme, les liens et les images.

Les conditions

La carte Conditions choisit ce que la collection présente.

  1. À côté de Cette collection présente, choisissez Annonces ou Utilisateurs. Les conditions proposées suivent ce choix.
  2. À côté de Inclure les annonces qui remplissent, choisissez toutes les conditions (chacune doit être remplie) ou au moins une condition (une seule suffit).
  3. Cliquez sur Ajouter une condition, choisissez ce qu’elle porte (une catégorie, un attribut, un prix, une ville…), puis l’opérateur (est, n’est pas, est supérieur à…) et la valeur.
  4. Pour écarter des annonces, cliquez sur Ajouter une exclusion : une annonce qui remplit l’une des exclusions est retirée, quelles que soient les conditions d’inclusion.

En haut à droite de la carte, le nombre d’annonces correspondantes se met à jour à chaque changement.

Dans cet exemple, avec toutes les conditions, la collection présente les annonces de la catégorie Jardin à moins de 50 €, sauf celles qui portent le tag déstockage. Avec au moins une condition, elle présenterait toutes les annonces de jardin et toutes celles à moins de 50 €, toujours sans le tag déstockage.

Une condition sur une catégorie inclut ses sous-catégories. Sur un attribut, les valeurs proposées sont celles de l’attribut.

Annonces ajoutées à la main. Une collection peut aussi recevoir des annonces choisies une à une, par l’API Admin. Elles restent dans la collection quelles que soient les conditions, et la carte Annonces de la fiche en donne le nombre.

L’URL

Le champ Slug, dans la carte Optimisations pour les moteurs de recherche, reçoit le slug de la page, la fin de son URL : promotions-jardin donne https://votre-marketplace.com/promotions-jardin, à la racine de votre vitrine.

Les pages et les collections partagent ces URL, et une URL déjà prise est refusée. Un message sous le champ le dit :

  • dès la saisie, « Une page utilise déjà cette URL. Supprimez d’abord la page, ou choisissez une autre URL. », avec un lien vers la fiche de la page ;
  • dès la saisie, « Cette URL est réservée par la marketplace. Choisissez-en une autre. » : une URL que la marketplace utilise déjà, comme celle de la connexion ;
  • à l’enregistrement, « Une autre collection utilise déjà cette URL. ».

De même, une page ne peut pas prendre l’URL d’une collection.

Changer l’URL d’une collection existante ouvre la fenêtre de confirmation Changer l’URL ?, avec l’URL actuelle, la date depuis laquelle elle est en place, et la nouvelle. Cliquez sur Changer l’URL : l’ancienne URL redirige vers la nouvelle, et les liens existants continuent de fonctionner.

Moteurs de recherche et plan du site

Dans la carte Optimisations pour les moteurs de recherche :

  • Titre SEO et Meta description : le titre et le texte que les moteurs de recherche affichent. Le bouton Insérer une variable y ajoute le nom de la collection, le nom du site, un séparateur ou un extrait de la description : le texte suit alors la collection quand vous la modifiez. Une nouvelle collection part de ces variables. L’Aperçu Google montre le résultat.
  • Meta keywords et URL canonique, comme pour une page.
  • No index et No follow : cochés, ils demandent aux moteurs de recherche de ne pas indexer la page, ou de ne pas suivre ses liens.

Quand l’application Sitemap est active, la carte Plan du site règle la fréquence de mise à jour et la priorité de la page dans le plan du site. Seules les collections en ligne y figurent.

Template, vignette et image

Dans la colonne de droite :

  • Visibilité : En ligne ou Hors ligne.
  • Templates : Page choisit le template de la page, Vignette la carte qui présente chaque annonce ou chaque utilisateur. Les deux sont des fichiers de votre thème (voir plus bas) ;
  • Image principale : l’image de la page, avec son texte alternatif.

L’apparence de la page dépend de votre thème : place du titre, de l’image, nombre de cartes par ligne.

Les fichiers du thème

Le template et la vignette se trouvent dans l’éditeur de thème : dans le menu, rubrique Contenu, cliquez sur Thème, puis sur Éditeur de thème.

  • Template de page : collection.liquid, dans la liste Templates. C’est le choix collection de la liste Page, celui de toutes les collections par défaut : le modifier change la page de chacune d’elles.
  • Vignettes : listing-thumbnail.liquid pour les annonces et user-thumbnail.liquid pour les utilisateurs, dans la liste Snippets. Ce sont les cartes Par défaut de la liste Vignette. listing-thumbnail.liquid sert aussi aux autres listes d’annonces de la vitrine, comme la recherche.

Une page ou une carte propre à certaines collections

Pour donner à une collection sa propre page, sans toucher aux autres :

  1. Dans l’éditeur de thème, cliquez sur à côté de Templates.
  2. Dans la fenêtre, choisissez collection après « Créer un nouveau template pour », saisissez un nom après « nommé », par exemple promo, puis cliquez sur Créer un template.
  3. Le fichier collection.promo.liquid est créé à partir de collection.liquid : modifiez-le, puis enregistrez.
  4. Sur la fiche de la collection, choisissez promo dans Page, puis enregistrez.

Pour lui donner sa propre carte :

  1. Dans l’éditeur de thème, cliquez sur à côté de Snippets, saisissez un nom, par exemple carte-promo, puis cliquez sur Créer un snippet.
  2. Le snippet est créé vide : écrivez la carte, par exemple à partir du contenu de listing-thumbnail.liquid. Il reçoit les mêmes variables, listing pour une annonce, user pour un utilisateur.
  3. Sur la fiche de la collection, choisissez carte-promo dans Vignette, puis enregistrez.

Un snippet supprimé de l’éditeur laisse la collection sur la carte par défaut. Les variables disponibles sont décrites sur le hub développeurs, en anglais.

La liste des collections

L’écran Collections liste les collections, avec leur Nom, leur Titre de la page, leur Slug (la fin de leur URL), leur Usage, leur Visibilité et leur nombre d’Éléments. Les filtres du haut cherchent par nom, par URL, par usage ou par visibilité.

Le nom et le titre de la page se modifient sur place :

  • Nom : survolez la ligne, puis cliquez sur le crayon à côté du nom. Le nom lui-même ouvre la fiche.
  • Titre de la page : cliquez sur le titre. Un tiret signale un titre vide : la page affiche alors le nom.

Saisissez le texte, puis appuyez sur Entrée ou cliquez sur  ; Échap ou annule.

Les modèles de collection, quand il y en a, s’affichent en tête de la liste : voir Créer des collections avec un modèle.

Supprimer une collection

  1. En bas de la fiche, cliquez sur Supprimer la collection.
  2. Dans la fenêtre de confirmation, saisissez au besoin, dans Rediriger vers (facultatif), une URL de votre marketplace, comme /promotions ou / pour l’accueil.
  3. Cliquez sur le bouton Supprimer la collection de la fenêtre.

Avec une redirection, l’URL de la collection mène à la page choisie. Sans redirection, elle renvoie une erreur 404, que les moteurs de recherche lisent comme une page disparue.

Ce que vos utilisateurs voient

La page de la collection présente son titre, son sous-titre, sa description, son image et les cartes des annonces ou des utilisateurs, page par page. Elle est visible de tous tant qu’elle est en ligne.

Pour y mener vos visiteurs, ajoutez un lien vers son URL dans un menu (voir Gérer le menu de navigation) ou dans une page.

Cas particuliers et limites

  • Nombre de conditions : une collection compte au plus 60 conditions, exclusions comprises.
  • Collection d’utilisateurs : les conditions portent sur le groupe d’utilisateurs, la ville, le pays, le département et la distance d’un lieu.
  • Département : proposé sur les marketplaces françaises.
  • Distance d’un lieu (« à moins de N km de ») : proposée quand l’application Google map est active. Elle ne retient que les annonces, ou les utilisateurs, qui ont une géolocalisation : la géolocalisation doit donc être activée pour ce que la collection présente.
  • Collection issue d’un modèle : ses conditions sont celles du modèle, et elle se supprime après avoir été détachée. Voir Créer des collections avec un modèle.
  • API et agent IA : les collections se créent et se modifient aussi par l’API Admin et par un agent IA (voir Connecter un agent IA à votre marketplace avec MCP).