DOCUMENTATION · VERSION CANDIDATE 1.0.0
Votre premier stock
bien en main.
De l’installation à l’import CSV : les étapes pour prendre en main BMS Stock Manager et vérifier son comportement sur votre boutique.
01 — Les prérequis
Une installation WordPress avec WooCommerce actif et un compte autorisé à gérer WooCommerce sont nécessaires. Les versions minimales déclarées sont WordPress 6.6, WooCommerce 9.0 et PHP 7.4.
Ces minima sont des cibles de compatibilité. La version candidate doit encore être validée avec votre environnement réel, vos extensions et une version de PHP maintenue par votre hébergeur.
Avant toute opération sur les stocks, sauvegardez les fichiers et la base de données de votre boutique. Utilisez d’abord un environnement de préproduction isolé.
02 — Installer BMS Stock Manager
- Téléchargez l’archive bms-stock-manager-1.0.0.zip depuis la page d’accueil. Ne la décompressez pas pour une installation depuis WordPress.
- Dans l’administration WordPress, ouvrez Extensions → Ajouter une extension → Téléverser une extension.
- Sélectionnez l’archive ZIP, lancez l’installation, puis activez BMS Stock Manager. WooCommerce doit être actif.
- Ouvrez Produits → BMS Stock Manager. Vérifiez que vous retrouvez les produits simples et les variations attendus.
- Modifiez le prix ou la quantité d’un produit de test, puis cliquez sur Enregistrer. Contrôlez sa fiche WooCommerce et l’entrée correspondante dans l’historique BMS Stock Manager.
L’interface du plugin suit la langue du profil utilisateur WordPress, lorsqu’une traduction est disponible. Les traductions française et anglaise sont fournies. Le sélecteur de langue de ce site ne modifie pas WordPress.
Depuis Woo Stock Grid
L’ancienne grille et BMS Stock Manager utilisent les données natives de WooCommerce. Sur une copie sauvegardée de votre boutique, désactivez Woo Stock Grid, puis installez et activez BMS Stock Manager. Aucun import de produits, de prix ou de stocks n’est nécessaire.
Comparez les prix normaux et promotionnels, les quantités, la gestion du stock et l’activation sur quelques produits simples et variations. Vérifiez aussi les variations désactivées et le stock partagé avec le parent. Conservez l’ancienne extension désactivée pendant les tests ; ne faites pas fonctionner les deux grilles en parallèle.
03 — Gérer les prix et le stock
Retrouver une référence
Recherchez le nom du produit ou son SKU. Utilisez les filtres de catégorie et de statut pour réduire la liste. La grille propose une ligne par produit simple ou variation. Les parents variables n’ont pas de ligne propre ; une variation peut gérer son stock ou le partager avec son parent.
Modifier, puis enregistrer
Modifiez le prix normal, le prix promotionnel, la quantité, la gestion du stock ou l’activation du produit concerné. Les changements restent en attente jusqu’au clic sur Enregistrer. Vérifiez les retours par ligne et conservez les modifications à corriger en cas d’erreur. Pour une opération groupée, vérifiez la sélection et l’action avant de confirmer.
Comprendre les règles
La gestion du stock active le suivi des quantités. Les commandes en réapprovisionnement déterminent si WooCommerce peut accepter des commandes malgré un stock insuffisant. Le seuil de stock faible définit quand une référence doit être surveillée. L’activation contrôle la disponibilité de la référence ; ce réglage est distinct de la quantité. Vérifiez l’effet des changements dans la boutique.
L’historique BMS Stock Manager concerne les modifications effectuées via le plugin. Il ne remplace pas une sauvegarde, un outil comptable ou un journal global de tous les événements WooCommerce.
04 — Travailler avec un CSV
Commencez par exporter un CSV depuis BMS Stock Manager : ce fichier constitue le modèle de référence. Conservez l’en-tête, les identifiants et la colonne snapshot. Enregistrez votre fichier en UTF-8.
| Colonne | Utilisation |
|---|---|
id | Identifiant du produit ou de la variation, obligatoire. |
sku, name | Repères informatifs pour identifier la référence. |
regular_price | Prix normal, décimal positif ou nul. |
sale_price | Prix promotionnel, ou vide pour retirer la promotion. |
enabled | 1 pour activer, 0 pour désactiver le produit ou la variation. |
manage_stock | 1 pour activer la gestion des quantités, 0 pour la désactiver. |
stock_quantity | Quantité entière entre −999999999 et 999999999. Une quantité négative représente un déficit ; les commandes en attente dépendent du réglage backorders. |
stock_status | instock, outofstock, onbackorder. |
backorders | no, notify, yes. |
low_stock_amount | Seuil entier supérieur ou égal à zéro, ou vide pour le réglage par défaut. |
snapshot | Valeur de contrôle obligatoire issue de l’export. Ne pas la modifier. |
Un import en trois temps
- Exportez les références concernées, modifiez seulement les champs de prix, de stock ou d’activation utiles et enregistrez une copie.
- Importez le fichier dans BMS Stock Manager, puis examinez l’aperçu et les erreurs éventuelles. Limite : 500 lignes de données et 2 Mo par fichier ; traitement serveur par lots de 100.
- Confirmez l’application après vérification. Consultez le résultat de chaque ligne et contrôlez un échantillon dans WooCommerce.
Si le stock a changé depuis l’export, la valeur snapshot permet de détecter le conflit. Réexportez les lignes concernées et vérifiez-les à nouveau. Ne contournez pas cette protection en modifiant la colonne snapshot.
Le CSV sert à mettre à jour des références existantes, pas à créer de nouveaux produits. Les variations au stock hérité sont exclues de l’export. Utilisez un point comme séparateur décimal des prix. Gardez les SKU comme du texte pour préserver les zéros initiaux.
05 — Avant la mise en production
Réalisez ces vérifications sur une copie récente de la boutique. Un succès sur une installation de test générique ne garantit pas la compatibilité avec toutes vos extensions.
- Sauvegarde complète effectuée, restauration testée et données de test isolées de la boutique réelle.
- Activation, désactivation et accès testés avec un administrateur, un gestionnaire de boutique et un utilisateur non autorisé.
- Produits simples et variations vérifiés, y compris le stock hérité du parent, les ruptures et les réapprovisionnements.
- Prix normal et promotionnel, quantité, gestion du stock, activation et réactivation contrôlés après enregistrement manuel. Opération groupée et seuil de stock faible vérifiés dans WooCommerce.
- Export, réimport sans modification, import modifié, fichier invalide et conflit de stock testés.
- Commande passée pendant un ajustement de stock, annulation et remboursement vérifiés avec votre configuration.
- Historique, auteur et valeurs avant/après contrôlés. Interface française et anglaise, clavier et affichage mobile vérifiés.
- Compatibilité vérifiée avec vos extensions de stock, votre cache, les tâches planifiées et votre volume réel de catalogue.
La publication au répertoire WordPress.org suit un processus de revue distinct. Le téléchargement disponible ici ne signifie pas que le plugin a déjà été accepté ou certifié par WordPress.org.
06 — En cas de difficulté
Le menu ne s’affiche pas
Vérifiez l’activation de WooCommerce et de BMS Stock Manager, puis les droits de votre compte WordPress. Rechargez l’administration après activation.
L’import est refusé
Utilisez un export récent comme modèle. Vérifiez l’encodage UTF-8, les colonnes requises, les identifiants, les valeurs autorisées et les limites de taille. Pour un conflit, réexportez la référence et comparez sa quantité actuelle.
La quantité change à nouveau
Les commandes, remboursements et autres extensions peuvent modifier le stock. Comparez les horaires de ces événements avec l’historique BMS Stock Manager, puis reproduisez le cas en préproduction.
Préparer un signalement utile
Notez les versions de WordPress, WooCommerce, PHP et BMS Stock Manager, les étapes pour reproduire, le résultat attendu et le résultat observé. Retirez toute donnée personnelle ou tout secret des captures et fichiers joints. Le canal de support public sera précisé lors de la diffusion.