# DataFirefly Product Order — Guide complet

> Guide complet d'installation, de configuration et d'utilisation de DataFirefly Product Order pour trier vos produits WooCommerce par glisser-déposer.

- Page: <https://www.datafirefly.com/documentation/datafirefly-product-order/>
- Langue: fr
- Mis à jour le: 2026-06-28
- Autres langues: [en](https://www.datafirefly.com/en/documentation/datafirefly-product-order/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-product-order/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-product-order/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-product-order/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-product-order/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-product-order/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-product-order/index.md)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

DataFirefly Product Order ajoute une page d'administration dédiée pour définir, par simple glisser-déposer, l'ordre d'affichage de vos produits WooCommerce. Vous pouvez fixer un ordre global pour toute la boutique ou un ordre indépendant pour chaque catégorie. L'ordre personnalisé ne s'applique au front que lorsque le client utilise le tri par défaut : les tris par prix, popularité ou note restent intacts. Ce guide couvre l'installation, l'écran de tri, la différence entre ordre global et ordre par catégorie, l'application au front, la règle « rupture de stock en bas », la performance, la compatibilité et le dépannage.

## Installation

1. Téléchargez l'archive `df-product-order.zip` depuis votre compte DataFirefly.
2. Back-office WordPress → **Extensions** → **Ajouter** → **Téléverser une extension** → envoyez le ZIP, puis **Activer**.
3. À l'activation, l'extension crée sa table de positions (`wp_dfpord_order`) et ajoute l'entrée **Produits → Ordre des produits**.

Nécessite WordPress 6.4 ou supérieur, PHP 8.0 ou supérieur et WooCommerce 7.0 ou supérieur. Compatible HPOS (stockage haute performance des commandes), multisite et multilingue. Aucune dépendance Composer, aucun service externe.

## Prise en main en deux minutes

1. Ouvrez **Produits → Ordre des produits**.
2. Dans le menu **Portée**, laissez « Ordre global (boutique) » ou choisissez une catégorie.
3. Glissez-déposez les produits dans l'ordre souhaité à l'aide de la poignée située à gauche de chaque ligne. Chaque dépôt est enregistré automatiquement.
4. Visitez votre boutique : les produits apparaissent dans le nouvel ordre dès que le tri actif est « par défaut ».

Pour un résultat visible immédiatement, vérifiez que le tri par défaut de votre boutique est bien « Tri par défaut » (Réglages WooCommerce → Produits → Affichage), et non un tri par date ou par prix.

## L'écran « Ordre des produits »

Toute la gestion se fait depuis **Produits → Ordre des produits**. L'écran comprend une barre d'outils et la liste triable.

### Barre d'outils

- **Portée** : choisissez « Ordre global (boutique) » ou une catégorie de produits précise. Changer de portée recharge la liste correspondante.
- **Rechercher** : filtre la liste par nom de produit, utile pour retrouver rapidement un article dans une grande catégorie.
- **Produits en rupture en bas** : interrupteur qui active la règle automatique côté boutique (voir plus bas). Son état est enregistré dès que vous le modifiez.

### Liste triable

Chaque ligne affiche une poignée de déplacement, la vignette du produit, son nom (avec un badge _Rupture_ le cas échéant) et son prix. Saisissez une ligne par sa poignée, déplacez-la, relâchez : l'ordre est sauvegardé en arrière-plan et un message « Ordre enregistré » confirme l'opération.

La liste charge jusqu'à 200 produits par portée, ce qui est largement suffisant pour trier une catégorie. Pour une très grande boutique, privilégiez le tri catégorie par catégorie plutôt que la vue globale.

## Ordre global ou ordre par catégorie

Les deux portées sont indépendantes et cohabitent sans conflit.

### Ordre global (boutique)

Définit l'ordre utilisé sur la page boutique et partout où les produits sont affichés sans contexte de catégorie. Pour rester compatible avec votre thème et vos autres extensions, l'ordre global synchronise le champ natif `menu_order` de chaque produit.

### Ordre par catégorie

Chaque catégorie conserve son propre ordre, stocké dans la table dédiée `wp_dfpord_order`. Un même produit peut donc figurer en tête d'une catégorie et plus bas dans une autre. Cet ordre s'applique sur les pages d'archive de catégorie de produits.

Définissez d'abord un ordre global propre, puis affinez catégorie par catégorie uniquement là où c'est nécessaire. Les produits sans position dans une catégorie se placent automatiquement après ceux qui en ont une, selon l'ordre global puis le titre.

## Application au front

L'ordre personnalisé ne remplace jamais le choix de tri de vos visiteurs. Il s'applique uniquement lorsque le tri actif est le **tri par défaut** de la boutique. Dès qu'un client sélectionne « Trier par tarif », « par popularité » ou « par note moyenne », son choix prévaut et l'ordre personnalisé est ignoré pour cette page.

- Page **Boutique** et listes sans catégorie : ordre global.
- Pages d'**archive de catégorie** : ordre de la catégorie concernée (à défaut, repli sur l'ordre global puis le titre).

