Module Lot d'images

Lot d'images, ou Import Pictures, est un module complémentaire de l'ERP/CRM Dolibarr, qui permet d'ajouter rapidement plusieurs à images à un produit ou plusieurs produits.

1- Le module Import pictures

Présentation générale, installation, activation

1- Le module Import pictures

1.1- Présentation

1.1.1- Fonctionnalités 

Le module Lot d'images (ou Import pictures) permet d'ajouter en lot des images sur les produits de votre base de donnée Dolibarr via un formulaire simple et rapide, et/ou de réaliser des imports d'image pour vos produits avec des listes csv ou excel, depuis le module outils de Dolibarr.

1.1.2- Cible 

Le module s'adresse à tous les utilisateurs de Dolibarr désirant ajouter plusieurs images à chacun de leurs produits, en réalisant un gain de temps cette opération par rapport au standard de Dolibarr.

1.1.3- Licence 

Tous nos modules sont distribués sur sur notre boutique en ligne et sur le Dolistore sous licence GPL v3. 

1.1.4- Ressources 

1.1.4.1- La présente documentation

Le guide utilisateur est là pour vous accompagner dans l’utilisation de nos modules. Notre module importpictures est simple et facile à utiliser. 

1.1.4.2- Notre site de démonstration

Le module est installé sur notre environnement de démonstration. Connectez-vous avec l’identifiant demo et le mot de passe demo. 

1.1.4.3- Forum sur dolibarr.org

Un post sur le forum de Dolibarr est prévu pour la sortie du module. Nous créons pour chacun de nos modules une discussion sur le forum dolibarr. Ces discussions peuvent contenir de nombreuses informations. Aussi, si vous avez des commentaires et suggestions, pour une réponse plus rapide, il est préférable de continuer sur cette même conversation. 

Note : Le forum est un lieu d'échange autour de l'utilisation et des fonctionnalités de nos modules. En cas de difficultés d'utilisation ou pour toute remontée de bogue, privilégiez notre page de support. Par ailleurs, nous vous remercions de ne pas multiplier les canaux d'échange pour un même sujet.

1- Le module Import pictures

1.2- Avant de commencer

1.2.1- Avertissement

Nous assurons le bon fonctionnement de nos modules sur les environnements natifs de Dolibarr. Nous ne pouvons pas en garantir le bon fonctionnement suite à des modifications effectuées sur les fichiers du noyau de Dolibarr ou en cas d'utilisation d'autres modules additionnels. 

1.2.2- Pré-requis

Le module Import pictures est compatible avec Dolibarr à partir de version la version 16.

1.2.3- Maintenance 

L'achat du module vous donne droit à un an de maintenance corrective. Cette maintenance corrective n'inclut pas d'aide à l'utilisation ou de support utilisateur, mais seulement la correction des bogues, sous réserve de la bonne utilisation du module et dans le cadre de la compatibilité avec la version utilisée de Dolibarr.

1.2.4- Mises à jour 

Les dernières versions de nos modules sont mises à disposition sur le Dolistore et sur la boutique en ligne d'Altairis.

L'accès aux mises à jour de nos modules est gratuit pendant 1 an à compter de leur date d'achat.

Avant toute mise à jour, assurez-vous que le module est officiellement compatible avec la version de Dolibarr sur laquelle vous souhaitez l'installer.

Pour mettre à jour un module, téléchargez-le à nouveau sur le Dolistore ou la boutique en ligne d'Altairis avec l'identifiant utilisé lors de l'achat initial. Nous rendons systématiquement disponibles en téléchargement les dernières versions de nos modules.

Dézippez les fichiers de la dernière version du module dans le répertoire custom de votre environnement et confirmez le remplacement de ceux déjà présents ou déployez-le via l’outil "Déployer un module" de votre Dolibarr.

! Important !

Pour le bon déroulement d'une mise à jour :

- désactivez le module avant de lancer le remplacement de ses fichiers
- ré-activez-le une fois la nouvelle version en place
- vérifiez enfin que de nouveaux paramétrages ne soient pas nécessaires

1- Le module Import pictures

1.3- Mise en route

1.3.1- Procédure d’installation 

Si vous avez accès aux fichiers de votre Dolibarr, dézippez l'archive du module dans le dossier custom de son arborescence.

