PS PrestaShop Débutant

Positions Produits — Guide complet

Installer et utiliser Positions Produits 2.0 : grille de merchandising, glisser-déposer multiple, tri automatique, épingles, historique, import CSV, règles automatiques avec sous-catégories toujours en tête ou à la fin, tâche planifiée et tableau de bord.

Mis à jour Version du module 2.1.0

Présentation

Positions Produits gère l’ordre des produits dans vos catégories PrestaShop, c’est-à-dire la colonne native category_product.position que la boutique utilise pour le tri « Pertinence » / « Position dans la catégorie ». Vous organisez une catégorie comme un tableau de merchandising : grille de cartes produits, glisser-déposer de plusieurs produits à la fois, tri automatique, épingles qui protègent vos positions stratégiques contre les imports, historique avec annulation et règles automatiques appliquées chaque jour.

Le module ne modifie pas votre thème : l’ordre défini dans le back-office est celui que vos clients voient, sous Classic comme sous Hummingbird.

DataFirefly Positions produits : tableau de merchandising avec arborescence des catégories, grille de produits, produits épinglés, stock, ventes et sauts de page
Tableau de merchandising avec arborescence des catégories, grille de produits, produits épinglés, stock, ventes et sauts de page

Compatibilité et prérequis

  • PrestaShop 1.7.8 à 9.x : un seul paquet, testé sur 1.7.8.11, 8.2.1 et 9.1.5.
  • PHP 7.4 à 8.5.
  • Thèmes Classic, Hummingbird et thèmes personnalisés (le module n’affiche rien en front-office).
  • Mono-boutique et multiboutique, toutes les langues de la boutique.
  • Aucun service externe. La bibliothèque de glisser-déposer (SortableJS, licence MIT) est livrée dans le module.
  • Recommandé : l’extension PHP intl, pour trier les noms selon l’ordre alphabétique de chaque langue (sans elle, le tri ignore simplement les accents).

Installation et mise à jour

  1. Ouvrez Modules > Gestionnaire de modules, cliquez sur Installer un module et déposez dfproductpositions-2.1.0.zip.
  2. L’entrée Catalogue > Positions produits apparaît dans le menu, traduite dans la langue de chaque employé.
  3. Le bouton Configurer du gestionnaire de modules ouvre directement le module.

Pour mettre à jour depuis une version 1.x, déposez la nouvelle archive par-dessus l’ancienne : la migration s’exécute automatiquement. L’ordre de vos catégories n’est pas modifié et chaque épingle prend le rang que son produit occupe au moment de la mise à jour.

Le module comporte quatre écrans, accessibles par la barre de navigation : Organiser, Règles automatiques, Tableau de bord et Réglages. À l’ouverture, choisissez une catégorie dans l’arborescence de gauche.

DataFirefly Positions produits : écran d'accueil avec l'arborescence des catégories et des conseils
Écran d’accueil avec l’arborescence des catégories et des conseils

Organiser une catégorie

L’arborescence de gauche affiche toutes les catégories de la boutique avec le nombre de produits, une pastille orange quand la catégorie contient des produits épinglés et un éclair violet quand elle a une règle automatique. Le champ de recherche filtre l’arborescence et surligne les noms trouvés.

À droite, la catégorie s’affiche dans l’ordre de la boutique :

  • Vue Grille : une carte par produit avec la position, la vignette, le nom, la référence, l’ID, le prix HT, le stock (vert, orange sous le seuil de stock faible, rouge en rupture) et les unités vendues sur la période choisie. Des badges signalent les produits nouveaux, en promotion, inactifs ou absents de la boutique courante.
  • Vue Liste : les mêmes informations en lignes compactes, avec la date d’ajout.
  • Afficher les pages : un séparateur « Page 2 · positions 13 à 24 » montre où commence chaque page de la catégorie, d’après le nombre de produits par page de votre boutique.
  • Recherche par nom, référence ou ID (raccourci /).
  • Le sélecteur de langue change la langue des noms affichés, et l’icône à côté du titre ouvre la catégorie dans la boutique.

