« MoreDesc » : différence entre les versions

De Documentations Patas-monkey
Aller à la navigation Aller à la recherche
Liam (discussion | contributions)
Aucun résumé des modifications
 
(23 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;"  
== Paramétrage ==
| [[File:MoreDesc Para 001.png |700px]]
 
| Pour Utiliser le module MoreDesc aller dans Accueil> Configuration > Modules/Application<br>
=== Accès à la configuration ===
Activer le module MoreDesc.
 
{| class="wikitable" style="width: 100%; border-collapse: collapse;"
|-
! colspan="3" style="text-align: center; background-color: #f0f0f0; padding: 10px;" | Accès à la page de configuration
|-
| style="width: 40%; vertical-align: top; padding: 15px;" |
Pour accéder aux paramètres du module MoreDesc :
# Allez dans '''Administration > Modules/Applications > Modules installés'''
# Recherchez '''MoreDesc'''
# 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.
| style="width: 30%; vertical-align: top; padding: 10px; text-align: center;" |
[[Fichier:CleanShot_2026-06-12_at_16_33_47.png|280px|Espace MoreDesc - Navigation]]
| style="width: 30%; vertical-align: top; padding: 10px; text-align: center;" |
[[Fichier:CleanShot_2026-06-12_at_16_30_59.png|280px|Page de configuration du module]]
|-
! colspan="3" style="text-align: center; background-color: #e8e8e8; padding: 10px;" | Explications des paramètres
|-
| colspan="3" style="padding: 10px; vertical-align: top;" |
{| style="width: 100%; border: none; margin: 0;"
|-
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' 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
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' 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 ==
 
{| class="wikitable" style="width: 100%; border-collapse: collapse;"
|-
! colspan="3" style="text-align: center; background-color: #f0f0f0; padding: 10px;" | Présentation et Accès au module MoreDesc
|-
| style="width: 40%; padding: 10px; vertical-align: top;" |
La section '''MoreDesc''' permet de gérer les '''descriptions personnalisées''' des produits.
Chaque description s'adapte selon :
* '''Le tiers''' (client/fournisseur)
* '''Le type de document''' (devis, commande, facture, etc.)
'''Accès au module :'''
* '''Outils Patas-M > MoreDesc'''
* '''Produits > MoreDesc''' (fiche)
| style="width: 30%; padding: 10px; vertical-align: top;" |
'''Actions principales :'''
* Liste des Descriptions
* Nouvelle Description
'''Depuis fiche produit :'''
* Onglet '''Moredesc'''
* Ajouter directement au produit
| style="width: 30%; padding: 10px; vertical-align: top;" |
[[Fichier:CleanShot_2026-06-12_at_16_34_53.png|250px|Onglet MoreDesc sur fiche produit]]
|-
! colspan="3" style="text-align: center; background-color: #e8e8e8; padding: 10px;" | Liste des Descriptions - Colonnes et Actions
|-
| colspan="3" style="padding: 10px; vertical-align: top;" |
{| style="width: 100%; border: none; margin: 0;"
|-
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' Colonnes du tableau '''
* '''Libellé''' : Nom du produit
* '''Tiers''' : Client/Fournisseur
* '''Ajoute/Remplace''' : Mode d'application
* '''État''' : Actif/Archivé
''' Filtrer la liste '''
* Recherche (par produit/tiers)
* Nombre d'résultats (20, 50, 100...)
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' Actions par description '''
* '''✎ Modifier''' : Éditer
* '''🗑 Supprimer''' : Supprimer
* '''⋯ Dupliquer''' : Copier
|}
|-
! colspan="3" style="text-align: center; background-color: #e8e8e8; padding: 10px;" | Créer une Nouvelle Description
|-
| colspan="3" style="padding: 10px; vertical-align: top;" |
{| style="width: 100%; border: none; margin: 0;"
|-
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' Formulaire '''
* '''Produit''' : Sélectionnez
* '''Tiers''' : Client/Fournisseur (opt.)
* '''Mode''' : Ajoute OU Remplace
* '''Description''' : Texte/HTML
* '''État''' : Actif ou Brouillon
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' Types de documents '''
* Devis (Propal)
* Commande client/fournisseur
* Facture client/fournisseur
* Documents génériques
''' Enregistrement '''
Cliquez '''Enregistrer''' pour créer.
|}
|-
! colspan="3" style="text-align: center; background-color: #e8e8e8; padding: 10px;" | MoreDesc depuis Fiche Produit/Service
|-
| colspan="3" style="padding: 10px; vertical-align: top;" |
{| style="width: 100%; border: none; margin: 0;"
|-
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' Voir les descriptions '''
# Allez dans '''Produits > Liste'''
# Sélectionnez un produit
# Cliquez onglet '''Moredesc'''
| style="width: 50%; padding: 10px; vertical-align: top;" |
''' Ajouter depuis fiche '''
# Cliquez '''+ Nouvelle description'''
# Remplissez le formulaire
# '''Enregistrez''' - directement attaché
''' Gestion directe '''
* '''✎ Modifier''' | '''🗑 Supprimer'''
|}
|}
|}
== 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


== MoreNotes ==
== Gestion des modèles de notes (morenotes)==
 
// affichage de la page de création et explications des principaux paramètres de la page
=== Présentation ===
=== Modification/suppression ===
 
// affichage de la page de modification, précision sur le bouton de suppression
Le module '''MoreNotes''' permet de gérer une '''bibliothèque de notes prédéfinies'''.
=== Liste ===
 
// affichage de la liste des modèles de notes avec quelques moreNotes saisies
Ces notes peuvent être rapidement insérées dans les documents (devis, factures, etc.) pour gagner du temps.
=Utilisation des fonctions=
 
== Utilisation des descriptions==
=== Accès au module MoreNotes ===
// 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 à MoreNotes via :
// affichage des boutons sur la page note d'un élément
 
* '''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'''

Dernière version du 13 juin 2026 à 16:32

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.

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

Pour Utiliser le module MoreDesc aller dans Accueil> Configuration > Modules/Application

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

Gestion des modèles de notes (morenotes)

// affichage de la page de création et explications des principaux paramètres de la page

Modification/suppression

// affichage de la page de modification, précision sur le bouton de suppression

Liste

// affichage de la liste des modèles de notes avec quelques moreNotes saisies

Utilisation des fonctions

Utilisation des descriptions

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

// affichage des boutons sur la page note d'un élément