Sur les versions récentes de Dolibarr, le module zippé peut être installé directement depuis la page :

Accueil > Configuration > Modules/Applications > onglet Déployer un Module Externe.

1.3.2- Activation 

Activez le module en affichant la liste des modules depuis les menus Accueil > Configuration > Modules/Applications > onglet Modules/Applications Installés. Il sera affiché dans le tableau Altairis.

active module.png

1.3.3- Permissions

Une fois le module installé, par défaut, aucune permission n’est activée. Il vous faut positionner correctement les permissions utilisateurs pour ce module.

Vous pouvez autoriser certains utilisateurs à :

  • Consulter les lots d'images
  • Créer/mettre à jour les lots d'images
  • Supprimer les lots d'images

Les permissions sont à activer par l’administrateur depuis Accueil > Utilisateurs&Groupes > Utilisateurs ou Groupes.

1.3.4- Paramétrage 

Ce module ne dispose pas de paramétrage particulier.

2- Utilisation

Grâce à notre module Lots d'images (Import pictures) vous aurez la possibilité d'ajouter de manière rapide des lots d'images à vos produits en une seule fois :
En réalisant un import sur la base d'un fichier (csv ou excel) - méthode 1
Ou via la création de lots d'images pour un produit donné - méthode 2

Simple d'utilisation, vous permettant d’ajouter des liens URL, des photos venant de vos fichiers locaux (provenant de votre ordinateur) ou bien des images se trouvant déjà dans votre arborescence manuelle du Module "Documents" (module natif de votre Dolibarr) ; tout cela dans un seul formulaire.

Vous avez également la possibilité le cas échéant de réaliser un import de vos images via un fichier d'import simple à réaliser. Pratique si vous souhaitez intégrer des images sur un nombre important de produits.

2- Utilisation

2.1- Importer par fichier des images produits

2.1.1- Introduction

Il est possible de réaliser facilement un import de lot d'images pour intégrer des images sur un nombre important de produits, via un fichier csv ou excel.

Note : Le module natif "Import de données" doit être activé, et l'utilisateur doit avoir le droit de faire des imports.

2.1.2- L'import

menu gauche import.png

champs-cibles-lot-d'images.png

Champs cibles

2.1.3- Comment remplir le fichier d'import

Remplissez les colonnes de votre csv ou excel, dont vous aurez téléchargé un modèle d'exemple en amont.

Laisser les colonnes Créé par (user creat), Mis à jour par (user modif), Last main docId import (import key), Ref. et Statut (status, sera mis automatiquement en statut actif) vide qui seront remplis automatiquement à l'import dans la base de données (obligatoire pour réaliser l'import).

Vous n’êtes pas obligé de remplir les colonnes note publique et privée.

Mettez une date de création ou une date de modification s'il s'agit d'un import pour effectuer une mise à jour, la date doit être au format suivant :

Pour insérer le produit (fk_product), vous pouvez :


2- Utilisation

2.2- Créer un nouveau lot d'images produits

2.2.1- Introduction

La deuxième méthode pour ajouter en masse des images à vos produits (la première étant l'import vu au chapitre précédent), est de passer par le menu "Lot d'images" et d'utiliser le formulaire pour créer un objet "lot d'image" dans votre dolibarr. Cet objet "lot d'image" sera relié à un produit, et les images que vous aurez choisies seront importées sur ce produit. 
C'est donc une méthode plus manuelle que l'import - on traite ici un seul produit à la fois - mais plus rapide que d'ajouter les images une par une sur la fiche produit, puisque l'on peut en importer plusieurs d'un seul coup. De plus, vous pouvez très rapidement créer un nouveau lot d'image pour un autre produit, sans avoir à faire une recherche pour le trouver, puis changer d'onglet pour accéder aux fichiers joints.

Grâce à notre module Lots d'images (Import pictures) vous avez la possibilité d'ajouter de manière rapide plusieurs images à vos produits via une des trois méthodes simples, réunies dans un seul formulaire.

2.2.2- Accéder à la création

Dans le menu principal, cliquez sur le menu "Lot d'images".
Pour créer un nouveau lot d'images, vous pouvez soit cliquer sur le sous-menu "Nouveau lot d'image", ou cliquer sur l’icône de droite représentée par un plus+.png.

menu de gauche.png

Menu de gauche

2.2.3- Formulaire de création

Une fois que vous avez choisi de créer un nouveau lot d'images vous arrivez sur un formulaire de création. Chaque champ à remplir est expliqué ci-dessous.

formulaire de création.png

2.2.3.1- Les champs du formulaire en détail

Ici taper les premières lettres ou le nom entier du produit concerné pour voir apparaître une liste de produits correspondant et cliquer sur le bon produit).

