Colonne quantité en stock et badge de stock faible : tableau de produits WooCommerce
Le tableau de produits WooCommerce propose une colonne Quantité en stock toute prête, mais elle n’affiche qu’un nombre brut : 437, 2 ou un tiret. Les boutiques préfèrent souvent quelque chose de plus parlant : « Plus de 100 disponibles » plutôt qu’un chiffre exact, ou un badge « Plus que 3 » lorsqu’un produit ou un atelier est sur le point d’être épuisé. Dans les deux cas, il suffit de modifier légèrement ce qu’imprime la colonne ; le stock réel dans WooCommerce reste intact. Cette page montre ce qu’affichent les colonnes de stock intégrées, comment remplacer le nombre par du texte et comment ajouter un badge de stock faible piloté par le seuil de stock faible de WooCommerce.
Ce que montrent les colonnes de stock du tableau de produits WooCommerce
Trois champs de stock sont disponibles dans la liste Champ (Field) de l’onglet Colonnes (Columns) :
| Colonne | Cellule | Tri et filtre |
|---|---|---|
| Quantité en stock (Stock quantity) | Le nombre d’articles en stock. Un tiret lorsque le produit ne suit pas son stock et lorsque la quantité est 0 ; un nombre négatif lorsque des commandes en attente de réapprovisionnement ont fait passer le stock sous zéro | Triable ; un curseur de plage dans l’onglet Filtre |
| Statut du stock (Stock status) | Une coche verte pour « En stock » et « En réapprovisionnement », une croix rouge pour « Rupture de stock » | Un interrupteur dans l’onglet Filtre qui masque les produits en rupture de stock |
| Gérer le stock (Manage stock) | Une coche ou une croix : indique si le produit suit sa quantité en stock | Triable |
Deux options voisines se trouvent ailleurs. La colonne Titre possède une option Afficher les étiquettes (Show labels) qui ajoute de petites mentions « mis en avant », « en promotion » et « rupture de stock » au nom du produit. Et l’interrupteur En stock uniquement (In stock only) de l’onglet Prédéfinition ne conserve que les produits au statut « En stock » (les produits en réapprovisionnement sont également écartés), comme le décrit la FAQ sur l’affichage des seuls produits en stock. Il n’existe pas de mention de stock faible intégrée avec un seuil ; les sections suivantes en ajoutent une.
Afficher la colonne Quantité en stock sous forme de texte
Chaque colonne du tableau est un champ du profil du plugin, et chaque champ possède une fonction de rappel action qui construit sa cellule à partir de l’ID du produit. Le hook woot_profile_extend permet de remplacer cette fonction pour stock_quantity ; la cellule affiche alors du texte, tandis que le tri et le filtre de plage continuent de fonctionner sur le nombre réel enregistré dans le champ meta _stock :
/*
* Products tables: print the Stock quantity column as text.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woot_profile_extend', function ($profile, $action) {
if ('woot_woocommerce_tables' !== $action || !isset($profile['stock_quantity'])) {
return $profile;
}
$profile['stock_quantity']['action'] = function ($post_id) {
$product = wc_get_product($post_id);
if (!$product) {
return '';
}
if (!$product->is_in_stock()) {
return 'Out of stock';
}
if ($product->is_on_backorder()) {
return 'Available on backorder';
}
if (!$product->managing_stock()) {
return 'In stock'; // the product does not count its items
}
$qty = (int) $product->get_stock_quantity();
if ($qty > 100) {
return 'More than 100 available';
}
return sprintf('%d available', $qty);
};
return $profile;
}, 10, 2);
Adaptez les limites et les mots à votre boutique ; pour afficher « 100+ » pour tout stock supérieur, ne changez que les valeurs retournées. Si le tableau est traduit dans l’onglet Vocabulaire, enveloppez chaque texte dans WOOT_Vocabulary::get() afin qu’il reçoive la traduction de la langue courante. La même technique modifie n’importe quelle autre colonne, par exemple les icônes de Statut du stock (Stock status) (sa clé est stock_status) ; la FAQ sur la modification de l’affichage de la cellule d’une colonne à partir de sa clé donne un autre exemple.
N’utilisez pas pour cela le filtre WooCommerce sur get_stock_quantity(). Il modifie la quantité avec laquelle WooCommerce travaille lui-même : le tableau masque son bouton d’ajout au panier lorsque ce nombre vaut 0 et l’utilise comme maximum du champ de quantité du panier, et les contrôles de stock du panier le lisent aussi. Une modification d’affichage a sa place dans la colonne.
Ajouter un badge de stock faible avec le seuil de stock faible de WooCommerce
Définir le seuil dans WooCommerce
WooCommerce possède déjà le nombre dont vous avez besoin. La valeur valable pour toute la boutique se trouve sous WooCommerce > Réglages (Settings) > Produits (Products) > Inventaire (Inventory), Seuil de stock faible (Low stock threshold). Chaque produit peut la remplacer dans son onglet Inventaire, dans son propre champ Seuil de stock faible (Low stock threshold), qui apparaît une fois le suivi du stock activé pour ce produit. Un atelier de 12 places peut passer à « presque complet » à 3, tandis qu’un article vendu en gros passe à 50. N’oubliez pas que la valeur de toute la boutique déclenche aussi les e-mails de notification de stock faible ; si le badge doit utiliser un autre nombre, écrivez-le plutôt directement dans l’extrait de code.
Enregistrer la colonne du badge
/*
* Products tables: an "Availability" column with a low stock badge.
* Threshold: the product's Low stock threshold, otherwise the store-wide one.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woot_profile_extend', function ($profile, $action) {
if ('woot_woocommerce_tables' !== $action) {
return $profile;
}
$profile['low_stock_badge'] = [
'title' => 'Availability',
'order' => false, // not sortable
'action' => function ($post_id) {
$product = wc_get_product($post_id);
// only products that count their stock and are in stock (not on backorder)
if (!$product || !$product->managing_stock() || !$product->is_in_stock() || $product->is_on_backorder()) {
return '';
}
$qty = (int) $product->get_stock_quantity();
$threshold = $product->get_low_stock_amount();
if ('' === $threshold || null === $threshold) {
$threshold = get_option('woocommerce_notify_low_stock_amount', 2);
}
if ($qty > 0 && $qty <= (int) $threshold) {
return sprintf('<span class="woot-low-stock-badge">Only %d left</span>', $qty);
}
return '';
},
];
return $profile;
}, 10, 2);
Le champ apparaît désormais dans l’onglet Colonnes sous le nom Availability. Ajoutez-le avec Ajouter une colonne à la fin (Append column) (ou Ajouter une colonne au début (Prepend column)), sélectionnez Availability dans Champ (Field), activez-le avec Actif (Active) et, si nécessaire, Mobile. Faites glisser la ligne pour placer la colonne à côté du titre ou du prix. Remplacez « Only %d left » par un texte fixe comme « Presque complet » si vous préférez ne pas afficher le nombre. Pour placer le badge dans la colonne Quantité en stock plutôt que dans une colonne distincte, retournez le même <span> depuis l’extrait de code texte ci-dessus pour les faibles quantités.
Mettre en forme le badge
Collez le CSS dans l’onglet CSS personnalisé (Custom CSS) du tableau et enregistrez-le avec le bouton d’enregistrement ou CTRL+S. Le plugin préfixe chaque règle qui s’y trouve avec l’ID de ce tableau, de sorte que les autres tableaux gardent leur apparence. Pour tous les tableaux à la fois, utilisez plutôt le CSS additionnel du thème.
.woot-low-stock-badge {
display: inline-block;
padding: 2px 8px;
border-radius: 3px;
background: #e8a33d;
color: #fff;
font-size: 12px;
line-height: 1.6;
}
/* optional: tint the whole row of a product that is running low */
tr:has(.woot-low-stock-badge) td {
background: #fff8ec;
}
Gardez chaque accolade fermante sur sa propre ligne, comme ci-dessus : l’onglet CSS personnalisé délimite les règles d’après les retours à la ligne qui les suivent. La teinte de ligne utilise le sélecteur CSS :has(), pris en charge par les navigateurs actuels ; les plus anciens l’ignorent simplement.
Produits variables et commandes en attente de réapprovisionnement
- Un produit variable n’affiche une quantité que si le stock est géré sur le produit lui-même, dans son onglet Inventaire. Lorsque chaque variation a son propre stock, la ligne du produit affiche un tiret dans Quantité en stock (Stock quantity) et aucun badge ; le stock par variation relève alors du tableau des variations, voir la personnalisation de la fenêtre des variations.
- Les produits en réapprovisionnement comptent comme disponibles : Statut du stock (Stock status) affiche pour eux une coche verte et l’interrupteur du filtre les conserve. L’extrait de code texte affiche « Available on backorder » pour eux, et le badge les ignore. Une mention « En réapprovisionnement » dans la colonne Statut du stock et le bouton d’ajout au panier lorsque le stock est à zéro sont traités dans les commandes en attente de réapprovisionnement d’un tableau de produits.
- Un produit passe en « Rupture de stock » au Seuil de rupture de stock (Out of stock threshold) de WooCommerce, qui n’est pas toujours 0. Les deux extraits de code lisent le statut du stock plutôt que de comparer le nombre à 0, et suivent donc ce réglage.
Si le badge ou le texte n’apparaît pas
- Le produit suit son stock : Gérer le stock (Manage stock) affiche une coche pour lui dans le tableau.
- Sa quantité est supérieure à 0 et inférieure ou égale au seuil qui lui est applicable ; vérifiez d’abord le Seuil de stock faible (Low stock threshold) propre au produit, car il remplace la valeur de toute la boutique.
- La colonne Availability est Actif (Active) dans le tableau dont le shortcode figure sur la page, et Mobile est activé si vous testez sur un téléphone.
- L’extrait de code est actif : un plugin d’extraits de code peut exiger que l’extrait soit activé et configuré pour s’exécuter partout, car les cellules du tableau sont construites dans une requête AJAX, et non dans le modèle de la page.
- Un cache de page est vidé après la modification.
Si la colonne affiche encore l’ancien résultat, posez la question sur le forum d’assistance WOOT en indiquant le shortcode du tableau et l’extrait de code que vous utilisez.