MAGENTO 2 · CATÉGORIES · CSV · STORE VIEW

Kowal Export Import Categories

Exportez les attributs de catégories vers CSV, préparez les modifications dans une feuille de calcul et importez-les dans la bonne store view. Contrôlez les valeurs vides, les URL, les images ainsi que le rapport de chaque exécution.

Update et Insert · Dry Run · Traductions et attributs personnalisés

COMMENT ÇA FONCTIONNE EN PRATIQUE

Kowal_ExportImportCategories est un module Magento 2 qui permet d’exporter et d’importer les attributs de catégories au format CSV en tenant compte de la store view sélectionnée. L’extension a été conçue pour les boutiques qui travaillent avec plusieurs versions linguistiques, plusieurs vues de boutique ou qui doivent mettre à jour en masse les données de catégories sans modifier manuellement chaque catégorie dans le panneau d’administration.

Le module permet d’exporter les catégories dans un fichier CSV, de modifier les attributs sélectionnés en dehors de Magento, puis de réimporter les données en mode mise à jour des catégories existantes ou création de nouvelles catégories. L’import fonctionne sur la store view indiquée, ce qui permet de préparer facilement les traductions des noms, descriptions, balises meta, URL et autres attributs de catégories.

Le module est destiné aux :

• boutiques Magento 2 avec plusieurs versions linguistiques,
• équipes de contenu travaillant avec des fichiers CSV,
• agences qui déploient des catalogues de catégories entre environnements,
• administrateurs qui doivent mettre à jour en masse les noms, descriptions, métadonnées et URL de catégories,
• boutiques qui disposent d’attributs de catégories personnalisés et souhaitent les gérer en masse,
• projets dans lesquels les données de catégories sont préparées en dehors de Magento, par exemple par des traducteurs, une équipe SEO ou un système PIM.

• Export des catégories vers CSV pour la store view sélectionnée.
• Import des catégories depuis CSV pour la store view sélectionnée.
• Mode de mise à jour des catégories existantes : update.
• Mode de création de nouvelles catégories : insert.
• Sélection des attributs exportés vers CSV.
• Sélection des attributs importés depuis CSV.
• Colonnes système automatiques nécessaires à l’identification des catégories.
• Validation des en-têtes CSV avant l’import.
• Validation des noms de colonnes par rapport aux attributs de catégories Magento réels.
• Prise en charge des attributs de catégories personnalisés ajoutés dans Magento.
• Prise en charge des valeurs textuelles pour tous les attributs.
• Prise en charge des attributs select et multiselect par libellés d’options.
• Possibilité de travailler sur les valeurs visibles dans la store view ou uniquement sur les remplacements de store view.
• Mode dry-run, c’est-à-dire une validation complète de l’import sans enregistrement des données.
• Politique des valeurs vides.
• Stratégies de gestion de url_key.
• Création optionnelle de permanent redirect lors du changement d’URL de catégorie.
• Prise en charge des chemins vers les images de catégories.
• Batch processing pour les fichiers plus volumineux.
• Politiques de gestion des erreurs.
• Rapport d’import au format CSV.
• Historique des imports dans le panneau d’administration.

L’export permet de générer un fichier CSV avec les catégories pour la store view sélectionnée. L’administrateur choisit la vue de boutique ainsi que les attributs de catégories qui doivent figurer dans le fichier. Le module ajoute automatiquement les colonnes système nécessaires à l’identification des catégories et au maintien de la structure de l’arborescence.

L’export peut être utilisé pour :

• préparer les traductions de catégories,
• auditer les données de catégories,
• corriger en masse les métadonnées SEO,
• comparer les valeurs entre store views,
• préparer un fichier à importer sur le même environnement ou sur un autre,
• archiver les données actuelles des catégories avant modification.

L’export porte sur les attributs de catégories. Le module n’exporte pas les produits associés aux catégories. Il n’effectue pas non plus d’opérations de suppression de catégories.