## Règle « rupture de stock en bas »

Activée via l'interrupteur de la barre d'outils, cette règle repousse automatiquement les produits en rupture de stock en fin de liste, côté boutique, tout en conservant votre ordre personnalisé pour les produits disponibles. Elle s'ajoute au tri par défaut sans affecter les tris choisis par le client.

La règle agit à l'affichage : elle ne modifie pas l'ordre que vous avez enregistré. Désactivez l'interrupteur pour revenir à un classement strictement manuel.

## Volume, performance et limites

- Les positions sont mises en cache (cache objet) pour éviter des requêtes répétées et garder des pages boutique rapides.
- L'écran d'administration charge au maximum 200 produits par portée ; ce plafond peut être relevé par un développeur en ajustant la limite de chargement dans le code.
- L'enregistrement d'un nouvel ordre met à jour les positions de la portée et, pour l'ordre global, le champ `menu_order` des produits concernés.

## Compatibilité et notes techniques

- WordPress 6.4+, PHP 8.0 à 8.3, WooCommerce 7.0+, multisite.
- Compatibilité HPOS (stockage haute performance des commandes) déclarée.
- Ordre global stocké via le champ natif `menu_order` ; ordre par catégorie stocké dans la table `wp_dfpord_order` (clé unique produit + catégorie).
- Application au front via le filtrage des clauses de requête, uniquement sur le tri par défaut.
- Multilingue : un modèle de traduction `.pot` est fourni (compatible Polylang, WPML, Loco Translate).
- Architecture PSR-4 avec autoloader, sans dépendance Composer ni appel à un service tiers.

## Désinstallation

La suppression de l'extension depuis l'écran des extensions exécute un nettoyage complet : la table `wp_dfpord_order` est supprimée et les options du plugin sont effacées. Le champ `menu_order` des produits, étant une donnée native de WooCommerce, est conservé. La simple désactivation ne supprime aucune donnée.

## FAQ et dépannage

**L'ordre n'apparaît pas sur la boutique.** Vérifiez que le tri par défaut est sélectionné (et non un tri par prix ou par date). Contrôlez aussi le réglage WooCommerce → Produits → Affichage et videz le cache si vous utilisez une extension de cache de pages.

**Mon ordre par catégorie n'est pas pris en compte.** Assurez-vous d'avoir sélectionné la bonne catégorie dans le menu « Portée » avant de trier, et de consulter la page d'archive de cette catégorie au front (et non la page boutique).

**Le glisser-déposer ne réagit pas.** Forcez le rechargement de la page (cache du navigateur) et vérifiez qu'aucune extension de minification ou de blocage JavaScript n'empêche le chargement des scripts d'administration.

**Un produit n'apparaît pas dans la liste.** La liste est limitée à 200 produits par portée et n'affiche que les produits publiés. Utilisez le champ de recherche, ou triez par catégorie pour réduire le volume.

**Les produits en rupture ne descendent pas.** Activez l'interrupteur « Produits en rupture en bas » ; la règle ne s'applique qu'au tri par défaut, pas aux tris par prix, popularité ou note.