Le produit est en gras dans le formulaire, c'est un champ obligatoire.

produit - Copie.png

Le nom que vous souhaitez donner à votre lot d'images.

Indiquez dans ce cadre de saisie les urls vers des images, que vous aviez copié/collé. 
Pour ajouter plusieurs images, allez simplement à la ligne entre chaque url.

url - Copie.png

Cliquer sur le bouton parcourir, choisissez une ou plusieurs images depuis les dossiers de votre ordinateur.

N'oubliez pas de cliquer sur envoyer fichier, cela affichera l'image ou les images dans le bloc de saisie "liste d'urls ou photos ajoutées".

ajout images ordi - Copie.png

Attention : pour utiliser cette fonction, vous devez avoir le module "Document - GED" d'activé, et vous devez avoir auparavant téléversé des images dans le dossier "importpicture" qui se trouve dans l'arborescence manuelle. Voir le chapitre suivant pour les détails de cette opération.

Cliquer sur le bouton select.fichiers. Ici, les dossiers serveurs de votre Dolibarr vont s'afficher. Allez dans le dossier importpictures où vous avez préalablement mis vos images produits et sélectionnez l'image ou les images souhaitée(s).

Vous pouvez également récupérer des images se trouvant dans un autre dossier si il se trouve dans l'arborescence manuelle (voir en dessous pour en savoir plus dans : Des images depuis les documents).

select.fichiers - Copie.png

2.2.3.2- Téléverser des images sur le serveur depuis le module documents (GED/ECM de Dolibarr)

Pour accéder aux Documents téléversés : depuis le menu du haut de votre Dolibarr, cliquer sur Documents.

Le module Documents (GED) de dolibarr doit être activé. N'oubliez pas de donner aux personnes concernées les droits correspondants à l'utilisation de ce module.

Une fois que vous aurez activé le modules Documents/GED, dans l'arborescence manuelle, vous retrouvez le dossier importpictures qui se crée à l'activation du module Import pictures. C'est dans ce dossier que vous pouvez mettre de préférence vos images.

Attention la première fois, vous devriez cliquer sur le bouton de rafraîchissement image.png pour resynchroniser le dossier sur le serveur. Ceci sera explicitement écrit sur votre page.

Vous pouvez également aussi créer d'autres dossiers et sous dossiers dans cette arborescence, qui seront visibles dans l'ajout des images à la création d'un nouveau lot d'images produits.

Note : Tous les dossiers ce trouvant dans l'arborescence automatique ne seront pas visibles lors de la création d'un nouveau lot d'images produits ; vous aurez seulement l'arborescence manuelle disponible lors de la création d'un nouveau lot d'images produits.

2.2.4- Pour finir la création

1. Cliquer sur le bouton créer.
Le lot d'images produits est créé et il est au statut brouillon, cela veut dire que pour le moment les images n'apparaissent pas encore sur le produit.

2. Il vous faut le valider pour que cela apparaisse sur le produit : cliquer sur valider.

2.2.4.1- Taille du fichier trop volumineuse

Il se peut que l'image soit trop volumineuse pour être chargée. Dans se cas un message d'erreur apparaît pour vous l'indiquer.

erreur taille image.png

Vous prouvez y remédier en allant dans :

Depuis le menu du haut.

Accueil > Configuration > Sécurité > Fichiers (Envoyer fichier) > Augmenter la taille maximum des fichiers envoyés

Attention

Il y a une taille limitée pour l’envoi des fichiers se trouvant dans votre configuration PHP, elle est par défaut à 2048 ko.

Vous pouvez donc augmenter la taille des fichiers jusqu'à 2048 ko maximum. Si vous souhaitez l'augmenter plus il vous faudra modifier la configuration de votre PHP.

taille fichieré.png


2- Utilisation

2.3- La liste et suppression en masse des lots d'images produits

2.3.1- Pour accéder à la liste 