L’administrateur peut choisir :

• Store View,
• la catégorie de départ,
• les attributs à exporter,
• le séparateur CSV,
• le mode de valeurs store view.

Le module prend en charge deux modes d’export des valeurs :

• resolved_value - la valeur visible dans la store view donnée est exportée, c’est-à-dire après prise en compte du fallback Magento vers la valeur par défaut.
• store_override_only - seule la valeur remplacée directement pour la store view donnée est exportée ; si la valeur est héritée, la cellule CSV reste vide.

Le mode resolved_value est pratique pour le travail éditorial, car il affiche la valeur réelle visible dans la boutique. Le mode store_override_only est utile lorsqu’il faut contrôler uniquement les traductions ou les remplacements spécifiques à une vue de boutique donnée.

L’import permet de charger un fichier CSV et d’enregistrer les attributs de catégories sélectionnés pour la store view indiquée. La store view choisie dans le formulaire d’import est prioritaire, et la colonne store_view_code du CSV sert à valider que le fichier correspond à la vue de boutique sélectionnée.

L’import peut être utilisé pour :

• traduire les catégories,
• mettre à jour les noms de catégories,
• mettre à jour les descriptions de catégories,
• mettre à jour les balises meta,
• mettre à jour url_key,
• créer de nouvelles catégories,
• importer des attributs de catégories personnalisés,
• mettre à jour les attributs de menu et de visibilité,
• importer les chemins des images de catégories.

Le mode update met à jour les catégories existantes. Le module ne crée pas de nouvelles catégories dans ce mode.

La catégorie est recherchée principalement par entity_id. Si entity_id n’est pas disponible, le module peut utiliser category_path, à condition que le chemin identifie une seule catégorie sans ambiguïté.

Le mode update est recommandé pour :

• les traductions de catégories entre store views,
• les corrections SEO,
• les mises à jour de descriptions,
• les mises à jour de noms,
• la modification des valeurs d’attributs de catégories personnalisés.

Exemple de scénario de traduction :

1. Export des catégories depuis la store view de base.
2. Modification de store_view_code dans le CSV avec le code de la store view cible.
3. Conservation des mêmes entity_id.
4. Renseignement des traductions dans les colonnes name, description, meta_title, meta_description.
5. Import en mode update pour la store view cible.

Dans cette variante, le module enregistre les attributs sélectionnés dans le contexte du store_id numérique choisi dans le formulaire d’import.

Le mode insert crée de nouvelles catégories. Dans ce mode, entity_id n’est pas requis, car Magento l’attribue automatiquement.

Une nouvelle catégorie doit avoir un parent indiqué via :

• parent_entity_id,
• ou parent_path.

Le mode insert est recommandé pour :

• créer de nouvelles structures de catégories,
• transférer une arborescence de catégories entre environnements,
• préparer des catégories dans une feuille CSV,
• créer des catégories à partir de données externes.

Si l’import contient à la fois un parent et un enfant, les données doivent être organisées dans l’ordre, des catégories de niveau supérieur vers les catégories de niveau inférieur.

La première ligne du fichier CSV doit contenir les en-têtes de colonnes. Les colonnes se divisent en :

• colonnes système,
• colonnes d’attributs de catégories.

Les colonnes d’attributs doivent correspondre aux codes d’attributs Magento, par exemple :

• name,
• url_key,
• description,
• meta_title,
• meta_description,
• is_active,
• include_in_menu.

Le module utilise les colonnes système suivantes :

• store_view_code,
• entity_id,
• parent_entity_id,
• category_path,
• parent_path,
• level,
• position,
• attribute_set_id.

Les colonnes système ne sont pas traitées comme des attributs EAV. Elles servent à identifier les catégories, valider la store view et reconstituer la structure de l’arborescence.

