Mise à jour massive des produits

CC Documentation Mise à jour des produits de masse

1. Introduction
2. Installation
3. Activation de la licence
4. Panel de gestion
5. Importation de fichiers
6. Mise à jour en masse par critères
7. Tâches CRON
8. Système de connexion
9. Types d'identificateurs de produits
10. Mappage des colonnes
11. Résolution de problèmes
12. FAQ

1. Introduction

• Importation de fichiers CSV, XLS, XLSX à partir de diverses sources (téléchargement, serveur, URL)
• Mise à jour en masse des produits en fonction de critères (catégories, fourchette de prix, fabricant)
• Prise en charge des tâches CRON à double mode (paramètres de configuration et d'URL)
• Prise en charge de différents types d'identifiants de produits (ID, EAN, UPC, ISBN, MPN, Référence, GTIN)
• Système d'enregistrement avancé pour les opérations
• Mappage intuitif des colonnes avec prévisualisation des fichiers
• Validation et contrôle des erreurs
• Système de gestion des licences
• Mémorisation des paramètres de l'utilisateur

2. installation

• PrestaShop 1.7 ou supérieur
• PHP 7.1 ou plus récent
• Extension PHP : PhpSpreadsheet (pour les fichiers Excel)
• Mémoire minimale : 128 MO
• Permission de créer des répertoires temporaires

1. Télécharger le fichier ZIP du module depuis la boutique officielle cocos.codes
2. Se connecter au panneau d'administration de PrestaShop
3. Aller à : Modules → Gestionnaire de modules → Ajouter un nouveau module
4. Cliquez sur "Ajouter un module" et sélectionnez le fichier ZIP téléchargé.
5. Une fois l'installation terminée, cliquez sur "Configurer"
6. Le module créera automatiquement des répertoires temporaires et installera les paramètres requis.

3. Activation de la licence

1. Après l'installation, procéder à la configuration du module
2. Sélectionnez l'onglet "Licence
3. Saisir la clé de licence reçue après l'achat
4. Cliquez sur "Activer la licence"
5. Une fois l'activation réussie, un message de confirmation s'affiche et toutes les fonctions sont déverrouillées.

4 Panneau de gestion

• Importation de fichiers - Importation de données à partir de fichiers CSV/Excel
• Mise à jour en masse - mise à jour des produits par critères
• Tâches CRON - configuration de l'automatisation
• Journaux - l'affichage et la gestion des journaux d'opérations

• Paramètres - configuration générale du module
• Documentation - lien vers le manuel en ligne
• Soutien - l'accès à l'assistance technique
• Plug-ins - informations sur les extensions supplémentaires
• Licence - gestion des licences de modules

5. importation de fichiers

• Téléchargement de fichiers - téléchargement d'un fichier directement à partir de votre ordinateur
• Chemin d'accès sur le serveur - indication du fichier situé sur le serveur
• URL du fichier - téléchargement d'un fichier à partir d'une URL externe

• CSV (avec détection automatique des séparateurs : , ; | tabulation)
• XLS (anciens fichiers Excel)
• XLSX (fichiers Excel plus récents)

1. Sélectionner la source du fichier
2. Indiquer le fichier (téléchargement, chemin d'accès ou URL)
3. Sélectionner le type d'identifiant du produit
4. Déterminer si le fichier contient des en-têtes
5. Cliquez sur "Prévisualisation et cartographie"
6. Mettre en correspondance les colonnes de données (identifiant, quantité, prix)
7. Cliquez sur "Effectuer l'importation"

• Taille maximale du fichier : 10MB (configurable)
• Vérification du format et de l'intégrité des fichiers
• Validation de la structure des données
• Contrôle de la disponibilité des fichiers externes

6. mise à jour en masse par critères

• Catégories - sélection de produits dans des catégories spécifiques
• Gamme d'identification des produits - d'un identifiant spécifique à un identifiant spécifique
• Fourchette de prix - les produits dont les prix se situent dans une fourchette déterminée
• Fabricant - les produits d'un fabricant particulier
• Statut - produits actifs ou inactifs

• Nouvelle quantité - définir une quantité spécifique pour tous les produits sélectionnés
• Nouveau prix - fixer un prix spécifique pour tous les produits sélectionnés
• Il est possible de mettre à jour la quantité et le prix en même temps ou seulement l'un des paramètres

1. Sélectionner les critères de sélection des produits
2. Définir de nouvelles valeurs (quantité et/ou prix)
3. Cliquez sur "Mettre à jour les produits"
4. Le système indiquera le nombre de produits mis à jour et les éventuelles erreurs.

7 Tâches de CRON

• Sauvegarde des paramètres dans la base de données
• Une tâche CRON pour toutes les mises à jour automatiques
• Configuration aisée via l'interface web
• URL de la tâche : /modules/cc_ps_mass_update_product/controllers/front/cron.php?token=...

• Transmission de tous les paramètres directement dans l'URL
• Possibilité de créer de nombreuses tâches CRON différentes
• Configuration flexible pour les utilisateurs avancés
• Chaque tâche peut avoir des paramètres différents

1. Activer les "tâches CRON"
2. Sélectionner la source du fichier (serveur ou URL)
3. Indiquer le chemin ou l'URL du fichier
4. Configurer le type d'identifiant et le mappage des colonnes
5. Sauvegarder vos paramètres
6. Ajouter une URL à la crontab du serveur

• jeton - jeton de sécurité (obligatoire)
• source - source du fichier (serveur|url)
• chemin_du_fichier - chemin d'accès au fichier sur le serveur
• file_url - URL du fichier
• type_identifiant - type d'identificateur de produit
• a_en-tête - si le fichier contient des en-têtes (1|0)
• identifiant_mapping - numéro de colonne de l'identificateur
• quantité_de_mapping - numéro de colonne avec quantité
• prix_mapping - numéro de colonne de prix

# Tous les jours à 2:00 - mode configuration
0 2 * * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123"
Tous les jours à 3:00 - mise à jour des quantités à partir du serveur
0 3 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123&source=server&file_path=/var/www/files/quantities.csv&identifier_type=ean&has_header=1&mapping_identifier=0&mapping_quantity=1"
Tous les jours à 4:00 - mise à jour des prix à partir de l'URL
0 4 * * * /usr/bin/curl "https://sklep.pl/modules/cc_ps_mass_update_product/controllers/front/cron.php?token=abc123&source=url&file_url=https://dostawca.pl/prices.csv&identifier_type=reference&has_header=1&mapping_identifier=0&mapping_price=2"

8 Système de connexion

• Enregistrement automatique de toutes les opérations de mise à jour
• Différents niveaux de journalisation (INFO, WARNING, ERROR)
• Fichiers journaux séparés pour chaque jour
• Visualisation des journaux directement dans le panneau d'administration
• Possibilité de télécharger les fichiers journaux complets
• Nettoyage automatique des vieilles billes

• Statut de connexion - activer/désactiver l'enregistrement des journaux
• Liste des fichiers journaux - aperçu de tous les fichiers avec dates et tailles
• Aperçu des journaux - affichage des 200 dernières lignes avec coloration par niveau
• Téléchargement des journaux - télécharger les fichiers journaux complets
• Nettoyer les vieilles billes - suppression des journaux datant de plus de 30 jours

[2025-01-15 14:30:22] [INFO] Démarrage de la mise à jour en masse à partir du fichier : /var/www/files/products.csv
[2025-01-15 14:30:23] [INFO] Mise à jour de la quantité du produit : ID 123, Quantité : 50
[2025-01-15 14:30:23] [WARNING] Produit non trouvé par le code EAN : 1234567890123
[2025-01-15 14:30:25] [INFO] Mise à jour de la masse terminée | Contexte : {"success":45, "failed":2}

9 Types d'identificateurs de produits

• ID du produit - le plus rapide, mais nécessitant la connaissance des identifiants internes
• Référence/SKU - le plus souvent utilisé dans les boutiques en ligne
• EAN - norme pour les produits physiques
• GTIN - universel, vérifie tous les codes-barres possibles

10. mappage des colonnes

1. Après avoir sélectionné le fichier, le système affiche un aperçu des 5 premières lignes.
2. L'utilisateur indique la colonne qui contient l'identifiant du produit
3. Les colonnes indiquant la quantité et/ou le prix sont facultatives.
4. Le système valide l'exactitude de la mise en correspondance
5. Une fois approuvées, les données sont importées

• Colonne d'identification - toujours nécessaire
• Colonne de quantité - optionnel (entiers ≥ 0)
• Colonne de prix - optionnel (nombres réels ≥ 0, max 2 décimales)
• Au moins une des colonnes (quantité ou prix) doit être mise en correspondance.
• Les colonnes ne doivent pas être identiques

• Le module enregistre automatiquement les derniers mappages dans le localStorage
• Les correspondances sont rétablies pour les fichiers dont la structure est identique.
• Chaque correspondance contient des informations sur le type d'identifiant et les en-têtes
• Les mappages sont valables pendant 7 jours
• Possibilité d'effacer manuellement les paramètres enregistrés

ean,nom,quantité,prix
1234567890123,"Produkt A",50,19.99
1234567890124,"Produkt B",30,29.99
1234567890125,"Produkt C",0,39.99

11 Dépannage

1. Vérifier que le module dispose d'une licence active
2. Assurez-vous que le fichier a un format supporté (CSV, XLS, XLSX).
3. Vérifier la taille du fichier (max. 10MB par défaut)
4. Pour les fichiers provenant du serveur, vérifiez les autorisations de lecture.
5. Pour l'URL, vérifier la disponibilité et l'exactitude de l'adresse
6. Vérifiez les journaux du module pour obtenir des détails sur l'erreur.

1. Vérifier l'exactitude du mappage des colonnes
2. Vérifier le type d'identifiant du produit
3. S'assurer que les identifiants du fichier sont corrects
4. Vérifier si les produits existent dans la boutique
5. Vérifier le format des données (nombres pour les quantités et les prix)
6. Examiner les journaux pour détecter les avertissements

1. Valider le jeton de sécurité
2. Assurez-vous que la fonction cron est activée dans la configuration (mode configuration).
3. Vérifier la disponibilité du fichier source
4. Vérifier les journaux de la tâche CRON sur le serveur
5. Assurez-vous que l'URL de la tâche CRON est correcte
6. Vérifier si le serveur peut exécuter des requêtes HTTP

1. Réduire la taille des fichiers importés
2. Augmenter la limite de temps d'exécution de PHP (max_execution_time)
3. Augmenter la limite de mémoire de PHP (memory_limit)
4. Désactiver la journalisation pour les importations très importantes
5. Utiliser des tâches CRON au lieu d'importations basées sur le navigateur
6. Diviser les fichiers volumineux en petits morceaux

12. LA FAQ