Auguria_PCM Product & Combination Manager

Auguria_PCM Product & Combination Manager Guide utilisateurs v1.5 Auguria 9, rue Alfred Kastler 44300 NANTES FRANCE +33251135012 contact@auguria.net

Plan 1 Description générale du module...3 2 Mise en place du module...3 2.1 Compatibilité Prestashop...3 2.2 Obtention du module...3 2.3 Installation...3 2.3.1 Pré-requis...3 2.3.2 Méthode d'installation...3 2.3.2.1 Déploiement du module...3 2.3.2.2 Installation...3 3 Configuration du module...3 4 Utilisation...4 4.1 Imports...4 4.2 Exports...4 4.3 Archivage et astuces...5 5 Fonctionnement détaillé du module...6 5.1 Import des déclinaisons et attributs...6 5.2 Exports des déclinaisons/attributs ou des produits...7 6 Solutions aux problèmes...10 2/11

1 Description générale du module Le module de gestion des produits/déclinaisons développé par Auguria permet d'importer des combinaisons ou d'exporter les produits et combinaisons de votre boutique via fichier csv afin de permettre une gestion massive des déclinaisons et des produits. C'est un outil simple et efficace, particulièrement pour automatiser la génération de déclinaisons, et mettre à jour vos données massivement depuis un simple fichier csv avant de les réimportées sous ce même format. 2 Mise en place du module 2.1 Compatibilité Prestashop Ce module est compatible avec les versions 1.4.5 à 1.4.8.2 de Prestashop. 2.2 Obtention du module Pour obtenir une version du module, vous pouvez : Nous contacter à l'adresse suivante : contact@auguria.net L'acheter sur http://addons.prestashop.com/fr/ 2.3 Installation 2.3.1 Pré-requis Aucun pré-requis particulier en dehors d'une version de Prestashop compatible (voir 2.1). 2.3.2 Méthode d'installation 2.3.2.1 Déploiement du module Dans l'onglet Modules de votre back-office, cliquez sur le lien d'ajout de modules et chargez le fichier compressé depuis votre machine ou depuis le site de téléchargement du module. Vous pourrez ensuite installer celui-ci. 2.3.2.2 Installation Dans votre back-office, allez dans «Modules Autres modules». Dans ce menu apparaîtra une ligne dédiée au module de gestion des produits/déclinaisons : Cliquez sur «Installer» pour mettre en place le module. 3 Configuration du module Ce module ne dispose d'aucune d'option d'administration et ne requiert aucune configuration. 3/11

4 Utilisation Ce module ajoute l'utilitaire de gestion des produits/déclinaisons au back-office Prestashop. Vous le trouverez dans la partie outils import des attributs de ce dernier. 4.1 Imports Ce module ne génère ni groupes d'attributs, ni produits. Vous devez par conséquent créer ces différents éléments par le biais des procédures standards de Prestashop. Le module génèrera automatiquement les attributs en fonction du groupe défini dans votre fichier.csv et des valeurs que vous lui avez affecté. Ici, les groupes d'attributs (créés précédemment selon les procédures standards de Prestashop) sont le Coloris et la Taille. Les valeurs affectées au déclinaisons qui vont être créées en tant qu'attributs lors de l'import sont respectivement C01 NOIR et C03 ROUGE pour le Coloris; 53/18/14, 53/18/15 et 52/18/135 pour la Taille. Les attributs identiques ne seront créés qu'une et une seule fois. Vous devrez donc dans un premier temps créer un fichier.csv ou modifier le fichier example.csv que vous trouverez dans le dossier imports du module. La description de la structure à adopter et les champs possibles sont indiqués sur la page principale de l'utilitaire d'import. Chaque colonne du fichier correspond à un champ requis ou optionnelle que vous devez ou souhaitez renseigner, chaque ligne (au-delà de la première) correspond à une déclinaisons dotées d'un jeu d'attributs spécifiés dans la colonne destinée à cet effet et de valeurs propres. Une fois votre fichier.csv renseigné, vous pouvez l'uploader grâce au champ prévu à cet effet et valider pour importer les déclinaisons et les attributs associées. Une fois l'import terminé, le module vous indiquera les noms des produits dont des déclinaisons ont été modifiées ou ajoutées, et le cas échéant les références des déclinaisons en cas de modifications. Exemple d'import à partir du fichier example.csv Ci-contre : la table de déclinaisons d'un produit dont ont a affecté l'identifiant à chaque ligne du fichier example.csv fourni dans le dossier 'import' du module (dans la colonne 'id_product'). Cet exemple peut vous servir à titre comparatif avec le support du fichier example.csv afin de mieux appréhender la nature des données à introduire dans ce dernier. 4.2 Exports Vous pouvez exporter vos données de déclinaisons/attributs ou de produits depuis ce module. Sélectionnez le type d'export que vous souhaitez effectuer grâce au menu déroulant «Entités à exporter», puis cliquez sur «Exporter». 4/11