Chaque modification est enregistrée automatiquement ; l’indicateur en haut à droite confirme « Modifications enregistrées ».

DataFirefly Positions produits : vue liste avec position, prix, stock, ventes et date d'ajout
Vue liste avec position, prix, stock, ventes et date d’ajout

Déplacer les produits

Glisser-déposer

Saisissez une carte et déposez-la à l’endroit voulu ; la page défile automatiquement quand vous approchez du bord. Pendant une recherche, le glisser-déposer est désactivé pour éviter les erreurs, mais la sélection et les actions restent disponibles.

Sélection multiple

Cliquez sur plusieurs cartes pour les sélectionner, Maj + clic pour sélectionner une série, Ctrl + A pour tout sélectionner, Échap pour vider la sélection. Une barre d’actions apparaît en bas de l’écran : Déplacer en haut, Déplacer en bas, Déplacer à la position…, Épingler et Désépingler. Les produits sélectionnés sont placés les uns après les autres, dans leur ordre actuel.

DataFirefly Positions produits : sélection multiple de produits avec la barre d'actions groupées
Sélection multiple de produits avec la barre d’actions groupées

Glisser plusieurs produits à la fois

Quand plusieurs produits sont sélectionnés, faites glisser l’un d’eux : les autres le suivent et un badge « +2 » indique combien de produits sont portés. Au dépôt, ils sont regroupés à cet endroit.

DataFirefly Positions produits : glisser-déposer de plusieurs produits à la fois
Glisser-déposer de plusieurs produits à la fois

Saisir une position

Cliquez sur le numéro de position d’une carte, tapez le nouveau rang et validez avec Entrée. Les boutons qui apparaissent au survol d’une carte envoient aussi le produit en haut ou en bas, l’épinglent ou ouvrent sa fiche.

Tri automatique

Le bouton Trier automatiquement classe toute la catégorie selon un critère :

  • Meilleures ventes sur 7, 30, 90, 180 ou 365 jours (commandes valides de la boutique courante) ;
  • Date d’ajout (nouveautés d’abord) ;
  • Stock ;
  • Prix (prix de base HT) ;
  • Marge (prix de vente moins prix d’achat) ;
  • Nom (ordre alphabétique de la langue) ;
  • Référence (ordre naturel : REF-2 avant REF-10) ;
  • Promotions en premier ;
  • Ordre actuel, Inverser l’ordre actuel et Mélanger.

Options : Ruptures à la fin, Produits inactifs à la fin, Trier aussi les sous-catégories et, si la catégorie a des sous-catégories, Sous-catégories à part (voir « Sous-catégories toujours en tête ou à la fin »). La case Garder ce tri : enregistrer comme règle automatique transforme le tri en règle appliquée chaque jour.

Les produits épinglés gardent leur place, et chaque tri peut être annulé en un clic.

DataFirefly Positions produits : tri automatique par meilleures ventes, date d'ajout, stock, prix ou marge, ruptures à la fin et règle automatique
Tri automatique par meilleures ventes, date d’ajout, stock, prix ou marge, ruptures à la fin et règle automatique

Épingler des positions

Une épingle fixe un produit à son rang actuel dans la catégorie. Un produit épinglé affiche une pastille orange avec son numéro de position.

  • Les tris automatiques, les règles et les imports CSV ne déplacent jamais un produit épinglé : les autres produits se rangent autour.
  • Si vous déplacez vous-même un produit épinglé, il est ré-épinglé à sa nouvelle place.
  • Un produit non épinglé déposé sur la place d’une épingle se range juste après elle.

Épingle temporaire

En épinglant une sélection, vous pouvez indiquer une date de fin, par exemple la fin d’une promotion. L’épingle est retirée automatiquement à cette date par la tâche planifiée, et la date apparaît sur la carte.

DataFirefly Positions produits : épingler des produits à leur place jusqu'à une date
Épingler des produits à leur place jusqu’à une date

Épingler toute la catégorie

