IMPORTATION ARTICLES DANS LA BASE DE DONNEES PRINCIPE À qui s adresse ce document? Pour permettre l accès à vos articles dans votre boutique, vous devez les ajouter dans une base de données. Ce document est destiné aux marchands ayant une liste de produits organisée (dans Excel ou dans une base de données par exemple) pour l'importer directement dans la base de données de la boutique. Ceci évite donc d'avoir à saisir une autre fois les données concernant les articles. Cependant, le fichier importé doit être minutieusement préparé, formaté et ordonné selon un standard prédéfini au format texte délimité par des tabulations (tab). Vous trouverez dans ce document l'ordre des champs utilisés dans la boutique ainsi que leur signification. Préparer ce fichier vous soulagera d un lourd travail de saisie. Plus il sera complet et plus l intégration de vos articles sera efficace. Étant donné que le fichier importé ne passe par aucun des contrôles intégrés dans la partie administration de la boutique, nous vous recommandons la plus grande rigueur en prenant un soin particulier à la réalisation de ce fichier essentiel. Le fichier doit être en format : txt. Par exemple : items.txt. Le fichier utilise une tabulation comme séparateur, avec 1 article par ligne. Les guillemets simples ( ) sont interdits. Le fichier contient plusieurs types d informations. Lisez et respectez attentivement la description de chaque champ. Voir «Explication champs Excel» plus bas dans ce document. MÉTHODE #1 Ouvrir admin/import/articles/import_items.txt dans Excel. Séparateur : tab Le titre de chaque colonne s affichera comme ci-dessous. Voir les spécifications de chaque colonne dans «EXPLICATIONS CHAMPS EXCEL» plus bas dans ce document. Cet ordre ne doit pas être modifié. Dans Excel, organisez et ordonnez vos données dans l ordre exact des titres des colonnes comme ci-dessous. BoutikOne - Page 1 de 8
Assurez-vous ce qui suit : 1. La table 'products' de la base de données de destination soit vide.. 2. Chaque colonne de votre feuille Excel correspond à un champ et chaque ligne à 1 enregistrement. 3. Les colonnes de la table soient dans le même ordre et en nombre identique que ceux de la table de destination. 4. La feuille Excel ne contient que des données (pas d'entête ou de titre). 5. Les données dans les cellules de votre tableur Excel n'incluent pas de tabulations. 6. Les données dans les cellules de votre tableur Excel n'incluent pas de ' (guillemets simples). Une fois terminée, supprimez la ligne 1 (dans Excel) contenant le titre des colonnes puis sauvegardez le fichier sous items.txt (tab séparateur) dans le dossier admin/import/articles. Ouvrez le fichier items.txt sauvegardé et assurez-vous ce qui suit : 1. Chaque ligne correspond à 1 article. 2. Les tabulations dans vos textes ont été supprimées. 3. Les ' (guillemets simples) ont été supprimé. 4. Le signe plus (+) est interdit dans la référence et le nom de l article. 5. Les virgules (,) sont interdites dans le nom de l article. 6. Le fichier txt ne contient que des données. Ci-dessous un exemple de fichier. Rendez-vous sur http://url_de_votre_boutique/admin/import/articles/index.php ou connectez-vous à la partie administration de la boutique, puis aller à Divers > Importer articles. Si l importation s effectue en ligne, ajoutez le fichier items.txt dans le dossier admin/import/articles de votre boutique puis assurez-vous que CHMOD du fichier items.txt = 666. Nom de la base/database name : Nom de la base de données qui a été crée. Nom de la table : products Fichier à importer : items.txt (Si vous avez suivi les instructions ci-dessus). Si votre fichier est correctement formaté et que vous avez bien suivi les instructions de ce document, vos articles seront enregistrés dans la base de données de votre boutique. Le fichier txt généré est de la plus grande importance. Prenez un soin particulier à la réalisation de ce fichier. BoutikOne - Page 2 de 8
MÉTHODE #2 Même procédure de création du fichier items.txt puis : Allez dans phpmyadmin en local. Sélectionnez la base de données de votre boutique. Cliquez sur la table products. Cliquez sur «Insérer des données provenant d un fichier texte dans la table» (En bas de page). Emplacement du fichier texte: Allez chercher items.txt sur votre disque dur. Remplacer les données de la table avec le fichier: Cliquez sur Remplacer Champs terminés par: Entrez : \t Champs entourés par: Laissez vide. Lignes terminées par: Entrez \r\n Méthode pour le LOAD DATA LOCAL Cliquez sur Exécuter. Si votre fichier est correctement formaté et que vous avez bien suivi les instructions de ce document, vos articles sont enregistrés dans la base de données de votre boutique. BoutikOne - Page 3 de 8
EXPLICATIONS CHAMPS EXCEL products_id : Obligatoire. ID unique de l article. Numérique. categories_id: Obligatoire. ID de la sous-catégorie. Tous vos articles doivent être importé dans une sous-catégorie. Numérique. categories_id_bis: Id des sous-catégories secondaires encadrées par. Si vous souhaitez l affichage de votre article dans d'autres sous-catégories. Syntaxe 1 sous-catégorie secondaire: 7 Syntaxe plusieurs sous-catégories secondaires: 7 8 25 fournisseurs_id: Obligatoire. Id du fournisseur. Numérique. afficher_fournisseur: Affichage du fournisseur sur la page description et l article. Valeur: yes ou no. fabricant_id: Obligatoire. Id du fabricant. Numérique. afficher_fabricant: Affichage du fabricant sur la page description et l article. Valeur: yes ou no. products_name_1: Obligatoire. Nom de l article langue 1. Html conseillé ou texte. products_name_2: Nom de l article langue 2. Html conseillé ou texte. products_name_3: Nom de l article langue 3. Html conseillé ou texte. products_desc_1: (Description courte Voir products_note_1 pour description longue) Description de l article langue 1. Html conseillé ou texte. products_desc_2: (Description courte - Voir products_note_2 pour description longue) Description de l article langue 2. Html conseillé ou texte. products_desc_3: (Description courte - Voir products_note_3 pour description longue) Description de l article langue 3. Html conseillé ou texte. products_garantie_1: Note sur la garantie de l article langue 1. Html conseillé ou texte. products_garantie_2: Note sur la garantie de l article langue 2. Html conseillé ou texte. products_garantie_3: Note sur la garantie de l article langue 3. Html conseillé ou texte. products_price: Obligatoire. Prix de l article. Numérique. Les valeurs décimales (2 chiffres) sont précédées par un point. Exemple 1 : 9.75 Exemple 2 : 0.50 products_lot_num: Quantité vendu pour gagner la récompense. Entier numérique. Exemple: 6 products_weight: Poid de l article. Valeur en grammes. Numérique. Si article en téléchargement, saisir 0. products_options: Valeurs: yes ou no. Valeur par défaut: no. Les options seront saisies manuellement dans l admin > Ajouter options après l importation de vos articles. products_option_note_1: Note sur les options de l article langue 1. Html conseillé ou texte. products_option_note_2: Note sur les options de l article langue 2. Html conseillé ou texte. products_option_note_3: Note sur les options de l article langue 3. Html conseillé ou texte. products_ref: Obligatoire. Référence unique de l article. 255 caractères max. Les doublons ne sont pas acceptés. Exemple : FGF-2544/H products_im: Afficher image. Valeur : yes ou no. Valeur par défaut: yes. Saisir no si vous ne souhaitez pas l affichage d une image pour cet article. products_image: Image principale de l article. Laissez vide si pas d image. Exemple : im/articles/monimage.gif products_image2: Image secondaire #1. Miniature qui s affichera en complément de l image principale. BoutikOne - Page 4 de 8
Laissez vide si pas d image. Exemple : im/articles/monimage1.gif. products_image3: Image secondaire #2. Miniature qui s affichera en complément de l image principale. Laissez vide si pas d image. Exemple : im/articles/monimage2.gif. products_image4: Image secondaire #3. Miniature qui s affichera en complément de l image principale. Laissez vide si pas d image. Exemple : im/articles/monimage3.gif. products_image5: Image secondaire #4. Miniature qui s affichera en complément de l image principale. Laissez vide si pas d image. Exemple : im/articles/monimage4.gif. products_note_1: (Description longue - Voir products_desc_1 pour description courte) Note sur l article langue 1. Html conseillé ou texte. products_note_2: (Description longue - Voir products_desc_2 pour description courte) Note sur l article langue 2. Html conseillé ou texte. products_note_3: (Description longue - Voir products_desc_3 pour description courte) Note sur l article langue 3. Html conseillé ou texte. products_visible: Article visible dans votre boutique. Valeur : yes ou no. Valeur par défaut: yes. products_tax: Article taxable. Valeur : yes ou no. Valeur par défaut: yes. products_tax: Montant de la taxe. Numérique. Les valeurs décimales (2 chiffres) sont précédées par un point. Exemple 1 : 19.75 Exemple 2 : 5.5 Le montant de la taxe à appliquer étant lié au lieu d expédition, laissez vide si le montant de la taxe sur cet article est différent de la taxe locale définit par défaut dans admin > Zone livraison et taxes. products_date_added: Obligatoire. Par défaut: date du jour de la saisie de l article. Format : A-M-J H:M:S Exemple : 2003-01-14 15:04:57 Respectez fidèlement le format ci-dessus. products_viewed: Nombre de fois cet article à été vu dans votre boutique. Par défaut: 0. products_added: Nombre de fois cet article à été ajouté au caddie dans votre boutique. Par défaut: 0. products_qt: Quantité d article en stock. Numérique. Pour les produits virtuels (ou en téléchargement), saisir une grande quantité. 11 chiffres max. Ex : 100000000. products_download: Article en téléchargement. Valeur: yes ou no. Valeur par défaut: no. products_download_name: URL en ligne de l article en téléchargement si products_download est yes. Exemple : http://www.toto.com/files/prod_name.zip products_related: Produits affiliés. Ils s afficheront sur la page description de l article. Format : id de l article séparé par Exemple 1 : 30 Exemple 2 : 30 22 125 Respectez fidèlement le format ci-dessus. Laissez vide si aucun article n est affilié à cet article. Vous pourrez toujours les ajouter plus tard dans l admin. products_exclusive: Article figurant dans vos «Coup de cœur». Valeur: yes ou no. Valeur par défaut: no. products_sold: Quantité d article vendu. Par défaut: 0. products_dee : Montant de la taxe DEEE pour le recyclage des produits électriques et électronique. Champ numérique (Ex : 0.75). Par défaut 0.00. products_ean : EAN (code barre), MPN (Manufacturer Product Number), ISBN (International Standard Book Number). 30 caractéres max. products_sup_shipping : Supplément d emballage. Champ numérique (Ex: 1.00). BoutikOne - Page 5 de 8
Par défaut 0.00 products_caddie_display : Articles de la page caddie (Cadeau - Articles périphérique, etc...). Valeur : yes ou no Valeur par défaut: no. products_forsale : Article en vente Valeur : yes ou no Valeur par défaut : yes products_delay_1 : Obligatoire - Jour1 - Délai d expédition minimum si article disponible (ou en stock). products_delay_2 : Obligatoire - Jour 2 - Délai d expédition maximum si article disponible (article en stock). products_delay_1a : Obligatoire - Jour 1 Délai d expédition minimum si article non disponible avec option d achat désactivé (Article en commande). products_delay_2a : Obligatoire - Jour2 Délai d expédition maximum si article non disponible avec option d achat désactivé (Article en commande). products_delay_1b : Obligatoire - Jour1 - Délai d expédition minimum si article non disponible avec option d achat activé (Article sur commande). products_delay_2b : Obligatoire - Jour2 - Délai d expédition maximum si article non disponible avec option d achat activé (Article sur commande). Exemple : Si products_delay_1 = 1 et products_delay_2 = 2, le délai d expédition de l article disponible sera entre 1 et 2 jours. La boutique affichera : «Délai d expédition : Entre 1 et 2 jour(s) ouvré(s).» Si products_delay_1 = 0 et products_delay_2 = 2, l article disponible sera expédié le jour même. La boutique affichera : «Délai d expédition : Sous 48H.» products_meta_title_1 : Meta tag title Fr. Format : 100 caractères maximum - Texte. HTML interdit. products_meta_title_2 : Meta tag title En. Format : 100 caractères maximum - Texte. HTML interdit. products_meta_title_3 : Meta tag title Es. Format : 100 caractères maximum - Texte. HTML interdit. products_meta_description_1 : Meta tag description Fr. Format : 200 caractères maximum - Texte. HTML interdit. products_meta_description_2 : Meta tag description En. Format : 200 caractères maximum - Texte. HTML interdit. products_meta_description_3 : Meta tag description Es. Format : 200 caractères maximum - Texte. HTML interdit. products_attached : URL complet du fichier attaché à un article (Manuel, doc technique, etc.). Ex : http://www.myshop.com/download/files/manual.zip Format : 255 caractères maximum Fichiers acceptés : zip, txt, pdf. products_sendfile : Article nécessitant l'envoi de fichiers. Valeur : yes ou no Valeur par défaut : no products_won : Montant de la récompense. Numérique. Les valeurs décimales (2 chiffres) sont précédées par un point. Exemple 1 : 20.00 Exemple 2 : 5.50 products_alternative_prizes : Montant compensatoire. Format: [Quantité vendu]:[montant de la récompense compensatoire en Euros] Séparateur: Exemple: 5:10 8:15 15:20 Laisser vide si pas de montants compensatoires. products_ref_man: Référence fabricant de l article. 255 caractères max. Les doublons ne sont pas acceptés. BoutikOne - Page 6 de 8
ORDRE DES CHAMPS DE LA BDD OU DES COLONNES DANS EXCEL Respectez précisément l ordre des colonnes comme ci-dessous : products_id categories_id categories_id_bis fournisseurs_id afficher_fournisseur fabricant_id afficher_fabricant products_name_1 products_name_2 products_name_3 products_desc_1 products_desc_2 products_desc_3 products_garantie_1 products_garantie_2 products_garantie_3 products_price products_weight products_options products_option_note_1 products_option_note_2 products_option_note_3 products_ref products_im products_image products_image2 products_image3 products_image4 products_image5 products_note_1 products_note_2 products_note_3 products_visible products_taxable products_tax products_date_added products_viewed products_added products_qt products_download products_download_name products_related products_exclusive products_sold products_deee products_ean products_sup_shipping products_caddie_display products_forsale products_delay_1 products_delay_2 products_delay_1a products_delay_2a products_delay_1b products_delay_2b products_meta_title_1 products_meta_title_2 products_meta_title_3 products_meta_description_1 products_meta_description_2 products_meta_description_3 BoutikOne - Page 7 de 8
products_attached products_sendfile products_lot_num products_won products_alternative_prizes products_ref_man AVANT IMPORTATION DE VOS ARTICLES - Ajoutez les catégories/sous-catégories. - Ajoutez fournisseurs & fabricants. - Collez ou déplacez les images dans le répertoire im/articles. APRÉS IMPORTATION DE VOS ARTICLES - Ajoutez manuellement les options sur les articles importés. BoutikOne - Page 8 de 8