store_view_code,entity_id,category_path,name,url_key,is_active,include_in_menu,meta_titlepl,13,Default Category/Gear/Bags,Torby,torby,1,1,Torbypl,14,Default Category/Gear/Fitness Equipment,Sprzet fitness,sprzet-fitness,1,1,Sprzet fitness

store_view_code,parent_entity_id,parent_path,category_path,name,url_key,is_active,include_in_menudefault,12,Default Category/Gear,Default Category/Gear/Helmets,Helmets,helmets,1,1default,12,Default Category/Gear,Default Category/Gear/Gloves,Gloves,gloves,1,1

Le module enregistre les valeurs dans le CSV sous forme de texte. Le fichier peut ainsi être modifié dans une feuille de calcul, transmis à un traducteur ou préparé automatiquement dans un système externe.

Pour les attributs de type select et multiselect, le module travaille sur les libellés d’options et non sur les ID techniques des options. Cela signifie que le CSV contient des valeurs lisibles, telles que Products only, Position ou Price.

Pour multiselect, plusieurs valeurs sont séparées par le séparateur |.

Exemple :

store_view_code,entity_id,category_path,display_mode,available_sort_by,default_sort_bydefault,13,Default Category/Gear/Bags,Products only,Position|Product Name|Price,Position

Si le libellé d’option n’existe pas ou n’est pas univoque, l’import signalera une erreur de validation.

Lors de l’import, l’administrateur choisit la manière d’interpréter les cellules CSV vides :

• skip_empty - une cellule vide ne modifie pas la valeur existante.
• clear_value - une cellule vide efface la valeur de l’attribut pour la store view sélectionnée.
• use_default - une cellule vide supprime le remplacement de store view et permet à Magento d’utiliser la valeur par défaut.

Par défaut, la variante recommandée pour les mises à jour est skip_empty, car elle limite le risque d’effacement accidentel de données.

Le module permet de configurer la stratégie de gestion de url_key :

• use_csv_value - utilise la valeur du CSV.
• generate_from_name - génère url_key à partir de l’attribut name.
• keep_existing - en mode update, conserve le url_key actuel.
• magento_default - laisse la gestion des URL au mécanisme standard de Magento.

L’administrateur peut également décider si des permanent redirects doivent être créées lors du changement de url_key.

Cette configuration est particulièrement importante pour les traductions, car différentes boutiques peuvent appliquer différentes stratégies :

• URL traduites pour chaque langue,
• URL communes entre versions linguistiques,
• URL générées automatiquement à partir des noms de catégories,
• URL SEO gérées manuellement.

Le module peut importer les attributs d’images de catégories si les colonnes correspondantes sont sélectionnées pour l’import.

Répertoire source par défaut :

pub/media/import/categories

Le CSV contient un chemin textuel relatif à ce répertoire, par exemple :

gear/bags.jpg

Le module valide l’existence du fichier et son extension. Les formats graphiques sûrs pris en charge sont notamment :

• jpg,
• jpeg,
• png,
• webp,
• gif.

Le mode dry-run permet de lancer la validation de l’import sans enregistrer de données dans Magento.

Dans ce mode, le module :

• lit le CSV,
• valide les en-têtes,
• valide la store view,
• vérifie l’existence des catégories ou des parents,
• vérifie les attributs,
• mappe les valeurs select et multiselect,
• vérifie les images,
• génère un rapport d’erreurs et d’avertissements,
• n’enregistre pas les catégories.

C’est la première étape recommandée avant tout import important.

L’import fonctionne par lots. La taille du batch peut être configurée dans le formulaire d’import.

Valeur par défaut :

100 wierszy

Le batch processing limite le risque de timeouts et de consommation excessive de mémoire avec les fichiers plus volumineux.

Le module prend en charge trois variantes de comportement en cas d’erreur :

• skip_invalid_rows - les lignes erronées sont ignorées, les lignes correctes continuent d’être importées.
• stop_on_first_error - l’import s’arrête à la première erreur.
• all_or_nothing - si la validation de l’une des lignes détecte une erreur avant l’enregistrement, l’import ne commence pas l’écriture.