Le menu Épingles propose Épingler toute la catégorie (chaque produit garde sa place, même après un import), Retirer toutes les épingles (l’ordre ne change pas) et Remettre les épingles en place.

Remise en place automatique

Quand l’option est active (par défaut), les produits épinglés reviennent à leur place après l’enregistrement, l’ajout ou la suppression d’un produit, après une modification de position par le back-office natif ou par le webservice (ERP), et à chaque passage de la tâche planifiée. Si un autre outil a déplacé des produits épinglés, un bandeau le signale à l’ouverture de la catégorie avec un bouton Remettre en place.

Un script qui écrit directement dans la base de données ne déclenche aucun événement PrestaShop. Dans ce cas, la tâche planifiée remet les épingles en place à son prochain passage, ou vous pouvez le faire tout de suite depuis le menu Épingles.

Annuler et historique

Les boutons Annuler et Rétablir (Ctrl + Z / Ctrl + Y) restaurent exactement l’ordre et les épingles précédents. Les notifications après un tri ou un déplacement proposent aussi « Annuler ».

Le menu Plus > Historique liste les modifications de la catégorie (glisser-déposer, tris, règles, épingles, imports, tâche planifiée) avec la date, l’auteur et le nombre de produits déplacés. Restaurer remet la catégorie dans l’ordre qu’elle avait avant la modification choisie. Le nombre de versions conservées par catégorie se règle dans les réglages (30 par défaut).

DataFirefly Positions produits : historique des modifications d'une catégorie avec restauration d'un ordre précédent
Historique des modifications d’une catégorie avec restauration d’un ordre précédent

Import et export CSV

Plus > Exporter l’ordre (CSV) télécharge la catégorie avec la position, l’ID, la référence, le nom et l’état d’épinglage (séparateur point-virgule, UTF-8).

Plus > Importer un ordre (CSV) lit un fichier avec un produit par ligne, identifié par id_product ou reference ; une colonne position facultative est aussi lue. Cliquez d’abord sur Vérifier le fichier : le module indique combien de produits de la catégorie ont été trouvés et liste les références inconnues. Les produits listés passent en premier, les autres suivent dans leur ordre actuel, et les produits épinglés gardent leur place. L’import peut être annulé.

DataFirefly Positions produits : import CSV d'un ordre de produits avec vérification du fichier
Import CSV d’un ordre de produits avec vérification du fichier

Règles automatiques et tâche planifiée

Une règle garde une catégorie triée toute seule : meilleures ventes des 30 derniers jours, nouveautés d’abord, ruptures à la fin… Chaque catégorie peut avoir une règle, active ou en pause. L’écran Règles automatiques affiche pour chacune la dernière exécution et le nombre de produits déplacés, avec les boutons Appliquer maintenant, Modifier et Supprimer.

Les règles sont appliquées par la tâche planifiée : appelez l’URL indiquée une fois par jour (ou toutes les heures) depuis votre serveur ou le panneau de votre hébergeur. L’écran donne un bouton Copier et un exemple de ligne crontab :

15 4 * * * curl -fsS "https://votre-boutique.fr/module/dfproductpositions/cron?token=…" > /dev/null

À chaque passage, la tâche retire les épingles expirées, applique les règles actives et remet les produits épinglés en place. L’URL est protégée par une clé secrète, que vous pouvez renouveler dans les réglages.

DataFirefly Positions produits : règles de tri automatique par catégorie et URL de la tâche planifiée
Règles de tri automatique par catégorie et URL de la tâche planifiée

Créer ou modifier une règle

Choisissez la catégorie, le critère, le sens et, pour les meilleures ventes, la période. Les options « ruptures à la fin », « produits inactifs à la fin » et « trier aussi les sous-catégories » sont disponibles, ainsi que les listes Toujours en tête et Toujours à la fin décrites ci-dessous. Enregistrer et appliquer trie la catégorie immédiatement.

DataFirefly Positions produits : éditeur de règle automatique : catégorie, critère, période des ventes et options
Éditeur de règle automatique : catégorie, critère, période des ventes et options

