« MoreDesc » : différence entre les versions

De Documentations Patas-monkey
Aller à la navigation Aller à la recherche
Liam (discussion | contributions)
Aucun résumé des modifications
Liam (discussion | contributions)
Ligne 31 : Ligne 31 :
   
   
# Allez dans '''Administration > Modules/Applications > Modules installés'''
# Allez dans '''Administration > Modules/Applications > Modules installés'''
# Recherchez '''MoreDesc'n Notes'''
# Recherchez '''MoreDesc'''
# Cliquez sur l'icône '''Paramètres''' (ou icône engrenage)
# Cliquez sur l'icône '''Paramètres''' (ou icône engrenage)
   
   

Version du 12 juin 2026 à 17:07

MoreDesc n' Notes ajoute la possibilité de compléter ou remplacer la description d'un produit selon un tiers spécifique et un ensemble de documents (devis, commande, facture client et fournisseurs). Le module permet aussi de rajouter rapidement des notes prédéfinies.

Sommaire

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.

Paramétrage

Accès à la configuration

Pour accéder aux paramètres du module MoreDesc :

  1. Allez dans Administration > Modules/Applications > Modules installés
  2. Recherchez MoreDesc
  3. Cliquez sur l'icône Paramètres (ou icône engrenage)

Vous accédez à la page : Configuration du module moreDesc - moredescGeneralSetting

---

Accès à la page de configuration

Pour accéder aux paramètres du module MoreDesc :

  1. Allez dans Administration > Modules/Applications > Modules installés
  2. Recherchez MoreDesc
  3. Cliquez sur l'icône Paramètres (ou icône engrenage)

Vous accédez à la page : Configuration du module moreDesc - moredescGeneralSetting

Cette page centralise tous les réglages du module.

Espace MoreDesc - Navigation

Page de configuration du module

Explications des paramètres

Description en HTML

  • Saisissable en HTML (wysiwyg) - Désactivé par défaut
  • Activez pour mise en forme (gras, italique, listes, etc.)

Timer sur les notes publiques

  • Affiche timestamp sur notes publiques - Désactivé par défaut
  • Tracer l'historique des modifications

Timer sur les notes privées

  • Affiche timestamp sur notes privées - Activé par défaut
  • Suivi des dates de création/modification

Désactiver le contrôle Patas-Monkey

  • N'vérifie pas la version en ligne - Désactivé par défaut
  • Utile pour mode offline

Enregistrement : 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 :

  1. Allez dans Produits > Liste des produits
  2. Sélectionnez un produit
  3. 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 :

  1. Cliquez sur + Nouvelle description pour ce produit
  2. Remplissez le formulaire (voir ci-dessus)
  3. 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

  1. Cliquez sur Nouvelle MoreNotes ou + Ajouter une note
  2. 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

  1. Cliquez sur Modifier (icône crayon)
  2. Apportez vos changements
  3. Enregistrez

Dupliquer une note

  1. Cliquez sur Dupliquer
  2. Une copie est créée avec le même contenu
  3. Vous pouvez immédiatement l'éditer pour l'adapter

Supprimer une note

  1. Cliquez sur Supprimer (icône poubelle)
  2. Confirmez la suppression
  3. 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.) :

  1. Allez dans la section Notes du document
  2. Cliquez sur Notes prédéfinies ou MoreNotes
  3. Sélectionnez la note que vous souhaitez insérer
  4. Cliquez sur Insérer
  5. La note s'ajoute à votre document
  6. 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 :

<?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>

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

  1. Cliquez sur Import XML
  2. Cliquez sur Sélectionner un fichier
  3. Choisissez votre fichier XML
  4. Cliquez sur Importer
  5. 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