Depuis le menu du haut de votre Dolibarr en cliquant sur le module Import pictures (Lots d'images), la liste s'affichera automatiquement.

2.3.2- La liste

Une fois la liste affichée vous retrouvez les éléments suivants :

liste.png

2.3.3- Suppression de masse sur la liste

Il est possible de faire une suppression de masse des éléments de la liste.

Pour cela vous devez cocher le ou les lots d'images que vous souhaitez supprimer définitivement en suivant les étapes ci-après.

Étape 1

Sectionner le ou les lots d'images sur votre droite en cochant la case sur chacune des lignes concernées (1). Une boîte de dialogue va s'afficher au centre de la page et au dessus de la liste (2).

supp mass 1 - Copie.png

Étape 2

Cliquer sur la boite de dialogue et choisissez supprimer.

supp mass 2 - Copie.png

Étape 3

Confirmer votre choix en cliquant sur le bouton confirmer.

supp mass 3 - Copie.png

Étape 4

Confirmer la suppression en choisissant oui ou non puis cliquer sur le bouton valider.

supp mass 4.png

Étape 5

Un message de suppression s'affiche temporairement pour vous indiquer que la suppression à bien été effectuée.

supp mass 5 - Copie.png


2- Utilisation

2.4- Modification d'un lot d'images produits

Pour modifier un lot d'images produits, vous devez aller sur le lot via la liste des lots d’images produits et cliquer sur retour en brouillon.

Cliquez sur modifier.

Effectuez les modifications, enregistrer et n'oubliez pas de cliquer sur valider pour rendre actif et donc visibles l'image ou les images sur le produit concerné.

Étape 1

retour brouillon - Copie.png

Étape 2

modifier - Copie.png

Étape 3

Effectuer la modification et enregistrer.

Étape 4

Valider.

2- Utilisation

2.5- Suppression du lot d'images produits

En statut brouillon ou actif, il est possible de supprimer le lot directement depuis la fiche.

Pour cela :

suppression 1 - Copie.png

2- Utilisation

2.6- Cloner un lot d'images produits

Il est possible depuis la fiche d'un lots d'images de cloner un lot, il sera alors cloné à l'identique.

Pour cela :

clone.png

Note : Vous pouvez modifier le lot cloné pour lui donner par exemple un autre libellé.

3- Pour finir

Question fréquentes, bonnes pratiques 
Licence, crédit et historique des modification

3- Pour finir

3.1- Question fréquentes

3.1.1- Bonnes pratiques

Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.

Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :

      1. désactivez et réactivez le module ;
      2. vérifiez sur le ChangeLog si une nouvelle version a été publiée et sa compatibilité avec votre version de Dolibarr ;
      3. ré-installez/mettez à jour le module ;
      4.  vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée ; le cas échéant, suivez nos préconisations.

Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant notre interface de support.

 Pour plus d’efficacité dans l’étude de votre demande, précisez :

3.1.2- Difficultés rencontrées

Droit d'auteur, licence des images

Rappelez-vous que les images ont des droits d'auteur, une licence autorisant ou non l'utilisation, et dans quel cadre. Vous devez respecter ce cadre. Rapprochez-vous de vos fournisseurs pour pouvoir obtenir simplement et légalement les images de vos produits/services dans votre Dolibarr.

En conséquence, il est possible que des URLs que vous avez indiquées pour le téléchargement ne permettent pas de récupérer l'image. Nous n'y pouvons rien, certains médias sont impossibles à récupérer via le réseau car cela a été conçu spécifiquement comme cela. Assurez-vous que la source des images est disponible pour l'usage que vous souhaitez en faire. 

Autres difficultés

Il n'y a pas d'autre difficulté connue à ce jour.

3- Pour finir

3.2- Informations pratiques

3.2.1- Informations pratiques 

Liens directs

Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous :

Support

Nous assurons la maintenance corrective sur nos modules pendant un an à partir de leur date d'achat. Une interface de support est à votre disposition pour signaler un bug rencontré. 

Pour toute demande d'aide à l'utilisation, veuillez souscrire à l'un de nos forfaits de support.

3.2.2- Crédit et historique des modifications

Pour la présente documentation du module Lot d'images pour Dolibarr : 

Version
Auteurs
Date
Licence
1

Mélina Joum ; Agnès Rambaud - Sarl ALTAIRIS

Janvier 2024 GFDL