Sous-catégories toujours en tête ou à la fin

Dans une catégorie principale qui regroupe les produits de plusieurs sous-catégories, la section Sous-catégories à part place les produits de certaines sous-catégories avant ou après tous les autres, quel que soit le critère choisi. Par exemple : les accessoires toujours à la fin d’une catégorie « Vélos », ou les nouveautés toujours en tête.

  • Toujours en tête et Toujours à la fin acceptent chacune jusqu’à 10 sous-catégories, à choisir dans la liste « Ajouter une sous-catégorie… ». L’ordre des sous-catégories dans une liste est respecté.
  • Un produit fait partie d’une sous-catégorie s’il y est associé, ou associé à l’une de ses propres sous-catégories. Un produit présent dans les deux listes est placé en tête.
  • À l’intérieur de chaque bloc, le critère de la règle s’applique (ventes, nom, prix…), puis les options « ruptures à la fin » et « produits inactifs à la fin ». Les produits épinglés gardent leur rang.
  • Sur le tableau de merchandising, ces produits portent un badge En tête ou À la fin, avec le nom de la sous-catégorie au survol.

Quand la règle est active, le placement est immédiat : à chaque enregistrement d’un produit (fiche produit, import CSV, webservice ou ERP), le module le range dans son bloc. Un produit ajouté à une sous-catégorie « à la fin » descend directement en bas de la catégorie principale, et un nouveau produit de la catégorie principale se place juste avant ce bloc. La tâche planifiée réapplique ensuite la règle complète chaque jour.

Les produits doivent aussi être associés à la catégorie principale : PrestaShop range une catégorie avec les positions des produits qui lui sont associés. Si la catégorie principale n’affiche ces produits que grâce à l’option « Afficher les produits des sous-catégories » de la recherche à facettes, voir « Ce que voient vos clients ».

Tableau de bord

Le tableau de bord résume l’activité : catégories organisées, produits épinglés (et épingles qui se terminent dans les 7 jours), règles actives, produits déplacés sur 7 jours et problèmes de numérotation.

Les contrôles boutique vérifient les réglages qui décident si vos clients voient l’ordre défini ici : tri par défaut de la boutique sur « Position dans la catégorie », options de la recherche à facettes, numérotation des positions, passage de la tâche planifiée et nombre de produits par page.

La section Intégrité des positions liste les catégories dont des produits partagent la même position. Leur ordre est alors aléatoire, et un produit peut apparaître sur deux pages ou sur aucune. Réparer renumérote 1, 2, 3… sans changer l’ordre affiché.

DataFirefly Positions produits : tableau de bord avec contrôles boutique, intégrité des positions et activité récente
Tableau de bord avec contrôles boutique, intégrité des positions et activité récente

Réglages

  • Remettre automatiquement les produits épinglés à leur place (activé par défaut).
  • Période des ventes affichée sur les cartes et utilisée par défaut par le tri « Meilleures ventes » (90 jours).
  • Seuil de stock faible (5).
  • Versions conservées par catégorie dans l’historique (30).
  • Afficher par défaut les sauts de page de la boutique.
  • Prévenir les autres modules après chaque modification (actionCategoryUpdate), pour que les modules qui gardent des listes de produits en cache les rafraîchissent.
  • URL de la tâche planifiée et renouvellement de sa clé secrète.
DataFirefly Positions produits : réglages : épingles, période des ventes, stock faible, historique et tâche planifiée
Réglages : épingles, période des ventes, stock faible, historique et tâche planifiée

Ce que voient vos clients

Le module écrit dans la position native PrestaShop : la page catégorie affiche les produits dans l’ordre défini, sans modification du thème. Deux réglages de la boutique méritent attention, et le tableau de bord les contrôle :

  • dans Paramètres de la boutique > Produits, le tri par défaut doit être « Position dans la catégorie », croissant ;
  • avec la recherche à facettes et l’option « Afficher les produits des sous-catégories », une catégorie parente mélange les positions de ses sous-catégories. Pour maîtriser exactement une catégorie parente, triez-la avec ses sous-catégories ou désactivez cette option.
