|
|
| (33 versions intermédiaires par 2 utilisateurs non affichées) |
| Ligne 5 : |
Ligne 5 : |
| |} | | |} |
|
| |
|
| == Sommaire == | | =Présentation= |
| | Le module se compose de deux fonctionnalités : |
| | * la création et l'utilisation de libellé et de description personnalisées pour les produits |
| | * la création et l'utilisation de template de notes ajoutable simplement aux notes publique et privées native |
| | =Paramétrage= |
| | ==Activation du module== |
|
| |
|
| Ce guide couvre l'utilisation complète du module '''MoreDesc'n Notes''' pour Dolibarr. Vous y trouverez les instructions de configuration, d'utilisation et les bonnes pratiques.
| | {| class="wikitable" |
| | |- style="vertical-align:top;" |
| | | [[File:MoreDesc Para 001.png |700px]] |
| | | Pour Utiliser le module MoreDesc aller dans Accueil> Configuration > Modules/Application<br> |
| | Activer le module MoreDesc. |
| | |} |
| | == Présentation des paramètres du modules== |
| | // une image de l'onglet de paramétrage et une explication pour chacun des paramètrs |
| | == Installation du corechange (version de dolibarr inférieure à 24)== |
| | Pour que les modèles de notes s'affichent, il est nécessaire d'appliquer un corechange pour les versions de Dolibarr inférieure à la V24 |
| | //faire un lien vers la page d'installation expliquant la gestion des corechanges |
| | =Paramètrage des fonctions= |
| | La gestion des deux fonctionnalités s'effectue dans le menu patas tools. Deux menus gauches permettent de gérer les descritions et les notes |
| | == Gestion des descriptions (moredesc)== |
| | === Création === |
| | // affichage de la page de création et explications des principaux paramètres de la page comme |
| | annule/remplace, sélection de l'éléments ou la description est utilisable |
| | === Modification/suppression === |
| | // affichage de la page de modification, précision sur le bouton de suppression |
| | === Listes === |
| | // affichage de la liste des descriptions avec quelques descriptions saisies |
| | ==== Liste des descriptions depuis la fiche société==== |
| | // idem depuis l'onglet dédié de la fiche société |
| | ==== Liste des descriptions depuis la fiche produit==== |
| | // idem depuis l'onglet dédié de la fiche produit |
|
| |
|
| == Paramétrage == | | == Gestion des modèles de notes (morenotes)== |
| | | // affichage de la page de création et explications des principaux paramètres de la page |
| === Accès à la configuration ===
| | === Modification/suppression === |
| | | // affichage de la page de modification, précision sur le bouton de suppression |
| Pour accéder aux paramètres du module MoreDesc :
| | === Liste === |
| | | // affichage de la liste des modèles de notes avec quelques moreNotes saisies |
| # Allez dans '''Administration > Modules/Applications > Modules installés'''
| | =Utilisation des fonctions= |
| # Recherchez '''MoreDesc'n Notes'''
| | == Utilisation des descriptions== |
| # Cliquez sur l'icône '''Paramètres''' (ou icône engrenage)
| | // affichage d'une description (fiche détail) et affichage d'une facture ou autre avec la description et le libellé changé |
| | | == Utilisation des modèles de notes== |
| Vous accédez à la page : '''Configuration du module moreDesc - moredescGeneralSetting'''
| | // affichage des boutons sur la page note d'un élément |
| | |
| === Options disponibles ===
| |
| | |
| ==== Description en HTML ====
| |
| | |
| ; Paramètre : '''Description en HTML'''
| |
| ; Description : La description complémentaire est saisissable en HTML (éditeur wysiwyg)
| |
| ; Par défaut : '''Désactivé'''
| |
| ; Usage :
| |
| * Activez cette option pour pouvoir saisir des descriptions avec mise en forme HTML
| |
| * Utile si vous avez besoin de mettre en gras, italique, listes, etc.
| |
| | |
| ==== Timer sur les notes publiques ====
| |
| | |
| ; Paramètre : '''Timer sur les notes publiques'''
| |
| ; Description : Ajoute un indicateur de temps sur les notes publiques
| |
| ; Par défaut : '''Désactivé'''
| |
| ; Usage :
| |
| * Activez pour afficher le timestamp de création/modification des notes publiques
| |
| * Utile pour tracer l'historique des modifications
| |
| | |
| ==== Timer sur les notes privées ====
| |
| | |
| ; Paramètre : '''Timer sur les notes privées'''
| |
| ; Description : Ajoute un indicateur de temps sur les notes privées
| |
| ; Par défaut : '''Activé'''
| |
| ; Usage :
| |
| * Affiche le timestamp sur chaque note privée
| |
| * Permet de suivre quand chaque note a été créée/modifiée
| |
| | |
| ==== Désactiver le contrôle de version Patas-Monkey ====
| |
| | |
| ; Paramètre : '''Désactiver le contrôle de version Patas-Monkey'''
| |
| ; Description : Permet de ne pas vérifier le contrôle de version sur le site patas-monkey
| |
| ; Par défaut : '''Désactivé'''
| |
| ; Usage :
| |
| * Activez si vous travaillez en mode offline ou sans accès internet
| |
| * Désactivez les vérifications de mise à jour
| |
| | |
| === Enregistrement des paramètres ===
| |
| | |
| Une fois vos paramètres configurés, cliquez sur le bouton '''Enregistrer''' en bas de la page pour appliquer les modifications.
| |
| | |
| == MoreDesc == | |
| | |
| === Présentation ===
| |
| | |
| La section '''MoreDesc''' permet de gérer les '''descriptions personnalisées''' des produits.
| |
| | |
| Chaque description peut être adapée selon :
| |
| * '''Le tiers''' (client ou fournisseur spécifique)
| |
| * '''Le type de document''' (devis, commande, facture, etc.)
| |
| | |
| === Accès au module MoreDesc ===
| |
| | |
| Depuis n'importe où dans Dolibarr, vous accédez à MoreDesc via :
| |
| | |
| * '''Accueil > Espace MoreDesc''' (depuis le tableau de bord)
| |
| * '''Produits > MoreDesc''' (depuis le menu Produits)
| |
| | |
| L'interface vous propose deux actions principales :
| |
| * Liste des Descriptions
| |
| * Nouvelle Description
| |
| | |
| ==== Liste des Descriptions ====
| |
| | |
| === Affichage de la liste ===
| |
| | |
| La page '''Liste des Descriptions''' affiche toutes les descriptions personnalisées existantes dans un tableau avec les colonnes :
| |
| | |
| ; Libellé : Identifiant ou nom du produit
| |
| ; Tiers : Client ou fournisseur associé
| |
| ; Ajoute/Remplace : Mode d'application (ajoute à la description ou remplace)
| |
| ; État : Actif ou archivé
| |
| | |
| === Actions sur une description ===
| |
| | |
| Pour chaque description, vous pouvez :
| |
| | |
| * '''Modifier''' (icône crayon) : Éditer la description existante
| |
| * '''Supprimer''' (icône poubelle) : Supprimer définitivement
| |
| * '''Dupliquer''' : Créer une copie comme base pour une nouvelle description
| |
| | |
| === Filtrer la liste === | |
| | |
| Vous pouvez filtrer la liste par :
| |
| * '''Champ Recherche''' : Recherchez par produit, tiers, etc.
| |
| * '''Nombre d'résultats''' : Limitez le nombre affiché (20, 50, 100, etc.)
| |
| | |
| === Créer une nouvelle description === | |
| | |
| ==== Bouton d'accès ====
| |
| | |
| Depuis la '''Liste des Descriptions''', cliquez sur le bouton '''Nouvelle Description''' ou '''+ Ajouter une description'''.
| |
| | |
| ==== Remplissage du formulaire ====
| |
| | |
| ; Produit : Sélectionnez le produit auquel s'applique cette description
| |
| ; Tiers : (Optionnel) Choisissez un client ou fournisseur spécifique
| |
| ; Mode : Choisissez entre :
| |
| :: '''Ajoute''' : La description s'ajoute à la description générale du produit
| |
| :: '''Remplace''' : La description remplace complètement la description générale
| |
| ; Description : Entrez le texte de la description (HTML si activé en configuration)
| |
| ; État : Marquez comme Actif ou Brouillon
| |
| | |
| ==== Types de documents supportés ====
| |
| | |
| La description peut s'appliquer à différents types de documents :
| |
| * Devis (Propal)
| |
| * Commande client
| |
| * Commande fournisseur
| |
| * Facture client
| |
| * Facture fournisseur
| |
| * Documents génériques
| |
| | |
| ==== Enregistrement ====
| |
| | |
| Cliquez sur '''Enregistrer''' pour créer la description.
| |
| | |
| Un message de confirmation apparaît. La description est dès lors disponible lors de la création de documents.
| |
| | |
| === MoreDesc | Produit & Services ===
| |
| | |
| ==== Accès depuis une fiche produit ====
| |
| | |
| Pour un produit donné, vous pouvez voir ses descriptions personnalisées directement :
| |
| | |
| # Allez dans '''Produits > Liste des produits'''
| |
| # Sélectionnez un produit
| |
| # Cliquez sur l'onglet '''Moredesc''' ou '''Descriptions personnalisées'''
| |
| | |
| Vous verrez un tableau listant toutes les descriptions associées à ce produit.
| |
| | |
| ==== Ajouter une description depuis la fiche produit ====
| |
| | |
| Depuis l'onglet MoreDesc du produit :
| |
| | |
| # Cliquez sur '''+ Nouvelle description pour ce produit'''
| |
| # Remplissez le formulaire (voir ci-dessus)
| |
| # Enregistrez
| |
| | |
| ==== Gestion directe ====
| |
| | |
| Vous pouvez éditer ou supprimer les descriptions directement depuis ce tableau :
| |
| * '''Modifier''' (icône crayon)
| |
| * '''Supprimer''' (icône poubelle)
| |
| | |
| == MoreNotes ==
| |
| | |
| === Présentation ===
| |
| | |
| Le module '''MoreNotes''' permet de gérer une '''bibliothèque de notes prédéfinies'''.
| |
| | |
| Ces notes peuvent être rapidement insérées dans les documents (devis, factures, etc.) pour gagner du temps.
| |
| | |
| === Accès au module MoreNotes ===
| |
| | |
| Vous accédez à MoreNotes via :
| |
| | |
| * '''Accueil > Espace MoreDesc''' > Section '''MoreNotes'''
| |
| * '''Produits > MoreNotes'''
| |
| | |
| L'interface propose :
| |
| * Nouvelle MoreNotes
| |
| * Liste des MoreNotes
| |
| * Import XML
| |
| | |
| ==== Nouvelle MoreNotes ====
| |
| | |
| === Créer une note prédéfinie ===
| |
| | |
| # Cliquez sur '''Nouvelle MoreNotes''' ou '''+ Ajouter une note'''
| |
| # Remplissez les champs :
| |
| | |
| ; Titre : Nom court et mémorable (ex: "Délai de livraison 48h")
| |
| ; Catégorie : Groupez vos notes par thème (ex: "Livraison", "Paiement", "Légal")
| |
| ; Contenu : Le texte complet de la note
| |
| ; État : Marquez comme Actif ou Brouillon
| |
| | |
| === Utiliser HTML ===
| |
| | |
| Si '''Description en HTML''' est activé en configuration, vous pouvez saisir du contenu HTML formaté.
| |
| | |
| === Enregistrement ===
| |
| | |
| Cliquez sur '''Enregistrer''' pour créer la note. Elle devient aussitôt disponible pour utilisation.
| |
| | |
| ==== Liste des MoreNotes ====
| |
| | |
| === Affichage de la liste ===
| |
| | |
| La page '''Liste des MoreNotes''' affiche toutes vos notes prédéfinies dans un tableau :
| |
| | |
| ; Titre : Nom de la note
| |
| ; Catégorie : Regroupement thématique
| |
| ; État : Actif ou brouillon
| |
| ; Actions : Modifier, Supprimer, Dupliquer
| |
| | |
| === Rechercher une note ===
| |
| | |
| Utilisez le champ '''Recherche''' pour trouver une note par titre ou catégorie.
| |
| | |
| === Modifier une note ===
| |
| | |
| # Cliquez sur '''Modifier''' (icône crayon)
| |
| # Apportez vos changements
| |
| # Enregistrez
| |
| | |
| === Dupliquer une note ===
| |
| | |
| # Cliquez sur '''Dupliquer'''
| |
| # Une copie est créée avec le même contenu
| |
| # Vous pouvez immédiatement l'éditer pour l'adapter
| |
| | |
| === Supprimer une note ===
| |
| | |
| # Cliquez sur '''Supprimer''' (icône poubelle)
| |
| # Confirmez la suppression
| |
| # La note est définitivement supprimée
| |
| | |
| === Utiliser une note dans un document ===
| |
| | |
| Lors de la création ou édition d'un document (Devis, Facture, etc.) :
| |
| | |
| # Allez dans la section '''Notes''' du document
| |
| # Cliquez sur '''Notes prédéfinies''' ou '''MoreNotes'''
| |
| # Sélectionnez la note que vous souhaitez insérer
| |
| # Cliquez sur '''Insérer'''
| |
| # La note s'ajoute à votre document
| |
| # Vous pouvez la modifier directement si nécessaire
| |
| | |
| ==== Import XML ====
| |
| | |
| === Fonctionnalité d'import ===
| |
| | |
| L'option '''Import XML''' permet de '''charger en masse plusieurs notes prédéfinies''' depuis un fichier XML.
| |
| | |
| Cette fonctionnalité est utile pour :
| |
| * Migrer des notes depuis un autre système
| |
| * Initialiser une nouvelle installation avec des notes standard
| |
| * Sauvegarder et restaurer votre bibliothèque de notes
| |
| | |
| === Format du fichier XML ===
| |
| | |
| Le fichier XML doit respecter la structure suivante :
| |
| | |
| <nowiki>
| |
| <?xml version="1.0" encoding="UTF-8"?>
| |
| <morenotes>
| |
| <note>
| |
| <titre>Titre de la note</titre>
| |
| <categorie>Catégorie</categorie>
| |
| <contenu>Contenu complet de la note</contenu>
| |
| <etat>1</etat>
| |
| </note>
| |
| <note>
| |
| <titre>Deuxième note</titre>
| |
| <categorie>Catégorie 2</categorie>
| |
| <contenu>Contenu de la deuxième note</contenu>
| |
| <etat>1</etat>
| |
| </note>
| |
| </morenotes>
| |
| </nowiki>
| |
| | |
| ; titre : Nom de la note (obligatoire)
| |
| ; categorie : Catégorie de la note (optionnel)
| |
| ; contenu : Texte complet de la note (obligatoire)
| |
| ; etat : 1 pour Actif, 0 pour Brouillon
| |
| | |
| === Lancer l'import ===
| |
| | |
| # Cliquez sur '''Import XML'''
| |
| # Cliquez sur '''Sélectionner un fichier'''
| |
| # Choisissez votre fichier XML
| |
| # Cliquez sur '''Importer'''
| |
| # Un message confirme le nombre de notes importées
| |
| | |
| === Résultat de l'import === | |
| | |
| * Les notes sont créées avec le statut spécifié dans le XML
| |
| * Les notes existantes avec le même titre ne sont '''pas''' remplacées (pour éviter les pertes)
| |
| * Vous pouvez vérifier les notes importées dans la '''Liste des MoreNotes'''
| |
| | |
| === Export et sauvegarde ===
| |
| | |
| Bien que non explicitement documenté, vous pouvez générer un export XML de vos notes prédéfinies pour sauvegarder votre bibliothèque.
| |
| | |
| Contactez votre administrateur si vous avez besoin d'une sauvegarde complète.
| |
| | |
| == Bonnes pratiques ==
| |
| | |
| === Descriptions personnalisées ===
| |
| | |
| * '''Organiser par tiers''' : Créez des descriptions spécifiques pour vos clients/fournisseurs importants
| |
| * '''Utiliser le mode "Ajoute"''' pour enrichir la description générale
| |
| * '''Tester avant livraison''' : Générez un PDF pour vérifier l'affichage
| |
| * '''Archiver les anciennes''' : Désactivez plutôt que supprimer pour historique
| |
| | |
| === Notes prédéfinies ===
| |
| | |
| * '''Utiliser des catégories cohérentes''' : "Livraison", "Paiement", "Légal", etc.
| |
| * '''Garder les titres courts''' : Facilitent la recherche et la sélection
| |
| * '''Mettre à jour régulièrement''' : Vérifiez que vos CGV et conditions sont à jour
| |
| * '''Tester l'affichage''' : Vérifiez la mise en forme dans les documents générés
| |
| | |
| == Dépannage ==
| |
| | |
| === Les descriptions n'apparaissent pas dans mes documents ===
| |
| | |
| * Vérifiez que la description est '''Actif''' (pas en Brouillon)
| |
| * Vérifiez que le '''Tiers''' correspond (ou laissez vide pour tous)
| |
| * Vérifiez le '''Mode''' : Ajoute/Remplace selon votre attente
| |
| * Régénérez le PDF du document
| |
| | |
| === L'éditeur HTML ne s'affiche pas ===
| |
| | |
| * Allez dans '''Administration > Paramètres > Configuration MoreDesc'''
| |
| * Activez '''Description en HTML'''
| |
| * Enregistrez
| |
| | |
| === Les notes n'apparaissent pas dans la liste ===
| |
| | |
| * Vérifiez le filtre de recherche (peut masquer les résultats)
| |
| * Vérifiez que la note est '''Actif''' et non '''Brouillon'''
| |
| * Augmentez le nombre de résultats affichés
| |
| | |
| === Problème d'import XML ===
| |
| | |
| * Vérifiez l'encodage du fichier (UTF-8)
| |
| * Validez la syntaxe XML (pas d'accents mal échappés)
| |
| * Vérifiez que les champs obligatoires (titre, contenu) sont présents
| |
| * Consultez les logs de Dolibarr pour les erreurs détaillées
| |
| | |
| == Contact et support ==
| |
| | |
| Pour toute question ou problème :
| |
| * Consultez la section '''À propos''' du module
| |
| * Contactez votre administrateur Dolibarr
| |
| * Vérifiez les logs système : '''Administration > Outils > Journaux'''
| |