Une fois le fichier.csv généré, une fenêtre popup s'ouvrira pour vous proposer celui-ci en téléchargement ; vous pourrez également récupérer vos exports dans le dossier d'export du module (accessible par client FTP si vous utilisé un hébergement distant). Le nom du fichier correspond à son type (products ou combinations) préfixé par la date de sa génération. Si vous exportez vos déclinaisons, vous pouvez réimporter le fichier produit tel quel, sans aucune modification, grâce à ce même module. Si vous exportez vos produits, vous pouvez réimporter le fichier produit grâce à l'utilitaire d'import standard de Prestashop. Notez cependant qu'il sera alors conseillé d'installer le module de gestion des produits/déclinaisons sur la boutique où vous effectuerez cet import, celui ci ajoutant une configuration prédéfinie permettant d'utiliser l'import standard des produits sans avoir à définir sa configuration détaillée (cf 5.2 Exports des déclinaisons/attributs ou des produits pour plus de détails). Il est également possible de modifier les données des entités exportées grâce à un utilitaire d'édition de texte ou, plus pratique, de feuille de calcul, tel que les tableur OpenOffice ou LibreOffice, à privilégier à un Excel connaissant des difficultés avec les formats de type.csv. Vous pouvez ainsi vérifier et modifier rapidement votre catalogue à l'aide d'un simple tableur. Notes : Depuis la version 1.3 du module, il est possible de préciser la langue d'import/export parmi les langues installées sur votre site. Vous ne pouvez importer/exporter les données que pour une langue à la fois. Depuis cette même version, les valeurs des champs à valeurs multiples sont séparées par défaut par des barres verticales () à la place des virgules («,») afin de permettre l'usage de nombres à virgules comme valeurs de ces champs. Il est conseillé d'utiliser le séparateur par défaut, cependant, si vous avez effectué des exports dans les version précédentes du modules, vous pouvez les importez telles quelles en cochant l'option «Utiliser la virgule comme séparateur de valeurs». 4.3 Archivage et astuces Le dossier imports compris dans le répertoire du module conserve l'historique de tous les fichiers.csv importés (toutes les archives sont renommées selon le format suivant : dateheureproducts_attributes.csv YYYYMMJJ(date)hhmmss(heure). Si vous avez importé des déclinaison par erreur en renseignant une chaine de caractère plutôt qu'un id, n'hésitez pas à récupérer cette chaine pour effectuer une recherche dans votre catalogue à partir de celle-ci afin de les supprimer plus rapidement. 5/11

5 Fonctionnement détaillé du module Cette partie est consacrée au fonctionnement détaillé du module, afin de vous permettre d'exploiter au mieux les possibilités de celui-ci. 5.1 Import des déclinaisons et attributs L'import des déclinaisons et attributs se déroule en deux temps. Dans un premier temps, la procédure établit les informations définies dans le fichier.csv afin de déterminer si le format de données de celui-ci est correct et satisfait aux pré-requis de l'opération. Il s'agit en fait d'une lecture de la première ligne, afin de déterminer les attributs des déclinaisons que vous souhaitez générer. Dans un second, la procédure récupérera les données ligne à ligne, et procédera aux différents traitements requis afin de générer la déclinaison voulue. Certaines de ces information peuvent prendre de multiples syntaxes pour obtenir de tout autant d'effets différents, que nous détaillons ci-après. Détail des colonnes (les information requises sont indiquées, les autres sont facultatives): id_product (requis): Identifiant numérique ou référence d'un produit. Notez que la sélection par référence ajoutera la déclinaison à tous les produits comprenant la chaine de caractère renseignée. images : Noms d'images que vous souhaitez ajouter à la déclinaison à générer. Ces images doivent se trouver, depuis la racine de votre application Prestashop, dans un dossier download/import/. Attention, si vous entrez plusieurs images pour une même déclinaison, elles seront toutes sélectionnées, la première sera donc sélectionnée par défaut. attributes (requis) : Liste des attributs propres de cette déclinaison. Les différents attributs sont définis par leurs groupes (devant être préalablement créer) et leur nom ou valeur (les attributs n'existant pas seront créer), et doivent être séparés par des barres verticales. La syntaxe à respecter est donc de la forme : {groupe d'attributs} : {attribut} [ {groupe d'attributs} : {attribut}][ etc...] ou un attribut peut-être : un nom pour désigner l'attribut (ci-dessus : '53/15/15', 'C01 NOIR', etc...) OU, si son groupe d'attributs est un groupe de couleurs l'url d'une image à utiliser comme texture (doit alors mesurer 20px*20px) 6/11

une couleur en notation hexadécimal html à six chiffres (Prestashop ne supportant pas les couleurs hexadécimal à trois chiffres au moment de la rédaction de cette documentation ; par exemple '#a1b2c3', ou '#FFFFFF') quantity : Quantité d'éléments de cette déclinaison en stock. reference : Référence de cette déclinaison de produit. default (requis) : Pour indiquer la déclinaison à utiliser par défaut pour les commande de ce produit (1 pour définir comme déclinaison par défaut, 0 dans l'autre cas). palette : Indiquer ici un groupe d'attributs à utiliser comme palette de couleurs. supplier_reference : Référence du fournisseur. location : Emplacement. ean13 : Code-barres de la déclinaison wholesale_price : Prix d'achat pour cette déclinaison price : Impact sur le prix (en augmentation) weight : Impact sur le poids (en augmentation) Le module d'import gère également la reconnaissance des déclinaisons existantes. Si les attributs de deux déclinaisons pour un même produit sont identique, la procédure d'import considèrera comme étant une seule et même déclinaison, elle mettra donc à jour l'existante plutôt que d'en créer une nouvelle. Dans ce cas, vous recevrez un message sur la page de synchronisation vous indiquant les références des déclinaisons modifiées, en plus du message de confirmation habituel vous indiquant les produit auxquels la procédure a ajouté ou mis à jour des déclinaisons. 5.2 Exports des déclinaisons/attributs ou des produits L'export suit deux procédures distinctes selon le type choisi. L'export des déclinaisons récupère simplement les données correspondantes et les enregistre dans un format identique à celui de l'import, mais sans les images. Le fichier généré est importable par le module de gestion des produits/déclinaisons sur n'importe quelle boutique Prestashop (tous les pré-requis de l'import doivent bien entendu être satisfait au préalable : les groupes d'attributs doivent exister et les produits déclinés également). L'export des produits récupère l'intégralité des données de vos produits et génère un fichier.csv destiné à être importé grâce au module d'import standard de Prestashop, accessible depuis le menu outil import de votre back-office. Pour effectuer rapidement l'import de vos produits : assurez-vous d'avoir installer le module de gestion des produits/déclinaisons sur le site où vous souhaitez réaliser l'import Cliquez sur parcourir, puis sélectionnez le fichier généré par l 'export 7/11

Chargez le fichier S'il était caché, vous devriez voir apparaître le menu suivant. Assurez-vous alors : que le type d'entité sélectionné correspond bien au produit que le fichier sélectionné correspond bien au fichier exporté que le séparateur de champs est bien «;» que le séparateur de champs à valeurs multiples est bien ou «,» selon l'option choisie à l'export que la case Supprimer les produits n'est pas cochée Puis cliquez sur «Etape suivante» pour arriver à l'écran suivant : Si vous avez bien installé le module de gestion des produits/déclinaisons comme conseillé précédemment, vous pourrez chargez la configuration «AuguriaExportedCsv», puis cliquer sur importer les données pour importé ou mettre à jour les produits. Dans le cas contraire, vous pouvez définir vous même votre propre configuration. Le fichier généré par l'export est en effet doté d'une ligne d'en-tête indiquant le type de données contenues dans chaque colonne ces titres correspondent aux différents attributs gérés par l'import standard. Pensez en ce cas à sauter la première ligne (en haut à gauche, indiquez «1»), afin d'ignorer la ligne de titre lors de l'import. Il est possible de cette manière, par exemple, de forcer l'import plutôt que la mise à jour (en sélectionnant «ignorer cette colonne» dans le menu déroulant de la colonne «identifiant», ou encore de rajouter des colonnes avec des données non-supportées par l'export (images, etc...). 8/11

Note à propos des images : Il n'est pas possible d'exporter les images grâce au module de gestion des produits/déclinaisons. En effet, les produit ne comprennent pas les images qui les représentent, mais les url de ces dernière. Exporter les url dans le fichier.csv ne permettrait pas pour autant de les importer ensuite, excepté dans le cas trivial ou l'on importerait les produits dans une boutique... où ils sont déjà. De même pour les déclinaisons. Par conséquent, l'export ne gère pas les images des produits et des déclinaisons. 9/11

6 Solutions aux problèmes 10/11

Problème Après l'import, le module affiche un encart d'erreur indiquant qu'aucune déclinaison n'a été importée. Des déclinaisons ont été accidentellement ajoutés à des produits (la chaine de caractère renseignée dans le champ id_product du fichier.csv était présente dans les noms de plusieurs produits imprévus) J'obtiens systématiquement un message d'erreur indiquant que le fichier n'est pas au format.csv. Solution Assurez-vous que les id de votre fichier.csv correspondent bel et bien à ceux de produits de votre site. Si vous avez entré une chaine de caractère plutôt qu'un id, vérifiez qu'au moins un produit nommé ainsi existe et/ou que la casse est la bonne. En effet, certains serveurs MySQL peuvent ignorer cette dernière et d'autres non, tout dépendant de la configuration de l'hébergeur. Le module vous affiche les produits modifiés après l'import afin de pouvoir les retrouver. Vous pouvez également jeter un œil au dossier imports contenu dans le dossier du module. Il contient tous les imports précédemment réalisés (cf 4.1 Archivage et astuce ). Essayez d'ouvrir votre fichier.csv avec un éditeur de feuille de calcul Open Office ou LibreOffice et demandez à 'conserver le format'; à plus forte raison si vous avez utilisé des utilitaires Microsoft pour éditer ce dernier. En effet, ceux-ci ont tendances à altérer les caractères spéciaux tels que les virgules et les points-virgules, qui sont des caractères structurels des fichiers.csv. 11/11