La variante recommandée pour les imports volumineux est skip_invalid_rows, car elle permet de traiter les données correctes et d’obtenir un rapport des problèmes pour les autres lignes.

Après l’import, le module génère un rapport CSV contenant :

• le numéro de ligne,
• l’identifiant de catégorie,
• le statut,
• le message,
• la liste des attributs modifiés.

L’historique des imports est disponible dans le panneau d’administration. L’administrateur peut vérifier :

• la date de l’import,
• l’utilisateur admin,
• la store view,
• le mode d’import,
• le nom du fichier,
• le nombre de lignes,
• le nombre de succès,
• le nombre d’erreurs,
• l’information indiquant si l’import a été exécuté en dry-run,
• télécharger le rapport d’import.

Le module utilise l’ACL Magento et ajoute des autorisations distinctes pour l’export, l’import et l’historique des imports.

L’import est sécurisé par :

• la validation des en-têtes,
• la validation des codes d’attributs,
• la validation de la store view,
• la validation des colonnes requises,
• la validation des types de valeurs,
• la validation des libellés d’options,
• la validation des fichiers images,
• le reporting des erreurs ligne par ligne.

Le module ne supprime pas les catégories et n’importe pas les produits associés aux catégories.

Vous exportez les catégories depuis la store view de base, renseignez les traductions dans le CSV, remplacez store_view_code par le code de la store view cible et importez les données en mode update.

Vous exportez les attributs meta_title, meta_description, url_key, les modifiez dans le CSV et importez uniquement les colonnes sélectionnées.

Vous préparez un fichier CSV avec category_path, parent_path, name et les autres attributs requis, puis vous l’importez en mode insert.

Si la boutique possède des attributs de catégories personnalisés, le module les récupère dynamiquement depuis EAV et permet de les sélectionner lors de l’export et de l’import.

Après installation, le module est disponible dans :

System > Data Transfer > Export/Import Categories

Vues disponibles :

• Export Categories,
• Import Categories,
• Import History.

System → Data Transfer → Export/Import Categories fournit l’export, l’import et l’historique. La store view sélectionnée dans le formulaire définit le contexte d’enregistrement ; store_view_code dans le fichier sert à vérifier la conformité.

Lorsque vous transférez des données entre instances, vérifiez les identifiants des parents et les chemins de catégories. L’export des attributs seul ne transfère ni les produits ni leurs associations aux catégories.

Le mode all_or_nothing valide toutes les lignes avant de commencer l’enregistrement. Une erreur de cette validation arrête l’import.

Le processus actuel enregistre ensuite les catégories une par une et ne couvre pas tout le fichier avec une seule transaction. Un échec d’enregistrement n’entraîne pas le rollback automatique des catégories déjà enregistrées ; analysez le rapport et conservez un export avant les modifications.

Package kowal/module-export-import-categories, module Kowal_ExportImportCategories. Après avoir configuré l’accès au dépôt Kowal, installez le package, activez le module, mettez Magento à jour et videz le cache. En production, tenez compte de la compilation et du déploiement du contenu statique conformément au processus de la boutique.

1. Vous exportez les données choisies
Vous indiquez la store view, le périmètre des catégories et les attributs.

2. Vous préparez et vérifiez le CSV
Vous modifiez les valeurs et lancez une validation sans enregistrement.

3. Vous importez avec contrôle du résultat
Vous choisissez les politiques d’écriture et analysez le rapport des lignes.

Vous exportez les noms, descriptions et métadonnées. Vous conservez les identifiants de catégories, modifiez le code de vue dans le CSV et préparez les traductions.

Après le dry-run, vous importez les colonnes sélectionnées en mode update vers la store view cible. Les cellules vides sont interprétées selon la politique d’import choisie.