DataFirefly Positions produits : page catégorie de la boutique affichée dans l'ordre défini dans le back-office
Page catégorie de la boutique affichée dans l’ordre défini dans le back-office

Droits des employés et multiboutique

L’accès suit les permissions natives de PrestaShop (Paramètres avancés > Équipe > Permissions). Un profil qui a seulement le droit « Voir » sur l’onglet Positions produits consulte les catégories, l’historique et le tableau de bord en lecture seule ; toutes les modifications exigent le droit « Modifier ». Toutes les requêtes sont protégées par le jeton d’administration de PrestaShop.

En multiboutique, l’ordre d’une catégorie est commun à toutes les boutiques (c’est le fonctionnement de PrestaShop, la position n’existe pas par boutique). Le module affiche donc tous les produits de la catégorie et signale par un badge ceux qui ne sont pas vendus dans la boutique courante. Les épingles sont communes elles aussi ; les ventes, les prix et le stock affichés sont ceux de la boutique sélectionnée.

Mise à jour depuis 1.x et désinstallation

La migration vers 2.0.0 ajoute les tables des règles et de l’historique, conserve l’ordre de toutes les catégories et place chaque épingle au rang réel de son produit. Elle corrige au passage le décalage d’une place des épingles constaté en 1.x.

La mise à jour vers 2.1.0 ajoute les sous-catégories toujours en tête ou à la fin. Vos règles, vos épingles et l’ordre de vos catégories ne changent pas.

La désinstallation supprime les épingles, les règles, l’historique, les réglages et l’entrée de menu. L’ordre de vos catégories est conservé, puisqu’il est stocké dans la position native PrestaShop.

FAQ

Faut-il épingler tous les produits pour garder mon ordre ?

Non. L’ordre défini reste en place tant qu’aucun tri, aucune règle ni aucun outil externe ne le modifie. Épinglez les produits dont la place est stratégique, ou toute la catégorie si un ERP réorganise vos produits.

Comment mettre mes produits vedettes en tête et trier le reste automatiquement ?

Placez les produits vedettes en tête, épinglez-les, puis lancez un tri (ou créez une règle) « Meilleures ventes ». Les vedettes restent aux premières places et le reste se trie derrière elles.

Comment afficher les produits d’une sous-catégorie toujours à la fin de la catégorie principale ?

Créez une règle pour la catégorie principale, ajoutez la sous-catégorie à Toujours à la fin, puis cliquez sur Enregistrer et appliquer. Les nouveaux produits de cette sous-catégorie arrivent ensuite directement en bas, sans intervention.

Le tri est-il recalculé à chaque visite ?

Non. Un tri ou une règle écrit les positions une fois ; les pages de la boutique ne font aucun calcul supplémentaire.

Et sur un gros catalogue ?

Sur une catégorie de 5 000 produits (PrestaShop 9.1, PHP 8.5), nous avons mesuré 0,56 s pour charger et afficher la grille, 0,44 s pour un tri par nom et 0,24 s entre le dépôt d’une carte et l’enregistrement.

Un produit apparaît sur deux pages de ma catégorie, ou il manque. Pourquoi ?

Plusieurs produits partagent probablement la même position, ce qui arrive après certains imports. Ouvrez le Tableau de bord : la section Intégrité des positions liste ces catégories et les répare sans changer l’ordre affiché.

L’ordre de ma catégorie parente ne correspond pas à ce que j’ai défini.

La recherche à facettes affiche probablement les produits des sous-catégories dans la catégorie parente. Voir la section « Ce que voient vos clients ».

Je ne vois pas les boutons de modification.

Votre profil a seulement le droit « Voir » sur l’onglet Positions produits. Un administrateur peut ajouter le droit « Modifier » dans Équipe > Permissions.

Les règles ne s’appliquent pas.

Vérifiez que la tâche planifiée appelle bien l’URL du module : le tableau de bord indique la date de son dernier passage. Les règles en pause ne sont pas appliquées.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support