Documentations Patas-monkey - Contributions [fr]

MyBroadcast/fr

2025-11-12T17:19:09Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:mybroadcast250x250.png]]
| Ce module permet de générer des fichiers logistiques depuis les divers éléménts de dolibarr (proposition, commande, facture, ...) et de les transférer par mail ou ftp
|}

== Présentation ==
myBroadcast permet d'ajouter un bouton sur les éléments de dolibarr qui génère un fichier csv et de le transmettre ensuite par mail ou ftp.

[[File:mybroadcast_sendbroadcast_button.png |300px]]

La liste des pièces où mybroadcast ajoute un bouton est la suivante
{| class="wikitable"
|- style="vertical-align:top;"
|
* proposition commerciale
* Commande Client
* Facture Client
* Expédition Client
* Commande Fournisseur
* Facture Fournisseur
* Fiche de fabrication (OF de Factory)
| Cette liste peu être plus restreinte si certains modules ne sont pas activé (Factory étant un module supplémentaire).
Dans certains cas, il est possible de préciser l'entrepôt ou s'effectue la génération mais ce n'est pas obligatoire.
|}

== Paramétrage ==
L'essentiel du paramétrage du module s'effectue au niveau de l'écran de paramétrage du module accessible en bout de ligne

[[File:mybroadcast_setting_module.png |700px]]
Il y 3 étapes à réaliser
=== Sélection de l'éléments ou utiliser le broadcast ===
La première étape de paramétrage est de sélectionner l'élément sur lequel on souhaite ajouter le bouton d'envoie
Tant que l'on a pas sélectionné l'élément, le reste du paramétrage ne sera pas accessible
Une fois sélectionné le reste des champs de paramétrage apparaissent. Si il y a une une saisie auparavant elle est affichée.

[[File:mybroadcast_element_list.png |600px]]

=== Définition des données à transmettre ===

[[File:mybroadcast_setting_genfile.png |700px]]

Il est possible de conserver la date de génération du broadcast dans un extrafields de type date de l'élément. Pour cela il faut sélectionner le champs dans le paramétrage.

=== Définition des paramètres d'envois ===

[[File:mybroadcast_setting_ftp.png |700px]]

[[File:mybroadcast_setting_email.png |700px]]

== Utilisation avec myList ==

[[File:mybroadcast_setting_mylist.png |700px]]

== Mémorisation d'un évènement MyBroadcast ==

Dans le paramétrage du module, il est possible de d'activer la création d'un évènement à chaque envoie

[[File:mybroadcast_setting_event.png |700px]]

Translations:MyBroadcast/18/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

[[File:mybroadcast_setting_event.png |700px]]

Translations:MyBroadcast/17/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Dans le paramétrage du module, il est possible de d'activer la création d'un évènement à chaque envoie

Translations:MyBroadcast/16/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

== Mémorisation d'un évènement MyBroadcast ==

Translations:MyBroadcast/15/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

[[File:mybroadcast_setting_mylist.png |700px]]

Translations:MyBroadcast/14/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

== Utilisation avec myList ==

Translations:MyBroadcast/13/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

[[File:mybroadcast_setting_email.png |700px]]

Translations:MyBroadcast/12/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

[[File:mybroadcast_setting_ftp.png |700px]]

Translations:MyBroadcast/11/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

=== Définition des paramètres d'envois ===

Translations:MyBroadcast/10/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Il est possible de conserver la date de génération du broadcast dans un extrafields de type date de l'élément. Pour cela il faut sélectionner le champs dans le paramétrage.

Translations:MyBroadcast/9/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

[[File:mybroadcast_setting_genfile.png |700px]]

Translations:MyBroadcast/8/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

=== Définition des données à transmettre ===

Translations:MyBroadcast/7/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

[[File:mybroadcast_element_list.png |600px]]

Translations:MyBroadcast/6/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

[[File:mybroadcast_setting_module.png |700px]]
Il y 3 étapes à réaliser
=== Sélection de l'éléments ou utiliser le broadcast ===
La première étape de paramétrage est de sélectionner l'élément sur lequel on souhaite ajouter le bouton d'envoie
Tant que l'on a pas sélectionné l'élément, le reste du paramétrage ne sera pas accessible
Une fois sélectionné le reste des champs de paramétrage apparaissent. Si il y a une une saisie auparavant elle est affichée.

Translations:MyBroadcast/5/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

== Paramétrage ==
L'essentiel du paramétrage du module s'effectue au niveau de l'écran de paramétrage du module accessible en bout de ligne

Translations:MyBroadcast/4/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

La liste des pièces où mybroadcast ajoute un bouton est la suivante
{| class="wikitable"
|- style="vertical-align:top;"
|
* proposition commerciale
* Commande Client
* Facture Client
* Expédition Client
* Commande Fournisseur
* Facture Fournisseur
* Fiche de fabrication (OF de Factory)
| Cette liste peu être plus restreinte si certains modules ne sont pas activé (Factory étant un module supplémentaire).
Dans certains cas, il est possible de préciser l'entrepôt ou s'effectue la génération mais ce n'est pas obligatoire.
|}

Translations:MyBroadcast/3/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

[[File:mybroadcast_sendbroadcast_button.png |300px]]

Translations:MyBroadcast/2/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

== Présentation ==
myBroadcast permet d'ajouter un bouton sur les éléments de dolibarr qui génère un fichier csv et de le transmettre ensuite par mail ou ftp.

Translations:MyBroadcast/1/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:mybroadcast250x250.png]]
| Ce module permet de générer des fichiers logistiques depuis les divers éléménts de dolibarr (proposition, commande, facture, ...) et de les transférer par mail ou ftp
|}

Translations:MyBroadcast/Page display title/fr

2025-11-12T17:19:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

MyBroadcast

Extraexpense/fr

2025-11-12T14:08:44Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:ExtraExpense-250x250.png]]
|ExtraExpense permet de saisir les notes de frais sans avoir à sélectionner un taux de TVA fixe.

On sélectionne le taux de TVA à 0% et il devient possible de saisir à la fois le montant HT et TTC et de déterminer ainsi la TVA par soustraction.

Cela permet de saisir par exemple des notes de restaurant contenant plusieurs taux de TVA ou une facture provenant d'un autre pays.
|}

== Configuration ==

Dans le paramétrage du module vous aurez la possibilité de choisir plusieurs mode de fonctionnement :

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | [[File:ExtraExpense_parametrage.png |600px]]
|
* Désactiver : le module n'est pas actif, la gestion de la TVA des notes de frais fonctionne par défaut
* Active - si sélection TVA à zéro : le module est active et permet de saisir le TTC et le HT si la TVA est à zéro
* Active - TVA à zéro par défaut : idem que précédemment, mais le taux de TVA à zéro est présélectionné
* Active - sans saisie de la TVA : La sélection de la TVA est supprimée et l'on fonctionne en saisie de TTC et HT obligatoirement

|}

== Utilisation & Fonctionnalités ==

Lors de la création ou de l’édition d’une note de frais (via le formulaire de gestion des notes de frais), la '''gestion des taux de TVA''' est automatiquement prise en charge afin d’éviter toute erreur de calcul.

=== Fonctionnement de base ===

'''Gestion du taux de TVA''' :
Lorsque vous modifiez le taux de TVA d’une ligne, un mécanisme interne désactive les événements clavier sur les champs de prix afin '''d’empêcher la saisie simultanée''' des valeurs '''HT''' et '''TTC'''.

Cela garantit la cohérence des calculs et évite les erreurs de saisie.

'''Exemple concret :'''
Si vous modifiez le taux de TVA d’une ligne (par exemple de '''0 %''' à '''20 %''' ou autre), les champs '''Prix HT''' et '''Prix TTC''' seront automatiquement liés.

L’un des deux champs sera désactivé pour empêcher toute double saisie.

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction basique
[[File:ExtraExpense_fonction_sans_extraexpense_001.png |300px]]

[[File:ExtraExpense_fonction_sans_extraexpense_result_001.png |300px]]
|
* Si '''TVA = 20 %''' et que le '''Prix HT = 100 €''', vous ne pourrez pas remplir la case '''TTC'''.
La case '''TTC''' sera automatiquement calculée lors de la '''validation de la ligne'''.
|}

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction basique
[[File:ExtraExpense_fonction_sans_extraexpense_002.png |300px]]

[[File:ExtraExpense_fonction_sans_extraexpense_result_002.png |300px]]
|
* Si '''TVA = 10 %''' et que le '''Prix TTC = 220 €''', vous ne pourrez pas remplir la case '''HT'''.
La case '''HT''' sera automatiquement calculée lors de la '''validation de la ligne'''.
|}

=== Fonctionnalité avec ExtraExpense ===

Avec le module '''ExtraExpense''', lorsque le taux de '''TVA = 0 %''', vous pouvez tout de même saisir un prix en '''HT''' et en '''TTC''', sans que l’un des deux champs soit bloqué lorsque l’autre est renseigné.

'''Exemple :'''

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Fonction avec ExtraExpense
[[File:ExtraExpense_fonction_avec_extraexpense.png |300px]]

[[File:ExtraExpense_fonction_avec_extraexpense_result.png |300px]]
|
Si '''TVA = 0 %''' et que le '''Prix HT = 50 €''', vous pouvez également saisir la case '''TTC''' avec un autre montant.

Le montant de la TVA est déterminé à partir de la différence des deux montants (ici 30€ soit un taux de 60% de TVA)
|}

=== Validité de la ligne ===

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Prise en compte de la ligne ExtraExpense
[[File:ExtraExpense_validite_ligne.png |300px]]
{| class="wikitable" style="width:100%; margin:auto; text-align:center; font-size:130%;"
|-
! colspan="7" | '''Calcul du Montant de la TVA'''
|-
| 20 || + || 20 || + || 30 || = || '''70'''
|}
|
En suivant les notes de frais créées précédemment, nous obtenons les éléments suivants :
* TVA à 20 % pour un montant HT de 100 €, soit un total TTC de 120 € et une TVA de 20€
* TVA à 10 % pour un montant HT de 200 €, soit un total TTC de 220 € et une TVA de 20€
* TVA à 0 % pour un montant HT de 50 €, et un TTC de 80 € soit une TVA de 80-50 = 30€

Nous avons alors un montant de TVA de : 20 + 20 + 30 = 70€ comme affiché sur le total.

|}

Extraexpense/en

2025-11-12T14:08:40Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"

| [[File:ExtraExpense-250x250.png]]
|ExtraExpense allows you to enter expense reports without having to select a fixed VAT rate.

We select the VAT rate at 0% and it becomes possible to enter both the pre-tax and post-tax amount and thus determine the VAT by subtraction.

This allows you to enter, for example, restaurant bills containing multiple VAT rates or an invoice from another country.

|}

== Configuration ==

In the module settings you will have the option to choose several operating modes:

<div class="mw-translate-fuzzy">
{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Basic Function
[[File:ExtraExpense_parametrage_en.png |600px]]
|
* Disable: The module is not active; VAT management for expense reports works by default.
* Enabled - if VAT is set to zero: The module is active and allows entry of the total (including tax) and pre-tax (excluding tax) amounts if the VAT rate is zero.
* Enabled - VAT is set to zero by default: Same as above, but the VAT rate is pre-selected.
* Enabled - without VAT entry: The VAT selection is removed, and entry of both total (including tax) and pre-tax amounts is mandatory.
</div>

|}


== Usage and Features ==

When creating or editing an expense report (via the expense report management form), the '''VAT rate management''' is automatically handled to avoid any calculation errors.


=== Basic Functioning ===

'''VAT Rate Management''': When you change the VAT rate of a line, an internal mechanism disables keyboard events on the price fields to '''prevent the simultaneous entry''' of the '''Excluding VAT''' and '''Including VAT''' values.

This ensures the consistency of calculations and avoids input errors.

'''Concrete example:''' If you change the VAT rate of a line (for example from '''0%''' to '''20%''' or other), the '''Price excl. VAT''' and '''Price incl. VAT''' fields will be automatically linked.

One of the two fields will be disabled to prevent double entry.

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Basic function
[[File:ExtraExpense_fonction_sans_extraexpense_001_en.png |300px]]

[[File:ExtraExpense_fonction_sans_extraexpense_result_001_en.png |300px]]
|
* If '''VAT = 20%''' and the '''Price excluding tax = €100''', you will not be able to fill in the '''Price including tax''' field.

The '''Price including tax''' field will be automatically calculated when the line is validated.

|}

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Basic function
[[File:ExtraExpense_fonction_sans_extraexpense_002_en.png |300px]]

[[File:ExtraExpense_fonction_sans_extraexpense_result_002_en.png |300px]]
|
* If '''VAT = 10%''' and the '''Price including VAT = €220''', you will not be able to fill in the '''Excluding VAT''' field.

The '''Excluding VAT''' field will be automatically calculated when the line is validated.

|}


=== ExtraExpense Features ===

With the '''ExtraExpense''' module, when the '''VAT rate = 0%''', you can still enter a price in '''Excluding VAT''' and in '''Including VAT''', without one of the two fields being blocked when the other is filled in.

'''Example :'''

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Function with ExtraExpense
[[File:ExtraExpense_function_AVEC_extraexpense_en.png |300px]]

[[File:ExtraExpense_fonction_avec_extraexpense_result_en.png |300px]]
|
If '''VAT = 0%''' and the '''Price excluding tax = €50''', you can also enter a different amount in the '''Including tax''' field.

The VAT amount is determined by the difference between the two amounts (here €30, which corresponds to a VAT rate of 60%).
|}


=== Line validity ===

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | Taking into account the ExtraExpense line
[[File:ExtraExpense_validite_ligne_en.png |300px]]
{| class="wikitable" style="width:100%; margin:auto; text-align:center; font-size:130%;"
|-
! colspan="7" | '''Calculation of the VAT Amount'''
|-
| 20 || + || 20 || + || 30 || = || '''70'''
|}
|
Based on the expense reports created previously, we obtain the following:
* 20% VAT on a pre-tax amount of €100, resulting in a total including tax of €120 and a VAT of €20
* 10% VAT on a pre-tax amount of €200, resulting in a total including tax of €220 and a VAT of €20
* 0% VAT on a pre-tax amount of €50 and a total including tax of €80, resulting in a VAT of €80 - €50 = €30

We then have a VAT amount of: 20 + 20 + 30 = €70 as shown on the total.

|}

Translations:Extraexpense/6/fr

2025-11-12T14:08:39Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

{| class="wikitable"
|- style="vertical-align:top"
| width="300px" | [[File:ExtraExpense_parametrage.png |600px]]
|
* Désactiver : le module n'est pas actif, la gestion de la TVA des notes de frais fonctionne par défaut
* Active - si sélection TVA à zéro : le module est active et permet de saisir le TTC et le HT si la TVA est à zéro
* Active - TVA à zéro par défaut : idem que précédemment, mais le taux de TVA à zéro est présélectionné
* Active - sans saisie de la TVA : La sélection de la TVA est supprimée et l'on fonctionne en saisie de TTC et HT obligatoirement

SupplierPricR/fr

2025-11-05T17:23:57Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:supplierPricr_250x250.png]]
| Le module SupplierPricR permet d'ajouter et mettre à jour les prix d'achat des fournisseurs à partir des demandes de devis ou commandes. Il ajoute un bouton sur les documents fournisseurs pour récupérer les prix et les intégrer automatiquement. L'utilisateur peut choisir d'afficher une fenêtre de sélection pour affiner les prix récupérés et ajouter des détails comme le délai de livraison. Le module offre plusieurs modes de configuration pour adapter la gestion des prix.
|}

== principe de fonctionnement ==
Le module ajoute un bouton [AJOUTER PRIX D'ACHAT] au niveau des pièces fournisseurs (la demande de prix, commande et facturefournisseur).

Lors de la validation de celui-ci, on rajoute un nouveau prix d'achat correspondant au prix pour chaque ligne.

== Configuration du module ==

La configuration du module se fait à partir de l'écran d'administration accessible depuis la liste des modules.

[[file:supplierpricr_setting.png|800px]]

Le premier paramètre permet d'indiquer si l'on récupère les prix sans référence fournisseur.
Le deuxième paramètre permet de préciser si l'on récupère les prix avec la quantité précisée sur la pièce (cf exemple plus bas).
Le dernier paramètre change le mode de récupération des prix en ouvrant une fenetre supplémentaire (popup) permettant de préciser les lignes que l'on souhaite récupérer (cf exemple plus bas).

== Utilisation du module ==
Sur les pièces fournisseurs actives (demandes de prix, commandes et factures), le module ajoute un bouton permettant la récupération des prix d'achats
=== Utilisation de base ===

[[file:display_boutton.png|800px]]

Quand on appuie sur le bouton, un message d'information précise le nombre de prix fournisseur récupéré par le module

=== Utilisation avec fenêtre de sélection ===
Quand on appuie sur le bouton de récupération, une fenêtre de sélection apparait.

[[file:display_popup.png|800px]]

Il est possible de décocher les lignes que l'on ne souhaite pas récupérer et de rajouter des informations supplémentaires :
* le nombre de jour de livraison
* la qualité du fournisseur sur ce produit

Une fois la fenêtre validée, un message d'information précise là aussi le nombre de prix fournisseur récupéré par le module.

== Résultat de la récupération des prix fournisseurs ==
Si l'on se positionne sur la page des prix fournisseurs on constate qu'un prix a été ajouté à la liste

[[file:list_prix_fournisseur.png|800px]]
* Si l'on a laissé la configuration par défaut pour les prix unitaire, c'est la ligne [1] qui est obtenue
* Si l'on a configuré le module pour conserver les prix à leur valeur unitaire, c'est la ligne [2] est récupérée

MyField/en

2025-11-05T17:23:56Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myfield-250x250.png]]
| The myField module allows you to customize the labels of menus, tabs, buttons, fields of Dolibarr cards and lists.
You can choose the label, color and access of your menus, buttons, tabs and fields of cards and lists yourself
|}

== Presentation ==
Depending on the type of myfield (fields of a form, list, tab, ...), several other options can be applied to the fields of the forms such as a background color, display/hide them, add an input mask, input in uppercase ...

The combined set of user permissions and myFields access rights allows you to configure user access to the view of fields, their content and their modification.

MyField also allows you to hide menus from groups of users and change their destination URL.

== Settings ==
The module is configured from the module administration page accessible via the menus '''Home > Configuration > Modules''' by clicking on the [[file:doli-setup.png]] icon or the [[file:doli-setup-old.png]] icon at the end of the line.

[[file:myfield_Configuration_en.png|800px]]


=== Module Configuration Page ===

==== Activating the context for development ====
MyField allows you to display on certain Dolibarr pages the contexts that can be used to limit the customization actions of myFields.
These contexts will be useful when creating myFields to limit the action of the module to only the pages that have in their code the context indicated on the myField sheet.
Configuring the display of contexts on your pages will allow you to identify them to best configure your myfields.

{| class="wikitable"
| [[file:myfield-Message-contexte.png]]
| style="vertical-align:top;" |
Enabling the display of contexts results in messages like the one opposite
|}

==== Administrators are above access rules ====
You can also choose to disable the use of access rights for the administrator user.

If this setting is enabled, the administrator will see, outside of any group, the myfields in operation.

==== Background color of input areas====
By default, input areas in dolibarr are transparent, which does not help readability
It is possible to change the background color of input areas

==== Default button color ====
There are three types of buttons in Dolibarr:
* Buttons associated with an action
* Disabled buttons
* Buttons performing a deletion
myField allows you to change the color of these

==== Replacing native buttons ====
MyField allows replacing standard Dolibarr buttons with icons.
{| class="wikitable"
| [[file:myfield_Button-replace.png|300px]]
| instead of
| [[file:myfield_Button-standard.png|500px]]
|}

==== Support Information ====
At the bottom of the configuration page you will find technical information related to your installation. This technical information will be useful and may be requested if you encounter a bug in using the module:
[[file:Myfield_Technical-information_en.png||800px]]

===Permissions===
Access to the module's features can be restricted to existing users and groups or those created after the module is installed.

Click on the – to add a permission.

A granted permission is symbolized by a green check mark ([[file:tick.png]]).

{{Note|Warning: there are other settings that can impact access to fields, especially when using an administrator account}}

====User and group permissions====
{| class="wikitable"
| [[file:myfield-Permissions-utilisateur_en.png|600px]]
| style="vertical-align:top;" |
Access to the module's features can be restricted to users and groups, from their profile then Permissions tab, according to the permissions opposite
|}

<div class="mw-translate-fuzzy">
====Default Permissions====
{| class="wikitable"
| [[file:myfield-Permissions-defaut_en.png|600px]]
| style="vertical-align:top;" |
The default permissions ('''Home > Users & Group > Choose between Users or Group > Select Permissions'''), granted to any user created after the installation of the module, if he is not added to a group, are the following
|}
</div>


== Startup ==

MyField features are accessible from the Patastools main menu tab.
Your secondary menu then presents the following menu entries:

{| class="wikitable"
|- style="vertical-align:top;"
| style='border-style: none;' | '''MyField'''
| The main entry displays a list of all myFields in your environment
|- style="vertical-align:top;"
| style='border-style: none;' |
'''New mf Field''' 
'''New mf Tab''' 
'''New mf Tab''' 
'''New mf List''' 
'''New mf Menu''' 
'''New mf Button'''

| These entries will display the page for creating a new myField according to its type:
* form field
* tab
* button
* list fields
* menu
|- style="vertical-align:top;"
| style='border-style: none;' | '''List of elements'''
| This entry will also display the list of myFields saved on your environment
|- style="vertical-align:top;"
| style='border-style: none;' | '''Access rights to elements'''
| This page will allow you to configure the authorizations of user groups to the features of MyFields, tabs and menus.
|- style="vertical-align:top;"
| style='border-style: none;' | '''Import XML'''
| This entry will display a page to copy an import file of a myfield in XML format.
|}

== Customizations ==
=== Menus ===
==== Creating the myField ====
The page for creating a menu-type myField is accessible from the secondary menu link '''Patas-tools > MyField > New myMenu.'''

[[File:Myfield-Page-creation-menu_en.png|800px]]

{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
myField Type
| style="vertical-align:top;" |
the field automatically filled in based on the menu link you clicked to display this creation page (menu).
|-
| style="vertical-align:top;" |
Native Label
| style="vertical-align:top;" |
enter here the native label of the menu as it is displayed on your interface.
|-
| style="vertical-align:top;" |
Menu Type
| style="vertical-align:top;" |
select from the drop-down list the type of menu you want to customize depending on whether it is a main menu, a secondary menu or a secondary menu entry.
|-
| style="vertical-align:top;" |
Replacement text
| style="vertical-align:top;" |
text of your choice that will be displayed instead of the native label.
|-
| style="vertical-align:top;" |
Author
| style="vertical-align:top;" |
the name of the creator of the myField
|}

| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Display
| style="vertical-align:top;" |
*Visible: the field will be displayed. This is the standard operation of Dolibarr.
*Invisible: the field will be absent from the cards
*Hidden: the field will be absent from the cards but can be displayed (Show/Hide).
|-
| style="vertical-align:top;" |
Background color
| style="vertical-align:top;" |
use the color selector to determine the background color of the field.
|-
| style="vertical-align:top;" |
Move
| style="vertical-align:top;" |
enter -1 to move the menu tab to the left, 1 to the right.
|-
| style="vertical-align:top;" |
Redirect URL
| style="vertical-align:top;" |
Enter here the URL of the page that will be displayed when clicking on the menu tab. If this field is left blank, the native URL of the menu will be kept.
|}

|}

Following the creation of a myField, it will be necessary to define the access rights by user groups from the secondary menu link of the same name (See further)

====Example of customizing a main menu====
Let's customize the ''Home'' menu.

[[file:myfield-Param-menu-accueil_en.png|600px]]

[[file:Myfield-menu-resultat_en.png|600px]]

====Example of customizing a menu and a secondary menu entry====
Let's customize the Commercial Proposals secondary menu and the New Proposal secondary menu entry.

[[file:myfield-Param-menu-secondaire_en.png|800px]]

[[file:myfield-Param-entree-menu-secondaire_en.png|800px]]

{{Note|The secondary menu entry will be moved down one rank with the code -1 in the Move field of its record}}
Following the application of these two customizations, the secondary menu becomes:

{| class="wikitable"
| [[file:Myfield-entree-menu-secondaire_en.png]]
| style="vertical-align:top;" |
rather than
| [[file:Myfield-menu-secondaire_en.png]]
|}

====Special case of secondary menu entries "List"====
To differentiate secondary menu entries of the same name, enter the top-level menu to which they are attached separated by a hash mark ('''#'''):

{| class="wikitable"
| style="vertical-align:top;" |
''Add to the label the secondary menu: Commercial proposals#List''

[[file:myfield_Liste-param_en.png|600px]]

| style="vertical-align:top;" |
To get

[[file:myfield_Liste-param-menu_en.png]]
|}

===Tabs===
====Creating the myField tab====
The myField creation page is accessible from the secondary menu link '''Patastools > MyField > New MyTab'''.

[[file:myfield-Page-creation-onglet_en.png|600px]]

{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
myField Type
| style="vertical-align:top;" |
the field automatically filled in based on the menu link you clicked.
|-
| style="vertical-align:top;" |
Native Label
| style="vertical-align:top;" |
enter here the native label of the menu as it is displayed on the screen.
|-
| style="vertical-align:top;" |
Activation Context
| style="vertical-align:top;" |
The activation context allows you to limit the action of myFields to only the fields of the pages with the context indicated here.
{{Note|Attention, for tabs, the context corresponds to the tabTitleText (the name of the first tab) (eg: "Third Party" for the Third Party element, "Product" for the Product element) }}

If no context is entered, changes made to the tab by the myfield will apply to all fields with the same label on all records.

|-
| style="vertical-align:top;" |
Replacement text
| style="vertical-align:top;" |
text of your choice that will be displayed instead of the native label.
|-
| style="vertical-align:top;" |
Author
| style="vertical-align:top;" |
the name of the creator of the myField

|}

| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Display
| style="vertical-align:top;" |
*Visible: the field will be displayed. This is the standard operation of Dolibarr.
*Invisible: the field will be absent from the cards
*Hidden: the field will be absent from the cards but can be displayed (Show/Hide).

|-
| style="vertical-align:top;" |
Background Color
| style="vertical-align:top;" |
Use the color picker to determine the background color of the myField.
|-
| style="vertical-align:top;" |
Move
| style="vertical-align:top;" |
Enter -1 to move the menu tab to the left, 1 to move the right.
|-
| style="vertical-align:top;" |
Redirect URL
| style="vertical-align:top;" |
Enter the URL of the page that will be displayed when the menu tab is clicked. If this field is left blank, the native URL of the menu will be kept.
|}

|}

{{Note|Indicate here only the part of the URL following ''/htdocs/''}}
Display request: see Operation section, below

Following the creation of a myField, it will be necessary to define the access rights to the myFields by user groups from the secondary menu link of the same name (See section Configuring access rights).

====Example of customizing a tab====
Let's customize the tab sheet of the element sheets.

[[file:myfield-Param-onglet-fiche_en.png|800px]]

The sheet then becomes

[[file:myfield-Natif-fiche_en.png|800px]]
{{Note|If the tab is active, the color will be displayed on its edges}}

===Fields===
====Creating myField====
The myField creation page is accessible from the secondary menu link '''Patastools > MyField > New MyField'''.

[[file:myfield-Page-creation_en.png|600px]]

{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
myField Type
| style="vertical-align:top;" |
the field automatically filled in based on the menu link you clicked.
|-
| style="vertical-align:top;" |
Native Label
| style="vertical-align:top;" |
enter here the native label of the field as it is displayed on the screen.
|-
| style="vertical-align:top;" |
Activation Context
| style="vertical-align:top;" |
the activation context allows you to limit the action of myFields to only the fields of the pages with the context indicated here.
If no context is entered, changes made to the tab by the myfield will apply to all fields with the same label on all records.

[[#Activation context|List of main contexts]]

|-
| style="vertical-align:top;" |
Replacement text
| style="vertical-align:top;" |
text of your choice that will be displayed instead of the native label.
|-
| style="vertical-align:top;" |
Author
| style="vertical-align:top;" |
the name of the creator of the myField

|}

| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Display
| style="vertical-align:top;" |
*Visible: the field will be displayed. This is the standard operation of Dolibarr.
*Invisible: the field will be absent from the cards
*Hidden: the field will be absent from the cards but can be displayed (Show/Hide).
{{Note|on the latest versions of the module, (Show/Hide) is no longer used, you must now click on the Dolibarr version number (top right)|warn}}
|-
| style="vertical-align:top;" |
Background color
| style="vertical-align:top;" |
use the color selector to determine the background color of the myField.
|-
| style="vertical-align:top;" |
Move
| style="vertical-align:top;" |
enter 1 to move up one field, -1 to move down one field.
|-
| style="vertical-align:top;" |
Default value
| style="vertical-align:top;" |

|-
| style="vertical-align:top;" |
Input field size
| style="vertical-align:top;" |
to be defined according to your needs. If left blank, the native value of the field is kept.
|-
| style="vertical-align:top;" |
Mandatory:
| style="vertical-align:top;" |
check this box to make entering values in the field mandatory to save the creation or modifications of the page
{{Note|The control of the field in creation and modification is only carried out if you enter the edition of the field itself|warn}}
|-
| style="vertical-align:top;" |
Input mask
| style="vertical-align:top;" |
the input mask can be configured with the following characters:
*a for a letter (A-Z,a-z)
*9 for a number (0-9)
*for an alphanumeric character (A-Z,a-z,0-9)
:You can add the characters you want to the field to make up your mask. For example, if you want to add an international code to the phone field, the mask will be: +0099-(9)999999999
*UPPERCASE to force uppercase input.
*LOWERCASE to force lowercase input.
|-
| style="vertical-align:top;" |
Display request
| style="vertical-align:top;" |
See Operation section
|}

|}

{{Note|Moving a field in a form is only done within its table. It is therefore possible to move a field up or down, but not to change its column}}

Following the creation of a field type myField, it will be necessary to define the access rights to the myFields by user groups from the secondary menu link of the same name (See section Configuring access rights).

====Example of customizing a field====
Let's customize the field ''Id. prof. 2 (SIRET)'' of third-party files.

{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield_Param-champ_en.png|600px]]
| The field has been set to invisible with a number input mask (999 999 999 99999)

|- style="vertical-align:top;"
| [[file:Myfield-champ_en.png|600px]]

[[file:myfield-Masque_en.png]]

|
By clicking on the Show/Hide link above the table, the field will be displayed according to the settings saved on the myField sheet

When editing the field, the mask will be activated and will only allow the predefined entry and its completion checked (made mandatory) to prevent the page from being saved without it being filled in.
|}

===Lists===
It is possible to modify the fields of the native lists of dolibarr (the one with a field selection icon at the end of the list)

====Creating myField====
List myfields allow you to limit the display of fields.
It is necessary to open the list page to retrieve information specific to this type of myField
* the activation context
* the untranslated label of the field

====Example of setting====
We will modify the "Third party" column on the list of interventions

[[file:Myfield-masque-tiers_en.png|600px]]

Depending on the permissions, the field will also be inaccessible in the field selector.

[[file:myfield_Liste-contrats_en.png|600px]]

{{Note|If you make a list myField invisible, it will be invisible to all users. To hide it only from one or more groups of users, leave it visible and then add access rights!}}

=== Buttons ===
It is possible to modify the buttons present on the dolibarr files

====Creation of myField====
Button myfields allow you to make the button invisible, replace the label, the url associated with the button and make its access visible according to the result of an SQL query

[[file:myfield-creation-bouton_en.png|600px]]

{{Note|With the native Dolibarr theme, the button label is capitalized, so you must use the original text that you retrieve with the right click and the inspect menu.}}

=Conditional display SQL query=
The processing query will condition the display of the fields according to the correspondence of the object to the query. It is then possible, for example, to display different fields depending on whether the object is a product or a service.
It is possible to transmit two values as parameters:
* #ID#: the id of the main object of the page
* #USERID#: the id of the active user


==How it works==

Enter here the display query applicable to the fields in the following example:

#SEL# allows you to replace the SELECT of the SQL query which will be blocked by Dolibarr's native security (SQL Injection)

''#SEL# IF(fk_product_type=1, 1, 0) AS `read`, IF(fk_product_type=1, 1, 0) AS `write` FROM llx_product WHERE rowid=#ID#; ''

read allows you to authorize or not the global display of the field
write allows you to authorize or not its modification (not necessary in the case of a button or a tab...)

If the value is 0, the field is hidden, otherwise it is displayed
Be careful, if we leave the field parameter hidden, it will not appear regardless of the value

==Example==
With the following myfield

[[file:myfield_Creation_requete_en.png|800px]]

{| class="wikitable"
|- style="vertical-align:top;"
| We obtain the following sheet on a '''product'''
[[file:myfield_Creation_requete_result_en.png|400px]]
| While on the sheet of a '''service'''
[[file:myfield_Creation_requete-fiche_en.png|400px]]

|}

=Setting access rights to myFields, tabs and menus=
==Configuring access rights==
As an administrator user, all myFields are visible to you.
{{Note|On the MyField module home page, the application of customizations is disabled}}

If you have not defined any user groups, myfields are displayed on all users' interfaces.

From the secondary menu entry '''Patas-Tools > MyField > tab access rights''', configure the accesses of the user groups:

[[file:myfield-Droits-d-acces_en.png|600px]]

There are four access rights:

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:lecture-off.png]] Access blocked
[[file:lecture-on.png]] Access read
| [[file:modif-of.png]] Edit blocked
[[file:modif-on.png]] Edit access
|}

==Behavior according to access rights==
===Blocked in access ([[file:lecture-off.png]]) ===

{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-_en.png|600px]]
| The field will be hidden from users in the group. They will not be able to view it

the ''Show/Hide'' link will not be active
|}
===Read access but blocked from editing ([[file:lecture-on.png]][[file:modif-of.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-_en.png|600px]]
| Users in the group will be able to view the field, but will not be able to edit its content.
|}
===Read access and Edit access ([[file:lecture-on.png]][[file:modif-on.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture+-modif+_en.png|600px]]
|
Users in the group will be able to view and edit the field if their group or user permissions allow them to do so. The field settings then apply (mandatory, input mask, etc.)
|}

=Other features=
==Importing myFields==
It is possible to save a list of myfields and their settings by importing an XML file.
From the '''Patas-M Tools > MyField > Import a tab''' page, paste the XML file into the input area and click on the '''Start import''' button.
{{Note|If you check the Overwrite previous data box, your list of myfields will be limited to those present in the file you are importing|warn}}
Then configure the users' access rights to the myField.

==Activation context==
A list of all available contexts is present on the dolibarr wiki:
https://wiki.dolibarr.org/index.php?title=Hooks_System#List_of_Contexts_available_in_Dolibarr

some of the most common
{|
|
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Card
| Context
|-
| Member
| membertypecard
|-
| Categories
| categorycard
|-
| Orders
| ordercard
|-
| Supplier order
| ordersuppliercard
|-
| Contact
| contactcard
|-
| Contract
| contractcard
|-
| Donation
| doncard
|-
| Warehouse
| warehousecard
|-
| Shipping
| expeditioncard
|-
| Customer invoice
| invoicecard
|-
| Supplier invoice
| suppliercard
|}

| style="vertical-align:top;" |
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Sheet
| Context
|-
| Intervention
| interventioncard
|-
| Delivery
| deliverycard
|-
| Expense report
| tripandexpensecard
|-
| Product
| productcard
|-
| Project
| projectcard
|-
| Commercial proposal
| propalcard
|-
| Customer payment
| paymentcard
|-
| Supplier payment
| paymentsupplier
|-
| Salary
| salarycard
|-
| Task
| projecttaskcard
|-
| Third party
| thirdpartycard
|-
| User
| usercard

|}

|}

=Frequently Asked Questions=
== General ==
This chapter lists the difficulties encountered with the module. You will therefore find answers to its use.
If you encounter an error other than those described below when using this module:
#Disable and reactivate the module,
#Check on the ChangeLog if a new version has been published,
#Re-install/update the module,
#Check that replacing native Dolibarr files is not necessary for the module to work properly.
#Check that no incompatibility with another module is indicated. If necessary, follow our recommendations.

If, despite these manipulations, the error persists, contact us using the dedicated form (http://docs.patas-monkey.com/support/).
This form is the preferred contact method for any difficulty of use or bug report. Also, we thank you for not multiplying the exchange channels for the same object.

== Displaying a message at the top of Dolibarr pages==
If your Dolibarr pages display a message similar to the following image, it is not an error message, but the display of the contexts of the current page. To no longer see these lines displayed, disable the display of the context
(see Configuration).

[[file:Myfield-Message-contexte.png]]

==Ordering error message==
Some pages of some versions of Dolibarr have an error in their code preventing the correct application of field customization. MyField allows you to identify them in order to correct them.

The error message is displayed at the bottom of the page and is as follows:

[[file:myfield_Erreur-dbclose-message.png]]

Using the URL of the page, open the Dolibarr core file to edit it. For example, if the page containing the message is ''http://.../htdocs/custom/myField/admin/extrafields.php'', successively open the folders ''htdocs'', ''custom'', ''myField'', ''admin'' and open the file ''extrafields.php''.

The error comes from the inversion of the lines ''llxFooter();'' and ''$db->close();'' at the end of the file.

{| class="wikitable" style="width:60%;"
|- style="vertical-align:top;"
| Edit the page code to get
[[file:Erreur-dbclose-correction.png]]
| instead of

[[file:Erreur-dbclose.png]]
|}
==Multicompany==
With the multicompany module, it is necessary to activate the module on each entity

SupplierPricR/en

2025-11-05T17:23:46Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>

<div class="mw-translate-fuzzy">
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:supplierPricr_250x250.png]]
| SupplierPricr allows you to create/update a supplier's purchase prices based on a quote request response, as well as a supplier order.
|}
</div>

== How it works ==
The module adds an [ADD PURCHASE PRICE] button to supplier documents (price request, order, and supplier invoice).

When validating this, a new purchase price is added corresponding to the price for each line.


== Module Configuration ==

The module configuration is done from the administration screen accessible from the module list.

[[file:supplierpricr_setting_en.png|800px]]

The first parameter specifies whether prices are retrieved without a supplier reference.
The second parameter specifies whether prices are retrieved with the quantity specified on the part (see example below).
The last parameter changes the price retrieval mode by opening an additional window (popup) allowing you to specify the lines you wish to retrieve (see example below).

== Module Usage ==
On active supplier documents (price requests, orders, and invoices), the module adds a button to retrieve purchase prices.
=== Basic Usage ===

[[file:display_boutton_en.png|800px]]

When the button is pressed, an information message specifies the number of supplier prices retrieved by the module

=== Use with a selection window ===
When you press the recovery button, a selection window appears.

[[file:display_popup_en.png|800px]]

<div class="mw-translate-fuzzy">
You can uncheck the lines you don't want to retrieve and add additional information:
* the number of delivery days
* the supplier's quality for this product
</div>

Once the window has been validated, an information message also specifies the number of supplier prices retrieved by the module.

== Supplier Price Retrieval Results ==
If you go to the Supplier Prices page, you'll see that a price has been added to the list.

[[file:list_prix_fournisseur_en.png|800px]]
* If the default configuration for unit prices has been left, line [1] is obtained.
* If the module has been configured to keep prices at their unit value, line [2] is retrieved.

Translations:SupplierPricR/25/fr

2025-11-05T17:23:37Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Il est possible de décocher les lignes que l'on ne souhaite pas récupérer et de rajouter des informations supplémentaires :
* le nombre de jour de livraison
* la qualité du fournisseur sur ce produit

Translations:SupplierPricR/13/fr

2025-11-05T17:23:37Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:supplierPricr_250x250.png]]
| Le module SupplierPricR permet d'ajouter et mettre à jour les prix d'achat des fournisseurs à partir des demandes de devis ou commandes. Il ajoute un bouton sur les documents fournisseurs pour récupérer les prix et les intégrer automatiquement. L'utilisateur peut choisir d'afficher une fenêtre de sélection pour affiner les prix récupérés et ajouter des détails comme le délai de livraison. Le module offre plusieurs modes de configuration pour adapter la gestion des prix.
|}

MyDiscount/fr

2025-11-05T17:23:35Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:MyDiscount-250x250.png]]
|MyDiscount est un module qui vous permet d'ajouter des réductions aux offres commerciales, aux commandes et aux factures.
|}
== Configuration ==
le paramétrage du module s'effectue au niveau du menu de paramétrage des modules

Page d'accueil >> Configuration >> Modules/Applications

[[File:MyDiscount_Config_MyDiscount1-250x250.png |750px]]

Après avoir trouvé le module dans la liste des modules, accédez-y via l'icône de configuration. Si le module n'est pas actif, activez-le pour accéder aux paramètres.

[[File:MyDiscount_Config_MyDiscount2-250x250.png |750px]]

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:MyDiscount_Config_MyDiscount3-250x250.png |750px]]
|Pour accéder aux paramètres: * Afficher la remise en HT * Afficher la remise en TTC * Les offerts (rabais 100%) sont modifiables pour le calcul de rabais Il suffit de les activer, comme décrit dans l'image.
|}

== Création d'un discount ==
MyDiscount fonctionne comme suit :

Après la création d'une commande, d'une proposition commerciale ou d'une facture, la remise peut être accordée.

[[File:MyDiscount_CreationDiscount1-250x250.png |750px]]

saisir le montant de la remise. Important : N'oubliez pas de cocher la case "Remisable", qui est indispensable pour que la réduction soit appliquée.

[[File:MyDiscount_CreationDiscount2-150x150.png |750px]]

A ce stade, il est déjà possible de vérifier l'application de la réduction sur la commande..

[[File:MyDiscount_CreationDiscount3-250x250.png |750px]]

Pendant que la commande / la proposition commerciale / la facture sont en mode brouillon, la remise peut être modifiée.

[[File:MyDiscount_CreationDiscount4-250x250.png |750px]]

MyField/fr

2025-11-05T17:23:24Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Myfield-250x250.png]]
| Le module myField permet de personnaliser les libellés des menus, onglets, bouton, champs des fiches et listes de Dolibarr.
Vous pouvez choisir vous-même le libellé, la couleur et l'accès de vos menus, des boutons, des onglets et champs des fiches et listes
|}

== Présentation ==
Selon le type de myfield (champs d'une fiche, liste, onglet,...), plusieurs autres options peuvent être appliquées aux champs des fiches telles qu'une couleur de fond, les afficher/ cacher, ajouter un masque de saisie, saisie en majuscule ...

Le jeu combiné des permissions utilisateurs et des droits d'accès aux myFields permet de paramétrer les accès des utilisateurs à la vue des champs, leur contenu et leur modification.

MyField permet encore de cacher des menus à des groupes d'utilisateurs et d'en modifier l'URL de destination.

== Paramétrage ==
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus '''Accueil > Configuration > Modules''' en cliquant sur l'icône [[file:doli-setup.png]] ou l'icône [[file:doli-setup-old.png]] en bout de ligne.

[[file:myfield_Configuration.png|800px]]

=== Page de configuration du module ===

==== Activation du contexte pour le développement====
MyField permet d'afficher sur certaines pages de Dolibarr les contextes utilisables pour limiter les actions de personnalisations des myFields.
Ces contextes seront utiles lors de la création de myFields pour limiter l'action du module aux seules pages possédant dans leur code le contexte indiqué sur la fiche du myField.
Paramétrer l'affichage des contexte sur vos pages vous permettra de les identifier pour paramétrer au mieux vos myfields.

{| class="wikitable"
| [[file:myfield-Message-contexte.png]]
| style="vertical-align:top;" |
L'activation de l'affichage des contextes se traduit par des messages comme ci-contre
|}

==== L'administrateurs est au dessus des règles d'accès ====
Vous pouvez aussi choisir de désactiver l'utilisation des droits d'accès pour l'utilisateur administrateur.

Si ce paramètre est activé, l'administrateur verra, hors de tout groupe, les myfields en fonctionnement.

==== Couleur de fond des zones de saisie====
Par défaut les zones de saisies dans dolibarr sont transparentes, ce qui n'aide pas à la lisibilité
Il est possible de changer la couleur de fond des zones de saisies

==== Couleur des boutons par défaut====
Il y a trois types de boutons dans Dolibarr:
* Les boutons associés à une action
* Les boutons désactivés
* Les boutons effectuant une suppression
myField permet de changer la couleur de ceux-ci

==== Remplacement des boutons natifs====
MyField permet le remplacement des boutons standards de Dolibarr par des icônes.
{| class="wikitable"
| [[file:myfield_Button-replace.png|300px]]
| au lieu de
| [[file:myfield_Button-standard.png|500px]]
|}

==== Information de support ====
Vous trouverez en bas de la page de configuration les informations techniques liées à votre installation. Ces informations techniques seront utiles et pourront vous être demandées si vous rencontrez un bug dans l'utilisation du module :
[[file:Myfield_Technical-information.png||800px]]

===Permissions===
Les accès aux fonctionnalités du module peuvent être restreints aux utilisateurs et groupes existants ou créés ultérieurement à l'installation du module.

Cliquez sur le – pour ajouter un permission.

Une permission accordée est symbolisée par un coche verte ([[file:tick.png]]).

{{Note|Attention : il y a d'autres paramètres qui peuvent impacter l'accès aux champs, notamment quand on utilise un compte administrateur}}

====Permissions utilisateurs et groupes====
{| class="wikitable"
| [[file:myfield-Permissions-utilisateur.png|600px]]
| style="vertical-align:top;" |
Les accès aux fonctionnalités du modules peuvent être restreints aux utilisateurs et groupes, depuis leur fiche puis onglet Permissions, selon les permissions ci-contre
|}

====Permissions par défaut====
{| class="wikitable"
| [[file:myfield-Permissions-defaut.png|600px]]
| style="vertical-align:top;" |
Les permissions par défaut ('''Accueil > Utilisateurs et groupe > Choisir entre utilisateurs ou groupe > Sélectionner les autorisations'''), accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe, sont les suivantes
|}

== Démarrage ==

Les fonctionnalités de MyField sont accessibles depuis l'onglet de menu principal Patastools.
Votre menu secondaire présente alors les entrées de menu suivantes :

{| class="wikitable"
|- style="vertical-align:top;"
| style='border-style: none;' | '''MyField'''
| L'entrée principale affiche la liste de tous les myFields de votre environnement
|- style="vertical-align:top;"
| style='border-style: none;' |
'''Nouveau mf Field''' 
'''Nouveau mf Tab''' 
'''Nouveau mf Onglet''' 
'''Nouveau mf de liste''' 
'''Nouveau mf Menu''' 
'''Nouveau mf Bouton'''

| Ces entrées afficheront la page de création d'un nouveau myField selon son type :
* champ de fiche
* onglet
* bouton
* champs de liste
* menu
|- style="vertical-align:top;"
| style='border-style: none;' | '''Liste des éléments'''
| Cette entrée affichera également la liste des myFields enregistrés sur votre environnement
|- style="vertical-align:top;"
| style='border-style: none;' | '''Droits d'accès aux éléments'''
| Cette page vous permettra de paramétrer les habilitations des groupes d'utilisateurs aux fonctionnalités de MyFields, tabs et menus.
|- style="vertical-align:top;"
| style='border-style: none;' | '''Import XML'''
| Cette entré affichera une page permettant de copier un fichier d'import d'un myfield au format XML.
|}

== Personnalisations ==
=== Menus ===
==== Création du myField ====
La page de création d'un myField de type menu est accessible depuis le lien de menu secondaire '''Patas-tools > MyField > Nouveau myMenu.'''

[[File:Myfield-Page-creation-menu.png|800px]]

{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué pour afficher cette page de création (menu).
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du menu tel qu'il est affiché sur votre interface.
|-
| style="vertical-align:top;" |
Type de menu
| style="vertical-align:top;" |
sélectionnez dans la liste déroulante le type de menu que vous souhaitez personnaliser selon qu'il s'agit d'un menu principal, d'un menu secondaire ou d'une entrée de menu secondaire.
|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField
|}

| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).
|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du champ.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez -1 pour déplacer l'onglet du menu vers la gauche, 1 vers la droite.
|-
| style="vertical-align:top;" |
URL de redirection
| style="vertical-align:top;" |
saisissez ici l'URL de la page qui s'affichera au clic sur l'onglet de menu. Si ce champ est laissé libre, l'URL native du menu sera conservée.
|}

|}

Suite à la création d'un myField, il sera nécessaire d'en définir les droits d'accès par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir plus loin)

====Exemple de personnalisation d'un menu principal====
Personnalisons le menu ''Accueil''.

[[file:myfield-Param-menu-accueil.png|600px]]

[[file:Myfield-menu-resultat.png|600px]]

====Exemple de personnalisation d'un menu et d'une entrée de menu secondaire====
Personnalisons le menu secondaire Propositions commerciales et l'entrée de menu secondaire Nouvelle proposition.

[[file:myfield-Param-menu-secondaire.png|600px]]

[[file:myfield-Param-entree-menu-secondaire.png|600px]]

{{Note|L'entrée de menu secondaire sera déplacée d'un rang vers le bas avec le code -1 dans le champ Déplacement de sa fiche}}
Suite à l'application de ces deux personnalisations, le menu secondaire devient :

{| class="wikitable"
| [[file:Myfield-entree-menu-secondaire.png]]
| style="vertical-align:top;" |
plutôt que
| [[file:Myfield-menu-secondaire.png]]
|}

====Cas particulier de entrées de menu secondaire "Liste"====
Pour différencier les entrées de menu secondaire du même nom, saisissez le menu de niveau supérieur auquel elles sont rattachées séparées par un dièse ('''#''') :

{| class="wikitable"
| style="vertical-align:top;" |
''Ajoutez au libellé le menu secondaire : Propositions commerciales#Liste''

[[file:myfield_Liste-param.png|600px]]

| style="vertical-align:top;" |
Pour obtenir

[[file:myfield_Liste-param-menu.png]]
|}

===Onglets===
====Création du myField d'onglet====
La page de création d'un myField est accessible depuis le lien de menu secondaire '''Patastools > MyField > Nouveau MyTab'''.

[[file:myfield-Page-creation-onglet.png|600px]]

{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué.
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du menu tel qu'il est affiché à l'écran.
|-
| style="vertical-align:top;" |
Contexte d'activation
| style="vertical-align:top;" |
Le contexte d'activation permet de limiter l'action des myFields sur les seuls champs des pages comportant le contexte indiqué ici.
{{Note|Attention, pour les onglets, le contexte correspond au tabTitleText (le nom du premier onglet) (ex: "Tiers" pour l'élément Tiers, "Produit" pour l'élément Produit) }}

Si aucun context n'est saisi, les modifications apportées à l'onglet par le myfield s'appliqueront à tous les champs du même libellé de toutes les fiches.

|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField

|}

| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).

|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du myField.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez -1 pour déplacer l'onglet du menu vers la gauche, 1 vers la droite.
|-
| style="vertical-align:top;" |
URL de redirection
| style="vertical-align:top;" |
saisissez ici l'URL de la page qui s'affichera au clic sur l'onglet de menu. Si ce champ est laissé libre, l'URL native du menu sera conservée.
|}

|}

{{Note|N'indiquez ici que la partie de l'URL suivant ''/htdocs/''}}
Requête d'affichage : voir section Fonctionnement, ci-dessous

Suite à la création d'un myField, il sera nécessaire de définir les droits d'accès aux myFields par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir section Configuration des droits d'accès).

====Exemple de personnalisation d'un onglet====
Personnalisons l'onglet fiche des fiches des éléments.

[[file:myfield-Param-onglet-fiche.png|800px]]

La fiche devient alors

[[file:myfield-Natif-fiche.png|800px]]
{{Note|Si l'onglet est actif, la couleur sera affichée sur ses bords}}

===Champs===
====Création du myField====
La page de création d'un myField est accessible depuis le lien de menu secondaire '''Patastools > MyField > Nouveau MyField'''.

[[file:myfield-Page-creation.png|600px]]

{|
| style="vertical-align:top;width:50%;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Type de myField
| style="vertical-align:top;" |
le champ automatiquement rempli en fonction du lien de menu sur lequel vous avez cliqué.
|-
| style="vertical-align:top;" |
Libellé natif
| style="vertical-align:top;" |
saisissez ici le libellé natif du champ tel qu'il est affiché à l'écran.
|-
| style="vertical-align:top;" |
Contexte d'activation
| style="vertical-align:top;" |
le contexte d'activation permet de limiter l'action des myFields sur les seuls champs des pages comportant le contexte indiqué ici.
Si aucun contexte n'est saisi, les modifications apportées à l'onglet par le myfield s'appliqueront à tous les champs du même libellé de toutes les fiches.

[[#Contexte d'activation|Liste des principaux contexte ]]

|-
| style="vertical-align:top;" |
Texte de remplacement
| style="vertical-align:top;" |
texte de votre choix qui sera affiché à la place du libellé natif.
|-
| style="vertical-align:top;" |
Auteur
| style="vertical-align:top;" |
le nom du créateur du myField

|}

| style="vertical-align:top;" |
{| class="wikitable"
| style="vertical-align:top;width:25%;" |
Affichage
| style="vertical-align:top;" |
*Visible : le champ sera affiché. Il s'agit du fonctionnement standard de Dolibarr.
*Invisible : le champ sera absent des fiches
*Caché : le champ sera absent des fiches mais pourra être affiché (Show/Hide).
{{Note|sur les dernières versions du module, (Show/Hide) n'est plus employé, il faut à présent cliquer sur le numéro de version de Dolibarr (en haut à droite)|warn}}
|-
| style="vertical-align:top;" |
Couleur de fond
| style="vertical-align:top;" |
utilisez le sélecteur de couleur pour déterminer la couleur de fond du myField.
|-
| style="vertical-align:top;" |
Déplacement
| style="vertical-align:top;" |
saisissez 1 pour remonter d'un champ, -1 pour descendre.
|-
| style="vertical-align:top;" |
Valeur par défaut
| style="vertical-align:top;" |

|-
| style="vertical-align:top;" |
Taille du champ de saisie
| style="vertical-align:top;" |
à définir selon vos besoins. Si laissé vide, la valeur native du champ est conservée.
|-
| style="vertical-align:top;" |
Obligatoire :
| style="vertical-align:top;" |
cochez cette case pour rendre la saisie de valeurs dans le champ obligatoire pour enregistrer la création ou les modifications de la page
{{Note|Le contrôle du champ en création et modification n'est effectué que si l'on rentre en édition du champ lui-même|warn}}
|-
| style="vertical-align:top;" |
Masque de saisie
| style="vertical-align:top;" |
le masque de saisie est paramétrable avec les caractères suivants :
*a pour une lettre (A-Z,a-z)
*9 pour un chiffre (0-9)
*pour un caractère alphanumérique (A-Z,a-z,0-9)
:Vous pouvez ajouter dans le champ les caractères que vous souhaitez pour constituer votre masque. Par exemple, si vous souhaitez ajouter un indicatif international au champ téléphone, le masque sera : +0099-(9)999999999
*UPPERCASE pour forcer la saisie en majuscule.
*LOWERCASE pour forcer la saisie en minuscule.
|-
| style="vertical-align:top;" |
Requête d'affichage
| style="vertical-align:top;" |
Voir section Fonctionnement
|}

|}

{{Note|Le déplacement d'un champ d'une fiche n'est effectué qu'au sein de son tableau. Il est donc possible de remonter ou descendre un champ, mais pas de le changer de colonne}}

Suite à la création d'un myField de type champ, il sera nécessaire de définir les droits d'accès aux myFields par groupes d'utilisateurs depuis le lien de menu secondaire du même nom (Voir section Configuration des droits d'accès).

====Exemple de personnalisation d'un champ====
Personnalisons le champ ''Id. prof. 2 (SIRET)'' des fiches de tiers.

{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield_Param-champ.png|600px]]
| Le champ a été paramétré en tant qu'invisible avec un masque de saisie de chiffres (999 999 999 99999)

|- style="vertical-align:top;"
| [[file:Myfield-champ.png|600px]]

[[file:myfield-Masque.png]]

|
En cliquant sur le lien Show/Hide au-dessus du tableau, le champ sera affiché selon les paramètres enregistrés sur la fiche du myField

Lors de l'édition du champ, le masque sera activé et ne permettra que la saisie prédéfinie et sa complétion vérifiée (rendu obligatoire) pour empêcher l'enregistrement de la page sans qu'il ne soit rempli.
|}

===Listes===
Il est possible de modifier les champs des listes natives de dolibarr (celle avec une icone de sélection de champs en bout de liste)

====Création du myField====
Les myfields de liste permettent de limiter l'affichage de champs.
il est nécessaire d'ouvrir la page de liste pour récupérer des informations propre à ce type de myField
* le contexte d'activation
* le libellé non traduit du champs

====Exemple de paramétrage====
Nous allons modifier la colonne "Tiers" sur la liste des interventions

[[file:Myfield-masque-tiers.png|600px]]

Selon les habilitations, le champs sera aussi inaccessible dans le sélecteur de champs.

[[file:myfield_Liste-contrats.png|600px]]

{{Note|Si vous rendez un myField de liste invisible, il sera invisible de tous les utilisateur. Pour le cacher seulement à un ou des groupes d'utilisateurs, laissez le visible et jouter ensuite avec les droits d'accès !}}

=== Boutons ===
Il est possible de modifier les boutons présent sur les fiches de dolibarr

====Création du myField====
Les myfield de boutons permettent de rendre invisible bouton, remplacer le libellé, l'url associé au bouton et de rendre son accès visible selon le résultat d'une requete SQL

[[file:myfield-creation-bouton.png|600px]]

{{Note|Avec le thème natif de Dolibarr, le libellé du bouton est mis en majuscule, il faut donc utiliser le texte d'origine que l'on récupère avec le click droit et le menu inspecter.}}

=Requête SQL d'affichage conditionnel=
La requête de traitement va conditionner l'affichage des champs selon la correspondance de l'objet à la requête. Il est alors possible, par exemple, d'afficher des champs différents selon que l'objet est un produits ou un service.
Il est possible de transmettre en paramètre deux valeurs :
* #ID# : l'id de l'objet principale de la page
* #USERID# : l'id de l'utilisateur actif

==Fonctionnement==

Saisissez ici la requête d'affichage applicable au champs sur l'exemple suivant :

#SEL# permet de remplacer le SELECT de la requête SQL qui sera bloqué par la sécurité native de Dolibarr (SQL Injection)

''#SEL# IF(fk_product_type=1, 1, 0) AS `read`, IF(fk_product_type=1, 1, 0) AS `write` FROM llx_product WHERE rowid=#ID#; ''

read permet d'autoriser ou non l'affichage globale du champ
write permet d'autoriser ou non sa modification (pas nécessaire dans le cas d'un bouton un un onglet...)

Si la valeur est à 0, le champs est caché, dans le cas contraire il est affiché
Attention, si on laisse le paramètre du champs à caché, il n'apparaitra pas quel que soit la valeur

==Exemple==
Avec le myfield suivant

[[file:myfield_Creation_requete.png|800px]]

{| class="wikitable"
|- style="vertical-align:top;"
| On obtient la fiche suivante sur un '''produit'''
[[file:myfield_Creation_requete_result.png|400px]]
| Tandis que sur la fiche d'un '''service'''
[[file:myfield_Creation_requete-fiche.png|400px]]

|}

=Paramétrage des droits d'accès aux myFields, tabs et menus=
==Configuration des droits d'accès==
En tant qu'utilisateur administrateur, tous les myFields vous sont visibles.
{{Note|Sur la page d'accueil du module MyField, l'application des personnalisations est désactivée}}

Si vous n'avez pas défini de groupes utilisateurs, les myfields sont affichés sur les interfaces de tous les utilsiateurs.

Depuis l'entrée de menu secondaire '''Patas-Tools > MyField > droits d'accès aux onglets''', paramétrez les accès des groupes d'utilisateurs :

[[file:myfield-Droits-d-acces.png|600px]]

Il existe quatre droits d'accès :

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:lecture-off.png]] Bloqué en accès
[[file:lecture-on.png]] Accès en lecture
| [[file:modif-of.png]] Bloqué en modification
[[file:modif-on.png]] Accès en modification
|}

==Comportement selon les droits d'accès==
===Bloqué en accès ([[file:lecture-off.png]]) ===

{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-.png|600px]]
| Le champ sera caché aux utilisateurs du groupe. Ils ne pourront pas l'afficher

le lien ''Show/Hide'' ne sera pas actif
|}
===Accès en lecture mais bloqué en modification ([[file:lecture-on.png]][[file:modif-of.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture-.png|600px]]
| Les utilisateurs du groupe pourront afficher le champ, mais ne pourront pas en modifier le contenu.
|}
===Accès en lecture et Accès en modification ([[file:lecture-on.png]][[file:modif-on.png]]) ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[file:myfield-User-lecture+-modif+.png|600px]]
|
Les utilisateurs du groupe pourront afficher le champ et le modifier si leurs permissions de groupe ou d'utilisateur le leur permettent. Les paramètres du champ s'appliquent alors (obligatoire, masque de saisie,...)
|}

=Autres fonctionnalités=
==Import des myField==
Il est possible d'enregistrer une liste de myfields et leurs paramétrages en important un fichier XML.
Depuis la page '''Outils Patas-M > MyField > Importer un onglet''', collez le fichier XML dans la zone de saisie et cliquez sur le bouton '''Lancer l'importation'''.
{{Note|Si vous cochez la case Écraser les données précédentes, votre liste de myfields se résumera à ceux présent dans le ficher que vous importez|warn}}
Paramétrer ensuite les droits d'accès des utilisateurs au myField.

==Contexte d'activation==
Une liste de tous les contextes disponible est présent sur le wiki de dolibarr:
https://wiki.dolibarr.org/index.php?title=Syst%C3%A8me_de_Hooks#Liste_des_Contexts_disponibles_dans_Dolibarr

quelque uns des plus courants
{|
|
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Fiche
| Contexte
|-
| Adhérent
| membertypecard
|-
| Catégories
| categorycard
|-
| Commandes
| ordercard
|-
| Commande fournisseur
| ordersuppliercard
|-
| Contact
| contactcard
|-
| Contrat
| contractcard
|-
| Don
| doncard
|-
| Entrepôt
| warehousecard
|-
| Expédition
| expeditioncard
|-
| Facture client
| invoicecard
|-
| Facture fournisseur
| suppliercard
|}

| style="vertical-align:top;" |
{| class="wikitable"
|- style="background-color:orange; font-weight:bold;"
| Fiche
| Contexte
|-
| Intervention
| interventioncard
|-
| Livraison
| deliverycard
|-
| Note de frais
| tripandexpensecard
|-
| Produit
| productcard
|-
| Projet
| projectcard
|-
| Proposition commerciale
| propalcard
|-
| Règlement client
| paiementcard
|-
| Règlement fournisseur
| paymentsupplier
|-
| Salaire
| salarycard
|-
| Tache
| projecttaskcard
|-
| Tiers
| thirdpartycard
|-
| Utilisateur
| usercard

|}

|}

=Questions fréquentes=
== Général ==
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 :
#Désactivez et réactivez le module,
#Vérifier sur le ChangeLog si une nouvelle version a été publiée,
#Ré-installez/mettez à jour le module,
#Vérifiez que le remplacement de fichiers natifs de Dolibarr ne soit pas nécessaire au bon fonctionnement du module.
#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 le formulaire dédié (http://docs.patas-monkey.com/support/).
Ce formulaire est le mode de contact à privilégier pour toute difficulté d'utilisation ou remontée de bug. Aussi, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet.

== Affichage d'un message en haut des pages de Dolibarr==
Si vos pages de Dolibarr affichent un message semblable à l'image suivante, il ne s'agit pas d'un message d'erreur, mais de l'affichage des contextes de la page courante. Pour ne plus voir ces lignes affichées, désactivez l'affichage du contexte
(voir Configuration).

[[file:Myfield-Message-contexte.png]]

==Message erreur d'ordonnancement==
Certaines pages de certaines versions de Dolibarr présentent un erreur dans leur code empêchant la bonne application de la personnalisation des champs. MyField permet de les identifier pour les corriger.

Le message d'erreur s'affiche en bas de page et est le suivant

[[file:myfield_Erreur-dbclose-message.png]]

En vous aidant de l'URL de la page, ouvrez le fichier du noyau de Dolibarr pour le modifier. Par exemple, si la page qui comporte le message est ''http://.../htdocs/custom/myField/admin/extrafields.php'', ouvrez successivement les dossiers ''htdocs'', ''custom'', ''myField'', ''admin'' et ouvrez le fichier ''extrafields.php''.

L'erreur vient de l'inversion des lignes ''llxFooter();'' et ''$db->close();'' en fin de fichier.

{| class="wikitable" style="width:60%;"
|- style="vertical-align:top;"
| Modifiez le code de la page pour obtenir
[[file:Erreur-dbclose-correction.png]]
| au lieu de

[[file:Erreur-dbclose.png]]
|}
==Multicompany==
Avec le module multicompany, il convient d'activer le module sur chaque entité

Extraprice/fr

2025-11-05T17:23:24Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Extraprice250x250.jpg]]
| Ce module permet de définir une règle de calcul pour la détermination du prix de vente unitaire (par exemple en prenant des paramètres supplémentaires - extrafields), cette version premium ajoute le paramétrages de valeurs personnalisées par catégories (client et produit)
|}

== Présentation ==

'''Extraprice''' est un module permettant de calculer les prix d'un produit en fonction d'un ensemble de paramètres et d'une formule de calcul personnalisables

== Pré-requis d'installation ==

Le module '''Extraprice''' fonctionne avec Dolibarr à partir de la version 3.5.x et une version de php minimum 5.3.

Il s'installe comme n'importe quel module Dolibarr en décompressant le fichier zip dans le dossier /htdocs/custom.

== Préambule – Avant de commencer ==

Avant de lancer la création d'une formule '''d'Extraprice''' , il convient d'avoir des notions de langage php et de connaître la structuration des tables de Dolibarr.
Si vous n'avez pas ce genre de compétence, vous pouvez nous contactez sur notre site ([www.patas-monkey.fr](http://www.patas-monkey.fr/)) afin que nous vous proposions une prestation d'intégration de ce module selon vos spécifications.

{{Note| Attention: La version 20.0.0 de Dolibarr contient une anomalie qui génère une erreur de calcul sur la TVA quand on utilise le bouton de recalcul des prix. Ce problème se règle en réalisant une mise à jour de dolibarr vers une version postérieur (20.0.4 ou 21.xx, ...) |warn}}

== Configuration du module Extraprice ==

La configuration du module '''Extraprice''' se fait à partir de l'écran d'administration accessible depuis la liste des modules.

[[File:Extraprice-setting.png |900px]]

La première zone de saisie permet de paramétrer la formule de calcul qui sera utilisée pour déterminer les prix de vente unitaires.

Autre fonctionnalité du module, il est possible de définir un ou plusieurs produit/service pour saisir la TVA pour les société de transport
|}

== Fonctionnement du calcul du prix dynamique ==

Il n'est pas possible dans Dolibarr d'avoir un prix conditionné par autre chose que la quantité du produit vendu.

'''Extraprice''' permet de modifier, lors de la création des lignes de pièces (commande, facture et proposition commerciale), le prix de vente unitaire.

Pour cela, '''Extraprice''' utilise :

- des valeurs présentes dans les différentes fiches (client, produit, pièces…)
- des valeurs présentes dans des champs supplémentaires (« extrafields ») et en particulier ceux présents sur les lignes de pièces.
- Une formule de calcul écrite en php dans le paramétrage du module.

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:250px;" | '''Options en paramétrage du module'''
! style="vertical-align:top; width:250px;" | '''Résultat sur facture'''
|-
| style="vertical-align:top;" |
[[File:Extraprice-exemple_php_line_request.png |250px]]
| style="vertical-align:top;" |
[[File:Extraprice-exemple_result.png |250px]]
|}

=== Remarque ===

La version premium d'extraprice permet d'ajouter des variables aux formules de calculs selon la catégorie cliente ou produit.

Ex : il est possible de créer un coefficient de remise par catégorie client qui sera utilisé pour le calcul final du prix de vente unitaire. il faut pour cela créer des catégories produits, d'affecter sur l'onglet d'extraprice de la catégorie une valeur à une variable (ex $coef=0.55 ) et puis d'utiliser celle-ci dans le calcul final

=== Saisie d'une formule de calcul ===

Définition des variables utilisables dans la formule d'extraprice.

{| class="wikitable"
|- style="vertical-align:top;"
| '''$newprice'''
| Prix calculé par la formule
|- style="vertical-align:top;"
| '''$origineprice'''
| Prix d'origine du produit, ATTENTION si on est sur un produit ou service libre, cette valeur sera à zéro (il faudra saisir le prix de base pour le calcul ailleurs).

|- style="vertical-align:top;"
| '''$objectvalue'''
| Objet contenant les champs supplémentaires associés à la ligne de la pièce
Ex : pour accéder à la valeur définie dans le champ 'longueur',
il faut utiliser la variable $objectvalue['options_longueur']
|- style="vertical-align:top;"
| '''$product'''
| Objet contenant les valeurs associées au produit (référence, description...)
Exemple de valeurs :
* $product['price_min'] (prix minimum) sera récupéré par la variable $product->price_min
* $product['ref'] pour récupérer/tester la référence du produit|
Attention : cette objet n'est présent que si il s'agit d'un prix défini à partir d'un produit (pas une saisie libre)
|- style="vertical-align:top;"
| '''$mainelement'''
| Objet contenant les valeurs associées à la pièce (facture, commande, proposition commerciale)
|- style="vertical-align:top;"
| '''$societe'''
| Objet contenant les valeurs associées à la société de la pièce (le destinataire de la facture)
|- style="vertical-align:top;"
| '''$object'''
| Objet contenant les valeurs associées à ligne de la pièce (facture, commande ou propale)
|- style="vertical-align:top;"
| '''$elementextravalue'''
| Objet contenant les champs supplémentaire associé à la pièce (facture, commande, proposition commerciale)
|- style="vertical-align:top;"
| '''$societeextravalue'''
| Objet contenant les champs supplémentaires associés à la société
Ex : pour accéder à une valeur définie dans le champ "coeff", il faut utiliser la variable $societeextravalue['options_coeff']
|- style="vertical-align:top;"
| '''$productextravalue'''
| Objet contenant les champs supplémentaires associés au produit
Ex : pour accéder à une valeur définie dans le champ "coeff", il faut utiliser la variable $productextravalue['options_coeff']
|- style="vertical-align:top;"
| '''$categsocieteid'''
| contient l'identifiant de la catégorie de société auquel appartient la société
|- style="vertical-align:top;"
| '''$categproductid'''
| contient l'identifiant de la catégorie de produit auquel appartient le produit
|}

il est possible d'avoir des constantes en passant par la configuration/Divers de Dolibarr
il suffit pour cela de définir une variable et sa valeur
La valeur saisie peut être récupérée avec la $conf->global->LA_VARIABLE_DIVERSE

=== Exemple : Détermination du prix d'un produit selon la surface vendue ===

Un produit a un prix fixé au mètre carré.

Nous ajoutons 2 champs supplémentaires (extrafields) nommés « longueur » et « largeur » correspondant aux dimensions de la surface vendue.

Dans ce cas, le prix de vente du produit correspond au prix au m² multiplié par la longueur et la largeur

Pour un produit à 100 € le mètre carré, si on vend une surface de 50 cm de long par 25 cm de large, le prix sera de 12,50 € l'unité (100 x 0,25 x 0,50)

Il est possible de rajouter un coût spécifique de découpe par produit selon, par exemple, sa matière : plastique, verre…

Dans ce cas, il sera nécessaire de rajouter un « extrafield » sur le produit pour stocker la donnée du coût unitaire de la découpe qui sera ajouté au prix de vente unitaire dans la formule.

Pour un produit à 100 € le mètre carré, et une découpe à 20, si on vend une surface de 50 cm de long par 25 cm de large, le prix sera de 32,50 € l'unité (20 + 100 x 0,25 x 0,50)

== TVA transporteur sur facture fournisseur ==

Il est également possible d’ajouter manuellement une TVA fournisseur en définissant le prix hors taxes (P.U. HT) correspondant à la TVA souhaitée.

Pour cela :

Créer un nouveau service avec comme libellé la TVA souhaitée.

Une fois le service créé, l’ajouter dans le paramétrage du module.

Lors de la création d’une facture fournisseur, vous pourrez désormais ajouter ce service « TVA » et lui attribuer sa valeur monétaire exacte dans le champ P.U. HT.

[[File:Extraprice-tva-transport.png|800px]]

Translations:MyField/21/fr

2025-11-05T17:23:18Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

====Permissions par défaut====
{| class="wikitable"
| [[file:myfield-Permissions-defaut.png|600px]]
| style="vertical-align:top;" |
Les permissions par défaut ('''Accueil > Utilisateurs et groupe > Choisir entre utilisateurs ou groupe > Sélectionner les autorisations'''), accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe, sont les suivantes
|}

Extraprice/en

2025-11-05T17:23:12Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Extraprice250x250.jpg]]
| This module allows you to define a calculation rule for determining the unit selling price (for example, by taking additional parameters - extrafields). This premium version adds the ability to configure custom values by category (customer and product).
|}


== Presentation ==

'''Extraprice''' is a module for calculating the prices of a product based on a set of customizable parameters and a calculation formula


== Installation Prerequisites ==

The '''Extraprice''' module works with Dolibarr from version 3.5.x and a minimum php version of 5.3.

It is installed like any Dolibarr module by unzipping the zip file into the /htdocs/custom folder.


== Preamble – Before you begin ==

Before starting to create an Extraprice formula, you should have some knowledge of PHP and be familiar with Dolibarr's table structure.
If you don't have this type of expertise, you can contact us on our website ([www.patas-monkey.fr](http://www.patas-monkey.fr/)) so that we can offer you a service to integrate this module according to your specifications.

{{Note| Warning: Dolibarr version 20.0.0 contains an anomaly that generates a VAT calculation error when using the price recalculation button. This problem can be resolved by updating Dolibarr to a later version (20.0.4 or 21.xx, ...) |warn}}


== Configuration of the Extraprice module ==

The configuration of the '''Extraprice''' module is done from the administration screen accessible from the list of modules.

[[File:Extraprice-setting_en.png |900px]]

The first input area allows you to configure the calculation formula that will be used to determine the unit sales prices.

Another feature of the module is that it is possible to define one or more products/services to collect VAT for transport companies.
|}


== How dynamic price calculation works ==

It is not possible in Dolibarr to have a price conditioned by anything other than the quantity of the product sold.

'''Extraprice''' allows you to modify the unit sales price when creating the part lines (order, invoice and commercial proposal).

For this, '''Extraprice''' uses:

- values present in the various records (customer, product, parts, etc.)
- values present in additional fields ("extrafields"), particularly those present on the part lines.
- a calculation formula written in PHP in the module's settings.

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:250px;" | '''Module configuration options'''
! style="vertical-align:top; width:250px;" | '''Result on invoice'''
|-
| style="vertical-align:top;" |
[[File:Extraprice-exemple_php_line_request.png |250px]]
| style="vertical-align:top;" |
[[File:Extraprice-example_result_en.png |250px]]
|}


=== Note ===

The premium version of extraprice allows you to add variables to calculation formulas based on customer or product category.

Ex: it is possible to create a discount coefficient per customer category which will be used for the final calculation of the unit sales price. To do this, you must create product categories, assign a value to a variable on the extraprice tab of the category (e.g. $coef=0.55) and then use this in the final calculation.


=== Entering a calculation formula ===

Definition of variables that can be used in the extraprice formula.

{| class="wikitable"
|- style="vertical-align:top;"
| '''$newprice'''
| Price calculated by the formula
|- style="vertical-align:top;"
| '''$origineprice'''
| Original price of the product. NOTE: If the product or service is a free product, this value will be zero (the base price must be entered elsewhere for calculation).

|- style="vertical-align:top;"
| '''$objectvalue'''
| Object containing the additional fields associated with the part line.
Example: To access the value defined in the 'length' field,
use the variable $objectvalue['options_allonge']
|- style="vertical-align:top;"
| '''$product'''
| Object containing the values associated with the product (reference, description, etc.)
Example values:
* $product['price_min'] (minimum price) will be retrieved by the variable $product->price_min
* $product['ref'] to retrieve/test the product reference. |
Note: This object is only present if the price is defined from a product (not a free entry).
|- style="vertical-align:top;"
| '''$mainelement'''
| Object containing the values associated with the document (invoice, order, proposal)
|- style="vertical-align:top;"
| '''$company'''
| Object containing the values associated with the document's company (the invoice recipient)
|- style="vertical-align:top;"
| '''$object'''
| Object containing the values associated with the document line (invoice, order, or proposal)
|- style="vertical-align:top;"
| '''$elementextravalue'''
| Object containing the additional fields associated with the document (invoice, order, proposal)
|- style="vertical-align:top;"
| '''$societeextravalue'''
| Object containing the additional fields associated with the company.
Example: To access a value defined in the "coeff" field, use the variable $societeextravalue['options_coeff']
|- style="vertical-align:top;"
| '''$productextravalue'''
| Object containing the additional fields associated with the product.
Example: To access a value defined in the "coeff" field, use the variable $productextravalue['options_coeff']
|- style="vertical-align:top;"
| '''$categsocieteid'''
| Contains the identifier of the company category to which the company belongs.
|- style="vertical-align:top;"
| '''$categproductid'''
| Contains the identifier of the product category to which the product belongs.
|}

It is possible to create constants by going through Dolibarr's configuration/Miscellaneous.
To do this, simply define a variable and its value.
The entered value can be retrieved with $conf->global->LA_VARIABLE_DIVERSE.


=== Example: Determining the price of a product based on the surface area sold ===

A product has a fixed price per square meter.

We add 2 additional fields (extrafields) named “length” and “width” corresponding to the dimensions of the surface sold.

In this case, the selling price of the product corresponds to the price per m² multiplied by the length and width

For a product at €100 per square meter, if we sell a surface 50 cm long by 25 cm wide, the price will be €12.50 per unit (100 x 0.25 x 0.50)

It is possible to add a specific cutting cost per product depending, for example, on its material: plastic, glass, etc.

In this case, it will be necessary to add an “extrafield” on the product to store the data of the unit cost of the cut which will be added to the unit sales price in the formula.

For a product at €100 per square meter, and a cut at €20, if we sell a surface 50 cm long by 25 cm wide, the price will be €32.50 per unit (20 + 100 x 0.25 x 0.50)


== Carrier VAT on supplier invoice ==

<div lang="fr" dir="ltr" class="mw-content-ltr">
Il est également possible d’ajouter manuellement une TVA fournisseur en définissant le prix hors taxes (P.U. HT) correspondant à la TVA souhaitée.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Pour cela :
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Créer un nouveau service avec comme libellé la TVA souhaitée.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Une fois le service créé, l’ajouter dans le paramétrage du module.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
Lors de la création d’une facture fournisseur, vous pourrez désormais ajouter ce service « TVA » et lui attribuer sa valeur monétaire exacte dans le champ P.U. HT.
</div>

[[File:Extraprice-tva-transport_en.png|800px]]

Translations:Extraprice/43/fr

2025-11-05T17:23:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Lors de la création d’une facture fournisseur, vous pourrez désormais ajouter ce service « TVA » et lui attribuer sa valeur monétaire exacte dans le champ P.U. HT.

Translations:Extraprice/42/fr

2025-11-05T17:23:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Une fois le service créé, l’ajouter dans le paramétrage du module.

Translations:Extraprice/41/fr

2025-11-05T17:23:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Créer un nouveau service avec comme libellé la TVA souhaitée.

Translations:Extraprice/40/fr

2025-11-05T17:23:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Pour cela :

Translations:Extraprice/39/fr

2025-11-05T17:23:07Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Il est également possible d’ajouter manuellement une TVA fournisseur en définissant le prix hors taxes (P.U. HT) correspondant à la TVA souhaitée.

Translations:MyDiscount/8/fr

2025-11-05T17:23:04Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

Après la création d'une commande, d'une proposition commerciale ou d'une facture, la remise peut être accordée.

[[File:MyDiscount_CreationDiscount1-250x250.png |750px]]

ExtraECM/en

2025-11-05T17:22:56Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
<div class="mw-translate-fuzzy">
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:ExtraECM-250x250.png]]
|ExtraECM enhances native document management (EDM) by adding file selection and export to a ZIP file and document filtering based on creation date.
|}
== Configuration ==
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
== Configuration ==
</div>

The module has no configuration, you just need to install and activate it to be operational.


== Access to the module application ==

The module adds an additional tab to the native EDM which replicates the operation of the native document management tab

[[File:ExtraEcm_MainPage_en.png |750px]]


== Filtering on document date ==

An input box above the document date column allows you to filter the document creation date.

{| class="wikitable"
|- style="background-color: orange; font-weight: bold;"
| Date
|
|-
|2018
| all dates in 2008 from 01/01 to 31/12 inclusive
|-
|202008
| all dates in August 2020
|-
| 2016-2019
| all dates from 01/01/2006 to 31/12/2009 inclusive
|-
| >2004
| all dates greater than (or equal to) 01/01/2004
|-
| 20250401
| All items corresponding to the day entered in YYMMDD format
|}


== Selection and export of documents ==

Exporting documents is a two-step process.
* Select the documents you wish to retrieve by checking the box in front of them. You can check/uncheck all the boxes using the check mark in the column header.
* Click the export button in the column header.

A zip file containing the selected documents is then created and automatically downloaded

ExtraECM/fr

2025-11-05T17:22:54Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:ExtraECM-250x250.png]]
|ExtraEcm enrichie la gestion des documents native (GED) en ajoutant la sélection et l'export de fichiers dans un fichier zip et le filtrage des documents selon leur date de création.
|}
<youtube>Edh4mDY8j9k</youtube>

== Configuration ==

Le module n'a pas de configuration, il suffit juste de l'installer et de l'activer pour qu'il soit opérationnel

== Accès à l'application module ==

Le module ajoute un onglet supplémentaire à la GED native qui reprend le fonctionnement de l'onglet de gestion native des documents

[[File:ExtraEcm_MainPage.png |750px]]

== Filtrage sur la date du document ==

Une zone de saisie au dessus de la colonne des dates des documents permet de filtrer la date de création des documents.

{| class="wikitable"
|- style="background-color: orange; font-weight:bold;"
| Date
|
|-
|2018
| toutes les dates de 2008 du 01/01 au 31/12 inclus
|-
|202008
| toutes les dates du mois d'aout 2020
|-
| 2016-2019
| toutes les dates du 01/01/2006 au 31/12/2009 inclus
|-
| >2004
| toutes les dates supérieures (ou =) au 01/01/2004
|-
| 20250401
| Tous les éléments correspondant au jour saisi au format AAAMMJJ
|}

== Selection et export de documents ==

L'export des documents se déroule en deux étapes.
* La sélection des documents que l'on souhaite récupérer cochant la case devant celui-ci. Il est possible de cocher/décocher l'ensemble des cases en utilisant la coche présente sur l'entête de colonne.
* L'appuie sur le bouton d'exportation dans l'entête de colonne.

Un fichier zip contenant les documents sélectionnés est alors crée et automatiquement téléchargé

Translations:ExtraECM/12/fr

2025-11-05T17:22:51Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

== Configuration ==

Translations:ExtraECM/1/fr

2025-11-05T17:22:51Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

{| class="wikitable"
|- style="vertical-align:top;"
| [[File:ExtraECM-250x250.png]]
|ExtraEcm enrichie la gestion des documents native (GED) en ajoutant la sélection et l'export de fichiers dans un fichier zip et le filtrage des documents selon leur date de création.
|}
<youtube>Edh4mDY8j9k</youtube>

DoliSmart/fr

2025-11-05T17:22:45Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Dolismart.png|300px]]
| DoliSmart permet d'accéder aux données de votre dolibarr depuis un smartphone (iOS ou Android).
Les données présentés sur le Smartphone sont personnalisables :
* Sélection des widgets sur les écrans principaux,
* Sélection des colonnes sur les listes de recherches selon la largeur de l'écran
* Sélection des champs sur les écrans de détail et personnalisation de ceux-ci (changement de libellé, surlignage, mise en gras)

Les données sont accessibles non seulement en fonction des habilitations natives définies pour les utilisateurs mais aussi spécifiquement pour chaque champs et autres widgets

L'interface est intuitive et permet de naviguer entre les éléments de Dolibarr (éléments liés clickable), d'accéder aux documents associé aux pièces en utilisant une ergonomie adapté à un smartphone.

Il est enfin possible de saisir des notes associées à un éléments, de signer les interventions et les expéditions, d'envoyer un email depuis dolibarr (ou le smartphone)

|}
<youtube>75ECrxNu_3Y</youtube>
==Présentation==
L'ensemble de cette solution se décompose en trois parties :

* un module à installer dans votre dolibarr (comme n'importe quel module) permettant de personnaliser les affichages de la seconde partie. Ce module est à commander sur le dolistore et vous donne accès aux mise à jour de ce module durant 3 ans : https://www.dolistore.com/product.php?id=2464
* une application pour smartphone (ios ou android) permettant d'accéder aux données de votre Dolibarr selon les habilitations de l'utilisateur identifié sur l'application et le paramétrage défini dans le module. Les applications sont disponibles sur les plateformes Apple et Androit
* Un abonnement annuel à commander sur notre boutique : https://dolismart.com/index.php/boutique/

Si vous avez besoin de plusieurs licences, vous pouvez nous contacter afin d'avoir un tarif par volume préférentiel

Les communications entre les deux éléments se font via les api natives de Dolibarr mais aussi des api spécifiques présente dans le module.

L'application Smartphone récupère le thème natif de dolibarr ou celui que vous avez défini sur votre environnement.

Il est enfin possible d'accéder depuis la même interface à plusieurs Dolibarr (ou un meme dolibarr avec plusieurs profils utilisateur). Attention cette fonctionnalité est limité à 3 environnements/profil.

==Paramétrage dans Dolibarr ==

Pour permettre à Dolibarr de communiquer avec l'applicaiton mobile, il est nécessaire d'activer le modules des api natives.

[[file:dolibarr_pré_para_api.png|600px]]

Le module DoliSmart apportant aussi un ensemble d'API nécessaire à l'application mobile il convient de l'activer aussi.

[[file:dolibarr_pré_para_dolismart.png|600px]]

== Paramétrage des utilisateurs ==

Pour permettre à un utilisateur d'accéder depuis l'application DoliSmart de son smartphone, il convient de réaliser un ensemble de actions sur le compte de ce dernier

=== Génération d'une clée API pour l'utilisateur ===
Une fois le module de gestion des api rest activer, il faut sélectionner l'utilisateur que l'on souhaite utiliser pour se connecter depuis l'application mobile et générer pour celui-ci un token d'identification.

[[file:dolibarr_utilisateur_géné_api.png|600px]]

=== Gestion des habilitations de l'utilisateur ===

L'accès aux habilitations de l'utilisateur s'effectue depuis l'onglet des permissions de sa fiche

[[file:dolibarr_utilisateur_permission_utilisateur.png|600px]]

il convient de vérifier plusieurs habilitations pour l'utilisation à savoir :

* l'accès à ses habilitations

[[file:dolibarr_utilisateur_habilitation.png|600px]]

* l'accès à la GED pour lui permettre à la fois d'accéder aux documents, mais aussi d'uploader des documents depuis le smartphone dans l'élément

[[file:dolibarr_permission_utilisateur_doc.png|600px]]

== Mise à jour / corechange de Dolibarr ==
DoliSmart est compatible avec Dolibarr depuis la version 18 mais pour les versions antérieur à la V22, il est nécessaire de mettre à jour votre dolibarr avec les fichiers présent dans le dossier Corechange présent dans les répertoires du modules.

Pour cela copier les fichiers présent dans le dossier corechange de l'application directement dans le dossier htdocs de votre dolibarr.

Certaines fonctionnalités, comme la recherche d'une facture à partir du nom du tiers, peuvent ne pas fonctionner sur une version antérieure à la 22.

{{Note|Après chaque mise à jour du module '''Dolismart''', il est nécessaire de le '''désactiver puis de le réactiver''' afin d’assurer son bon fonctionnement.}}

==Configuration du module Dolismart==
Dans les paramétrages de '''Dolismart''' vous trouverez 4 onglet :

===Configuration générale===

Il s'agit d'un onglet dédiés à l'ensemble des éléments de l'application mobile, principalement le nombre d'enregistrement affiché ou une sélection par défaut

[[file:dolismart_para_configuration.png|600px]]

===Configuration des Pages d'accueil===
A la manière des espaces dans dolibarr, l'application doliSmart à une page regroupant les informations propre à un unique élément (espace des tiers, des produits, des factures, ...).

Cette page d'accueil contient une zone de recherche et un ensemble de widget que l'on peu décider d'afficher ou non.

Cette sélection s'effectue depuis la configuration des pages d'accueil.

Il est nécessaire de sélectionner dans un premier temps l'élément que l'on souhaite configurer, puis dans un second temps activer ou non les widgets.

Il est aussi possible de n'autoriser l'accès d'un widget à un ensemble de personne (sélection individuelle) ou à un groupe d'utilisateur défini dans dolibarr.

Attention, la gestion des habilitations d'accès nécessite de sauvegarder la ligne avec l'icone de sauvegarde verte en bout de ligne.

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:600px;" | '''Choix d'indexation pour la page d'acceuil'''
! style="vertical-align:top; width:600px;" | '''Options d'affichage'''
|-
| style="vertical-align:top;" |
[[file:dolismart_para_page_acceuil.png|600px]]
| style="vertical-align:top;" |
[[file:dolismart_para_page_acceuil-01.png|600px]]
|}

===Configuration des Listes de recherche===
Il est possible de configurer les '''champs''' qui seront affiché lors de la recherche, à l'écran de l'application '''Dolismart''' en fonction de la page d'index choisi.

Ainsi que le parametrage d'affichage (SI CHAMP ACTIF : Renomer le champ / choix d'alignement & largeur / positionnement).

Accord d'accès '''Utilisateurs''' & '''Groupe d'utilisateur'''.

Si une modification y est apportée, ne pas oublier d'enregistrer la modification à la fin de la ligne.

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:600px;" | '''Options d'affichage'''
! style="vertical-align:top; width:600px;" | '''Exemple d'affichage'''
|-
| style="vertical-align:top;" |
[[file:dolismart_para_page_liste_de_recherche-01.png|600px]]
| style="vertical-align:top;" |
[[file:dolismart_exemple_liste_de_recherche.gif]]
|}

===Configuration des Pages de détails===
Il est possible de configurer les '''champs''' qui seront affiché à l'écran de l'application '''Dolismart''' en fonction de la page d'index choisi.

Ainsi que le parametrage d'affichage (SI CHAMP ACTIF : Renomer le champ / Texte en gras / Couleur).

Accord d'accès '''Utilisateurs''' & '''Groupe d'utilisateur'''.

Si une modification y est apportée, ne pas oublier d'enregistrer la modification à la fin de la ligne.

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:600px;" | '''Options d'affichage'''
|-
| style="vertical-align:top;" |
[[file:dolismart_para_page_page_de_détail-01.png|600px]]
|}

==Écrans de l'application mobile==
=== Écran d'accueil ===
{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:300px;" | '''Menu principal structuré'''
! style="vertical-align:top; width:300px;" | '''Accès personnalisé selon les droits utilisateur'''
! style="vertical-align:top; width:300px;" | '''Interface visuelle personnalisable'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_acceuil.png|300px]]
 
Le menu de '''DoliSmart''' est organisé en sections, reprenant la structure de Dolibarr : espace des tiers, des produits, des factures, etc.
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_acceuil_habilitation_modif.png|300px]]
 
Comme mentionné précédemment, l'écran d'accueil s'adapte en fonction des '''droits d'accès de l'utilisateur'''. Chaque utilisateur voit uniquement les modules et informations auxquels il est autorisé à accéder.
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_acceuil_theme.png|300px]]
 
Les '''couleurs de l’interface''' s’ajustent automatiquement selon la personnalisation visuelle de votre instance Dolibarr, assurant une cohérence avec votre environnement habituel.
|}

=== Écran de paramétrage ===

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:300px;" | '''Menu de paramétrage'''
! style="vertical-align:top; width:300px;" | '''Détail des comptes'''
! style="vertical-align:top; width:300px;" | '''Détail du compte'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_parametrage.png|300px]]
 
Le menu de paramétrage de '''DoliSmart''' vous permet de visualiser la session actuellement active, ou de vous connecter à une nouvelle instance Dolibarr.
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_parametrage_details_comptes.png|300px]]
 
Cet onglet permet de consulter les sessions enregistrées (maximum 3), de les supprimer, d’en ajouter de nouvelles ou de modifier les existantes.
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_parametrage_nouvelle_connection.png|300px]]
 
Cet onglet affiche les informations liées au compte sélectionné : le nom personnalisé (ou celui par défaut), l’URL de connexion à l’instance Dolibarr, ainsi que les identifiants de connexion (nom d’utilisateur et mot de passe).
|}

=== Icônes présentes dans l'application DoliSmart ===

L’application '''DoliSmart''' intègre des icônes dans différents menus pour simplifier la navigation, offrir une meilleure lisibilité et permettre des actions rapides. Ces icônes visuelles servent de repères pour représenter des fonctions, des types de données ou des raccourcis vers des interactions fréquentes.

Les icônes sont utilisées de manière cohérente dans plusieurs sections de l'application.

{| class="wikitable" style="width:100%; text-align:center"
|-
| style="vertical-align:top; width:50%" |

====Icônes des écrans des espaces====
{| class="wikitable" style="text-align:center; width:100%"
! Icône !! Fonction !! Description
|-
| [[File:app_icons_014.png|40px]] || NB (Nombre) || Nombre de vente
|-
| [[File:app_icons_015.png|40px]] || HT (Hors Taxes) || Montant calculé hors taxes
|-
| [[File:app_icons_016.png|40px]] || TTC (Toutes Taxes Comprises) || Montant final facturable avec taxes
|-
| [[File:app_icons_005.png|40px]] || Adresse / Google Maps || Lien cliquable vers Google Maps avec l’adresse renseignée
|-
| [[File:app_icons_006.png|40px]] || Téléphone || Lance un appel si un numéro est renseigné (sur mobile)
|-
| [[File:app_icons_007.png|40px]] || Mail (application native) || Ouvre l’application de messagerie du téléphone
|-
| [[File:app_icons_008.png|40px]] || Client || Désigne un client confirmé
|-
| [[File:app_icons_009.png|40px]] || Prospect || Tiers en phase de prospection commerciale
|-
| [[File:app_icons_010.png|40px]] || Fournisseur || Désigne un fournisseur (achat, logistique…)
|-
| [[File:app_icons_011.png|40px]] || Totalité des éléments || Vue de la totalité des éléments
|-
| [[File:app_icons_012.png|40px]] || Calendrier annuel || Vue filtrée ou triée par année
|-
| [[File:app_icons_013.png|40px]] || Trimestre || Regroupement par trimestre (Q1, Q2, etc.)
|-
| [[File:app_icons_filtres.png|40px]] || Filtre Etats & Période || Brouillons ; Signée ; Année ; Trimestre ; etc...
|-
| [[File:app_icons_creation_intervention.png|40px]] || Création d'une intervention || Tier ; Customer ref & Description
|-
| [[File:app_icons_recherche.png|40px]] || Zone de recherche || Entête de recherche lié à l'espace dans lequel vous vous situez
|}
| style="vertical-align:top; width:50%" |

====Icônes des écrans de détails====
{| class="wikitable" style="text-align:center; width:100%"
! Icône !! Signification !! Description
|-
| [[File:app_icons_001.png|40px]] || Calendrier || Aperçu des événements associés au tiers (évènements, taches, rendez-vous…)
|-
| [[File:app_icons_contact.png|40px]] || Contact || Gestion des contacts/adresses, utilisateurs et contacts associés à l'éléments
|-
| [[File:app_icons_002.png|40px]] || Mail via Dolibarr || Envoie un email via l’interface de messagerie Dolibarr intégrée (en attente)
|-
| [[File:app_icons_document.png|40px]] || Documents / Pièces jointes || Accès aux fichiers liés & upload de fichier
|-
| [[File:app_icons_notes.png|40px]] || Notes || Accès et modification des notes publiques et privées (si sélectionnée et modification autorisée)
|-
| [[File:app_icons_actionburger.png|40px]] || Action || Action associée à l'élément (signature, mise à jour status,...)
|-
| [[File:app_icons_actions.png|40px]] || Actions || Action sur l'élément en question (Clone, Validation, Modification en fonction du statut)
|-
| [[File:app_icons_ajout_ligne.png|40px]] || Actions d'ajout || Action d'ajout (Date de début, Durée, Description)
|-
| [[File:app_icons_modif_ligne.png|40px]] || Actions de modification || Action de modification (Date de début, Durée, Description)
|-
| [[File:app_icons_vue_de_ligne.png|40px]] || Détails || Ouvre le détail de la ligne en question
|}
|}

Ces icônes sont également visibles dans d'autres contextes comme les bons de commande, les factures ou les rapports commerciaux.

----

''L’uniformité visuelle des icônes dans DoliSmart permet de naviguer efficacement, tout en réduisant le temps d’apprentissage de l’application.''

=== Ecrans d'espace d'un élément ===
Les écrans d'espace se présentent tous avec le meme format
{| class="wikitable"
! style="vertical-align:top; width:300px;" | '''Exemple d'écran'''
! style="vertical-align:top; width:600px;" | '''Elements présent dans un écran d'espace'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_page_element.png|300px]]
 
Le menu de '''DoliSmart''' est organisé en sections, reprenant la structure de Dolibarr : espace des tiers, des produits, des factures, etc.
| style="vertical-align:top;" |
* 1 : Retour au home page de Dolismart
* 2 : Zone de recherche des éléments
* 3 : Zone de filtrage d'un tableau incluant le graphique
* 4 : Zone de filtrage d'un tableau par période (tous, année, trimestre)
* 5 : Éléments clickable pour accéder à son détail
* 6 : Navigation sur les autres éléments du menu
 
Comme mentionné précédemment, l'écran des espaces s'adaptent en fonction du paramétrage définie dans le module DoliSmart.
|}

===Ecrans de recherche===
Les écrans de recherche se présentent tous avec le meme format
{| class="wikitable"
! style="vertical-align:top; width:300px;" | '''Exemple d'écran de recherche'''
! style="vertical-align:top; width:600px;" | '''Elements présent dans un écran de recherche'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_page_recherche.png|300px]]
 
Le menu de '''DoliSmart''' est organisé en sections, reprenant la structure de Dolibarr : espace des tiers, des produits, des factures, etc.
| style="vertical-align:top;" |
* 1 : Retour au home page de Dolismart
* 2 : Zone de recherche des éléments
* 3 : Icone de filtrage & options
* 4 : Accès à la Fiche de l'élément
* 5 : Accès à la Fiche du tiers attaché à l'élément (si un tiers est associé)
* 6 : Navigation sur les autres éléments du menu

|}

===Ecrans de détail d'un élément ===
Les écrans de détails se présentent tous avec le meme format
{| class="wikitable"
! style="vertical-align:top; width:300px;" | '''Exemple d'écran de détails'''
! style="vertical-align:top; width:600px;" | '''Elements présent dans un écran de détails'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_page_détails.png|300px]]
| style="vertical-align:top;" |
* 1 : Retour au home page de Dolismart
* 2 : Retour à la page précédente
* 3 : Popup correspondant aux Onglets de l'éléments (ici agenda et documents joints)
* 4 : État de l'éléments
* 5 : Fiche du Tier liée
* 6 : Fiche produit
* 7 : Fiche service
* 8 : Icone d'apperçue
* 9 : Fiche règlement
* 10 : Navigation sur les autres éléments du menu
 
Comme mentionné précédemment, l'écran de détails s'adapte en fonction des '''droits d'accès de l'utilisateur'''. Chaque utilisateur voit uniquement les modules et informations auxquels il est autorisé à accéder.
|}

====Boutons d'actions d'un élément ====
Selon l'élément affiché ET les droits associé à l'utilisateur, il y a un bouton d'action ouvrant un menu présentant un ensemble d'actions disponible.

La première partie du menu déclenche une action directe, la seconde ouvre une secondre fenetre d'action (pour signer l'intervention par exemple).
{| class="wikitable"
! style="vertical-align:top; width:300px;" | '''Elements'''
! style="vertical-align:top; width:600px;" | '''Action(s) disponible(s)'''
|-
| style="vertical-align:top;" |
Interventions
| style="vertical-align:top;" |
* Valider - Réouvrir - Clôturer
* Signer
|-
| style="vertical-align:top;" |
Contrat
| style="vertical-align:top;" |
* Valider - Clôturer
|-
| style="vertical-align:top;" |
Devis
| style="vertical-align:top;" |
* Valider - Clôturer - Retour en brouillon - Classé Facturé
* Accepté - Refusé
|-
| style="vertical-align:top;" |
Commande
| style="vertical-align:top;" |
* Valider - Réouvrir - Clôturer - Retour en brouillon - Classé Facturé
|-
| style="vertical-align:top;" |
Facture
| style="vertical-align:top;" |
* Valider - Retour en brouillon
* Payer
|-
| style="vertical-align:top;" |
Expéditions
| style="vertical-align:top;" |
* Valider - Clôturer
* Signer
|}

== Sections de DoliSmart==
=== Section des Tiers (Espace Tiers et Contacts)===

Cette section contient à la fois les Tiers de Dolibarr mais aussi leurs contacts.

{| class="wikitable"
! style="vertical-align:top; width:400px;text-align:center"| Espace Tiers
! style="vertical-align:top; width:300px;" | '''Détails des Tiers'''
! style="vertical-align:top; width:400px;" | '''Elements présent dans un écran de détails des Tiers'''
|-
| style="vertical-align:top;" |
* Zone de recherche des tiers
* Tableau trimestriels des nouveaux tiers
** bouton de sélection par client, prospect ou fournisseur
* graphique mensuel des nouveaux tiers
* Top clients
** bouton de sélection par totalité de la période, l'année ou le trimestre en cours
* Derniers clients mis à jour
* Encours Clients
| style="vertical-align:top;" |
[[File:dolismart_app_tiers_page_tiers_03.png|300px]]
| style="vertical-align:top;" |
* 1 : Retour au home page de Dolismart
* 2 : Retour à la page précédente
* 3 : Popup correspondant aux Onglets de l'éléments (ici agenda et documents joints)
* 4 : Coordonné du Tier (adresse ; telephone ; email accessible depuis le smartphone)
* 5 : État de l'éléments
* 6 : tableau d'éléments associé à l'élément (ici les contacts du Tiers)
* 7 : Contact/Adress du Tier
* 8 : Facture associé au Tier
* 9 : Navigation sur les autres éléments du menu
 
Comme mentionné précédemment, l'écran de détails s'adapte en fonction des '''droits d'accès de l'utilisateur'''. Chaque utilisateur voit uniquement les modules et informations auxquels il est autorisé à accéder.
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Contact
! style="vertical-align:top; width:450px;text-align:center"| Détail Contact
|-
| style="vertical-align:top;" |
* Zone de recherche des contacts
* Tableau trimestriels des nouveaux contacts
* Graphique mensuel des nouveaux contacts
* Derniers contacts mis à jour avec la fiche contact et leur tier associé.
| style="vertical-align:top;" |
* Tableau d'information du Contact
** Popup Évènements
** Popup Documents
* Ligne de détail
|}

===Section des Produits (Espaces Produits et Services)===

Cette section regroupe à la fois les produits et les services.

Attention la gestion des stocks et des expéditions que l'on retrouve dans le menu produits de Dolibarr se trouve dans un autre espace de DoliSmart

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Produits
! style="vertical-align:top; width:450px;text-align:center"| Détail Produit
|-
| style="vertical-align:top;" |
* Zone de recherche des produits.
* Tableau des dernier produits mis à jours.
* Tableau des top produits.
| style="vertical-align:top;" |
* Bandeau d'information
** Popup Évènements
** Popup Documents
* Ventes facturés du produit par trimestre (nombre de vente, quantités vendues, montant ttc)
* Graphique mensuel des ventes du produit.
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Services
! style="vertical-align:top; width:450px;text-align:center"| Détail Service
|-
| style="vertical-align:top;" |
* Zone de recherche des services.
* Tableau des dernier services mis à jours.
* Tableau des top services.

| style="vertical-align:top;" |
* Bandeau d'information
** Popup Évènements
** Popup Documents
* Nombre de vente facturé du produit par trimestre (nombre, quantité, montant ttc)
* Graphique mensuel des ventes du service.
|}

===Section Entrepôts (Espace des Entrepôts et des Expéditions)===

Cette section, se trouvant dans Dolibarr parmi celle des produits, a été séparée pour plus de lisibilité

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Entrepôt
! style="vertical-align:top; width:450px;text-align:center"| Détail Entrepôt
|-
| style="vertical-align:top;" |
* Zone de recherche des entrepôts.
* Liste des dernier entrepôts mis à jours.
* Tableau de mouvement de stock par trimestre avec filtrage.
** Par nombre.
** Par quantité.
** Par montant de la valeur mouvement.
* Graphique mensuel des mouvement de stock
* Tableau des top produits.

| style="vertical-align:top;" |
* Tableau d'information de l'entrepôt.
* Popup Évènements

* Tableau de mouvement de stock de l'entrepôt par trimestre avec filtrable par le nombre de mouvement, quantité et valorisation.
* Graphique mensuel des mouvement de stock de l'entrepôt.
* Tableau des produits dans l'entrepôt .
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Expéditions
! style="vertical-align:top; width:450px;text-align:center"| Fiche d'une Expédition
|-
| style="vertical-align:top;" |
* Zone de recherche des expéditions
* Tableau des expéditions par trimestre avec filtrage
** Par nombre.
** Par quantité.
** Par valorisation.
* Graphique mensuel des mouvement de stock
* Tableau des dernière expéditions avec filtrage

| style="vertical-align:top;" |
* Tableau d'information de l'expédition
** Popup Évènements
** Popup Documents
** Popup Signature
* Liste de différent produit liée à l'expédition (avec infos en liste)
* Tableau des objets liés
|}

===Section Commerce (Espace Devis et Commandes Client)===

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Proposition commercial
! style="vertical-align:top; width:450px;text-align:center"| Recherche Proposition
! style="vertical-align:top; width:450px;text-align:center"| Détails Devis Clients
|-
| style="vertical-align:top;" |
* Zone de recherche des propositions.
* Tableau des devis clients par trimestre avec filtrage (Nb, Montant HT et TTC).
* Graphique mensuel
* Liste des dernières propositions
| style="vertical-align:top;" |
* Filtre sur les statuts
[ Brouillon | Validé | Signée | Non signée ]
* Filtre sur la date de la proposition commerciale
[ Année | Trimestre | Mois | Semaine ]
* Liste défilante proposition commerciale
| style="vertical-align:top;" |
* Bandeau d'information
** Popup Évènements
** Popup Documents
* Ligne de détail
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Commandes
! style="vertical-align:top; width:450px;text-align:center"| Recherche Commande
! style="vertical-align:top; width:450px;text-align:center"| Détails Commande
|-
| style="vertical-align:top;" |
* Zone de recherche des commande
* Tableau des commandes par trimestre avec filtrage (Nb, Montant HT et TTC)
* Graphique mensuel des commande
* Liste des dernières commandes
| style="vertical-align:top;" |
* Filtre sur les statuts
[ Brouillon | Validé | Clôturé ]
* Filtre sur la date de la recherche commande
[ Année | Trimestre | Mois | Semaine ]
* Liste défilante commande

| style="vertical-align:top;" |
* Tableau d'information de la Commande Client
** Popup Évènements liés au devis
** Popup Documents liés au devis
* Ligne de détail
|}

===Section Engagement (Espace Contrats et Interventions)===

Cette section, se trouvant dans Dolibarr parmi celle du Commerce, a été séparée pour plus de lisibilité

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Contrats
! style="vertical-align:top; width:450px;text-align:center"| Détails Contrat
|-
| style="vertical-align:top;" |
* [[File:app_icons_recherche.png|30px]] '''Zone de recherche contrat'''
* [[File:app_icons_filtres.png|30px]] '''Filtre États & Période'''
* '''Tableau des contrats par trimestre''' avec filtrage :
(Nb, Ouverts, Fermés)
* '''Graphique mensuel''' des contrats
* '''Liste des derniers contrats'''

| style="vertical-align:top;" |
* Icones de tête :
** [[File:app_icons_contact.png|30px]] '''Contact'''
** [[File:app_icons_001.png|30px]] '''Calendrier'''
** [[File:app_icons_document.png|30px]] '''Documents / Pièces jointes'''
** [[File:app_icons_notes.png|30px]] '''Notes'''
** [[File:app_icons_actions.png|30px]] '''Actions'''

Dérouler de la page :
* '''Tableau d'information du contrat'''
* '''Ligne de détail''' du contrat sélectionné & visualisation [[File:app_icons_vue_de_ligne.png|30px]]
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Interventions
! style="vertical-align:top; width:450px;text-align:center"| Recherche Intervention
! style="vertical-align:top; width:450px;text-align:center"| Détails Intervention
|-
| style="vertical-align:top;" |
* [[File:app_icons_recherche.png|30px]] '''Zone de recherche intervention'''
* [[File:app_icons_filtres.png|30px]] '''Filtre États & Période'''
* [[File:app_icons_creation_instervention.png|30px]] '''Création d'une intervention'''
* '''Tableau des interventions par trimestre''' avec filtrage :
(Nb, Nb d’heures, Nb de jours)
* '''Graphique mensuel''' des interventions
* '''Liste des dernières interventions'''
| style="vertical-align:top;" |
* [[File:app_icons_recherche.png|30px]] '''Zone de recherche intervention'''
* [[File:app_icons_filtres.png|30px]] '''Filtre États & Période'''
(Brouillon, Validé, Clôturé)
(Brouillon, Validé, Clôturé)
(Signé, Non Signé)
(Année, Trimestre, Mois, Semaine)
* '''Liste des interventions'''

| style="vertical-align:top;" |
* Icônes de tête :
** [[File:app_icons_contact.png|30px]] '''Contact'''
** [[File:app_icons_001.png|30px]] '''Calendrier'''
** [[File:app_icons_document.png|30px]] '''Documents / Pièces jointes'''
** [[File:app_icons_notes.png|30px]] '''Notes'''
** [[File:app_icons_actions.png|30px]] '''Actions'''

Déroulé de la page :
* '''Tableau d'information de l’intervention'''
* '''Ligne de détail''' de l’intervention sélectionnée & visualisation [[File:app_icons_vue_de_ligne.png|30px]]
|}

===Section Facture (Espace Factures et Règlements)===

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Factures
! style="vertical-align:top; width:450px;text-align:center"| Recherche Facture
! style="vertical-align:top; width:450px;text-align:center"| Détails Facture
|-
| style="vertical-align:top;" |
* Zone de recherche des factures
* Tableau des factures par trimestre avec filtrage (Nb, HT, TTC)
* Graphique mensuel des factures
* Liste des dernières factures
| style="vertical-align:top;" |
* Filtre sur les statuts
[ Brouillon | Validé | Clôturé ]
* Filtre sur la date de la proposition commerciale
[ Année | Trimestre | Mois | Semaine ]
* Liste défilante facture
| style="vertical-align:top;" |
* Tableau d'information de Facture
** Popup Évènements liés de facture
** Popup Documents liés de facture
* Ligne de détail
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Règlements
! style="vertical-align:top; width:450px;text-align:center"| Détails Règlement
|-
| style="vertical-align:top;" |
* Zone de recherche des règlements
* Tableau des règlements par trimestre avec filtrage (Nb & Montant)
* Graphique mensuel des règlements
* Liste des derniers règlements
| style="vertical-align:top;" |
* Tableau d'information de l'Intervention
** Popup Évènements liés à l'intervention
* Ligne de détail
|}

===Section Banque (Espace Comptes et Ecritures)===

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Comptes
! style="vertical-align:top; width:450px;text-align:center"| Détails Compte
|-
| style="vertical-align:top;" |
* Zone de recherche des comptes
* Liste des comptes
* Tableau des écritures comptable par trimestre avec filtrage (A, D, C)
* Graphique mensuel des comptes
* Liste des dernières interventions

| style="vertical-align:top;" |
* Tableau d'information du Compte
** Popup Documents liés à l'intervention
* Ligne de détail
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Ecritures
! style="vertical-align:top; width:450px;text-align:center"| Détails Ecritures
|-
| style="vertical-align:top;" |
* Zone de recherche des écritures
* Tableau des écritures par trimestre avec filtrage (A, D, C)
* Graphique mensuel des écritures
* Liste des dernières écritures

| style="vertical-align:top;" |
* Tableau d'information de l'Ecriture
* Ligne de détail
|}

===Section Calendrier (Liste évènements et Vue Agenda)===

Dans l'espace '''Calendrier''', vous trouverez les onglet :

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Liste des évènements
|-
| style="vertical-align:top;" |
* Zone de recherche d'un évènement
* Liste des dernier évènements
|}
{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Détails évènement
|-
| style="vertical-align:top;" |
* Tableau d'information de l'Intervention
** Popup Documents liés à l'intervention
* Ligne de détail
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Vue Agenda
|-
| style="vertical-align:top;" |
* Calendrier avec filtrage (Jour, Semaine, Mois)
|}

===Section Ticket (Espace Ticket et Base de connaissance)===
{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Ticket
! style="vertical-align:top; width:450px;text-align:center"| Détails Ticket
|-
| style="vertical-align:top;" |
* Zone de recherche des tickets
* Tableau des ticket par trimestre
* Graphique mensuel des ticket
* Liste des dernier ticket
| style="vertical-align:top;" |
* Tableau d'information du Ticket
** Popup Évènements liés au ticket
** Popup Documents liés au ticket
* Ligne de détail
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Espace Base de Connaissance
! style="vertical-align:top; width:450px;text-align:center"| Détails Base de Conaissance
|-
| style="vertical-align:top;" |
* Zone de recherche d'article
* Tableau des articles par trimestre
* Graphique mensuel des articles
* Liste des derniers articles

| style="vertical-align:top;" |
* Tableau d'information de l'Ecriture
** Popup Évènements liés à l'article
** Popup Documents liés à l'article
* Ligne de détail
|}

DoliSmart/en

2025-11-05T17:22:41Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:Dolismart.png|300px]]
| DoliSmart allows you to access your Dolibarr data from a smartphone (iOS or Android).
The data displayed on your smartphone is customizable:
* Widget selection on the main screens,
* Column selection on the search lists based on the screen width
* Field selection on the detail screens and customization (label changes, highlighting, bolding)

Data is accessible not only based on native permissions defined for users but also specifically for each field and other widgets

The interface is intuitive and allows you to navigate between Dolibarr elements (linked clickable elements), to access documents associated with the parts using ergonomics adapted to a smartphone.

It is finally possible to enter notes associated with an item, to sign interventions and shipments, to send an email from dolibarr (or the smartphone)

|}
<youtube>75ECrxNu_3Y</youtube>
==Overview==
This entire solution is divided into three parts :

* A module to install in your Dolibarr (like any other module) allowing you to customize the displays in the second part. This module can be ordered from the Dolistore and gives you access to updates for this module for 3 years: https://www.dolistore.com/product.php?id=2464
* A smartphone application (iOS or Android) allowing you to access your Dolibarr data according to the user's permissions identified in the application and the settings defined in the module. The applications are available on Apple and Android platforms.
* An annual subscription can be ordered from our store: https://dolismart.com/index.php/boutique/

If you need multiple licenses, you can contact us for a preferential volume rate.

Communications between the two elements are done via Dolibarr's native APIs but also specific APIs present in the module.

The Smartphone application retrieves the native dolibarr theme or the one you have defined on your environment.

It is finally possible to access several Dolibarrs (or the same Dolibarr with several user profiles) from the same interface. Please note that this feature is limited to 3 environments/profiles.


==Settings in Dolibarr==

To allow Dolibarr to communicate with the mobile application, it is necessary to activate the native API modules.

[[file:dolibarr_pré_para_api.png|600px]]

The DoliSmart module also provides a set of APIs necessary for the mobile application, which should also be activated.

[[file:dolibarr_pré_para_dolismart.png|600px]]


== User Settings ==

To allow a user to access the DoliSmart application from their smartphone, a set of actions must be carried out on the user's account

=== Generating an API key for the user ===
Once the REST API management module is enabled, you must select the user you wish to use to log in from the mobile application and generate an identification token for them.

[[file:dolibarr_utilisateur_géné_api.png|600px]]


=== User Authorization Management ===

Access to user authorizations is done from the permissions tab of their file

[[file:dolibarr_utilisateur_permission_utilisateur.png|600px]]

It is advisable to check several authorizations for use, namely:

* access to his/her authorizations

[[file:dolibarr_utilisateur_habilitation.png|600px]]

* access to the GED to allow him to both access documents, but also to upload documents from the smartphone into the element

[[file:dolibarr_permission_utilisateur_doc.png|600px]]

== Dolibarr Update/Corechange ==
DoliSmart has been compatible with Dolibarr since version 18, but for versions prior to V22, you must update your Dolibarr with the files in the Corechange folder located in the module directories.

To do this, copy the files present in the corechange folder of the application directly into the htdocs folder of your dolibarr.

Some features, such as searching for an invoice based on the third party's name, may not work on a version prior to 22.

{{Note|After each update of the '''Dolismart''' module, it is necessary to '''deactivate and then reactivate it''' to ensure its proper functioning.}}

==Dolismart Module Configuration==
In the Dolismart settings, you will find four tabs:


===General Configuration===

This is a tab dedicated to all the elements of the mobile application, mainly the number of records displayed or a default selection.

[[file:dolismart_para_configuration.png|600px]]

===Home Page Configuration===
Similar to the spaces in dolibarr, the doliSmart application has a page grouping information specific to a single element (third-party space, products, invoices, etc.).

This home page contains a search box and a set of widgets that you can choose to display or not.

This selection is made from the home pages configuration.

You must first select the element you wish to configure, then activate or deactivate the widgets.

It is also possible to only allow access to a widget to a set of people (individual selection) or to a user group defined in dolibarr.

Please note that managing access authorizations requires saving the line with the green save icon at the end of the line.

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:600px;" | '''Indexing choice for the home page'''
! style="vertical-align:top; width:600px;" | '''Display options'''
|-
| style="vertical-align:top;" |
[[file:dolismart_para_page_acceuil.png|600px]]
| style="vertical-align:top;" |
[[file:dolismart_para_page_acceuil-01.png|600px]]
|}

===Search List Configuration===
You can configure the fields that will be displayed during searches on the Dolismart application screen, based on the selected index page.

As well as the display setting (IF ACTIVE FIELD: Rename the field / choice of alignment & width / positioning).

Access Grant '''Users''' and '''User Group'''.

If you make a change to it, remember to save the change at the end of the line.

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:600px;" | '''Display Options'''
! style="vertical-align:top; width:600px;" | '''Display Example'''
|-
| style="vertical-align:top;" |
[[file:dolismart_para_page_liste_de_recherche-01.png|600px]]
| style="vertical-align:top;" |
[[file:dolismart_exemple_liste_de_recherche.gif]]
|}

===Configuring Detail Pages===
You can configure the fields that will be displayed on the Dolismart application screen based on the selected index page.

As well as the display setting (IF ACTIVE FIELD: Rename field / Bold text / Color).

Access Grant '''Users''' and '''User Group'''.

If you make a change to it, remember to save the change at the end of the line.

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:600px;" | '''Display options'''
|-
| style="vertical-align:top;" |
[[file:dolismart_para_page_page_de_détail-01.png|600px]]
|}

==Mobile App Screens==
=== Home Screen ===
{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:300px;" | '''Structured Main Menu'''
! style="vertical-align:top; width:300px;" | '''Customized Access Based on User Rights'''
! style="vertical-align:top; width:300px;" | '''Customizable Visual Interface'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_acceuil.png|300px]]
 
The '''DoliSmart''' menu is organized into sections, mirroring the Dolibarr structure: third-party, products, invoices, etc.
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_acceuil_habilitation_modif.png|300px]]
 
As mentioned previously, the home screen adapts based on the user's access rights. Each user only sees the modules and information they are authorized to access.
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_acceuil_theme.png|300px]]
 
The interface colors automatically adjust based on the visual customization of your Dolibarr instance, ensuring consistency with your usual environment.
|}


=== Settings Screen ===

{| class="wikitable" style="text-align:center"
! style="vertical-align:top; width:300px;" | '''Settings Menu'''
! style="vertical-align:top; width:300px;" | '''Account Details'''
! style="vertical-align:top; width:300px;" | '''Account Details'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_parametrage.png|300px]]
 
The '''DoliSmart''' settings menu allows you to view the currently active session or connect to a new Dolibarr instance.
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_parametrage_details_comptes.png|300px]]
 
This tab allows you to view recorded sessions (maximum 3), delete them, add new ones, or modify existing ones.
| style="vertical-align:top;" |
[[File:dolismart_app_ecran_parametrage_nouvelle_connection.png|300px]]
 
This tab displays information related to the selected account: the custom name (or the default one), the Dolibarr instance connection URL, and the login credentials (username and password).
|}


=== Icons present in the DoliSmart application ===

The '''DoliSmart app''' integrates icons into various menus to simplify navigation, improve readability, and enable quick actions. These visual icons serve as reference points to represent functions, data types, or shortcuts to frequently used interactions.

Icons are used consistently across multiple sections of the app.

{| class="wikitable" style="width:100%; text-align:center"
|-
| style="vertical-align:top; width:50%" |

<div class="mw-translate-fuzzy">
====Screen Space Icons====
{| class="wikitable" style="text-align:center; width:100%"
! Icon !! Function !! Description
|-
| [[File:app_icons_014.png|40px]] || NB (Number) || Number of sales
|-
| [[File:app_icons_015.png|40px]] || Excl. VAT || Calculated amount excluding VAT
|-
| [[File:app_icons_016.png|40px]] || Incl. VAT || Final billable amount including tax
|-
| [[File:app_icons_005.png|40px]] || Address / Google Maps || Clickable link to Google Maps with the entered address
|-
| [[File:app_icons_006.png|40px]] || Phone || Makes a call if a number is entered (on mobile)
|-
| [[File:app_icons_007.png|40px]] || Mail (native application) || Opens the phone's messaging application
|-
| [[File:app_icons_008.png|40px]] || Client || Designates a confirmed client
|-
| [[File:app_icons_009.png|40px]] || Prospect || Third party in the sales prospecting phase
|-
| [[File:app_icons_010.png|40px]] || Supplier || Designates a supplier (purchasing, logistics, etc.)
|-
| [[File:app_icons_011.png|40px]] || All items || View of all items
|-
| [[File:app_icons_012.png|40px]] || Annual Calendar || Filtered or sorted view by year
|-
| [[File:app_icons_013.png|40px]] || Quarter || Grouping by quarter (Q1, Q2, etc.)
|-
| [[File:app_icons_filtres.png|40px]] || Filter Status & Period || Drafts; Signed; Year; Quarter; etc...
|-
| [[File:app_icons_creation_intervention.png|40px]] || Creating an intervention || Tier; Customer ref & Description
|-
| [[File:app_icons_recherche.png|40px]] || Search area || Search header linked to the space you are in
|}
| style="vertical-align:top; width:50%" |
</div>

====Detail Screen Icons====
{| class="wikitable" style="text-align:center; width:100%"
! Icon !! Meaning !! Description
|-
| [[File:app_icons_001.png|40px]] || Calendar || Preview of events associated with the third party (events, tasks, appointments…)
|-
| [[File:app_icons_contact.png|40px]] || Contact || Manage contacts/addresses, users, and contacts associated with the item
|-
| [[File:app_icons_002.png|40px]] || Mail via Dolibarr || Sends an email via the integrated Dolibarr messaging interface (pending)
|-
| [[File:app_icons_document.png|40px]] || Documents / Attachments || Access to linked files & file upload
|-
| [[File:app_icons_notes.png|40px]] || Notes || Access and edit public and private notes (if selected and edit allowed)
|-
| [[File:app_icons_actionburger.png|40px]] || Action || Action associated with the item (signature, update status, etc.)
|-
| [[File:app_icons_actions.png|40px]] || Actions || Action on the item in question (Clone, Validation, Edit depending on status)
|-
| [[File:app_icons_ajout_ligne.png|40px]] || Add Actions || Add action (Start Date, Duration, Description)
|-
| [[File:app_icons_modif_ligne.png|40px]] || Edit Actions || Edit action (Start Date, Duration, Description)
|-
| [[File:app_icons_vue_de_ligne.png|40px]] || Details || Opens the details of the line in question
|}
|}

These icons are also visible in other contexts such as purchase orders, invoices or sales reports.

----

''The visual uniformity of the icons in DoliSmart allows for efficient navigation, while reducing the learning curve of the application.''

=== Element Space Screens ===
The space screens all have the same format.
{| class="wikitable"
! style="vertical-align:top; width:300px;" | '''Screen example'''
! style="vertical-align:top; width:600px;" | '''Elements present in a space screen'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_page_element.png|300px]]
 
The '''DoliSmart''' menu is organized into sections, following the Dolibarr structure: third-party space, products, invoices, etc.
| style="vertical-align:top;" |
* 1: Return to the Dolismart home page
* 2: Element search area
* 3: Table filter area including the graph
* 4: Table filter area by period (all, year, quarter)
* 5: Clickable elements to access their details
* 6: Navigation on other menu items
 
As mentioned previously, the spaces screen adapts according to the settings defined in the DoliSmart module.
|}

===Search Screens===
The search screens all have the same format.
{| class="wikitable"
! style="vertical-align:top; width:300px;" | '''Example of a search screen'''
! style="vertical-align:top; width:600px;" | '''Elements present in a search screen'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_page_recherche.png|300px]]
 
The '''DoliSmart''' menu is organized into sections, mirroring the Dolibarr structure: third-party, products, invoices, etc.
| style="vertical-align:top;" |
* 1: Return to the Dolismart home page
* 2: Item search area
* 3: Filter icon & options
* 4: Access the item's page
* 5: Access the page of the third party attached to the item (if a third party is associated)
* 6: Navigate to other menu items

|}

===Element Detail Screens===
The detail screens all have the same format.
{| class="wikitable"
! style="vertical-align:top; width:300px;" | '''Example of a detail screen'''
! style="vertical-align:top; width:600px;" | '''Elements present in a detail screen'''
|-
| style="vertical-align:top;" |
[[File:dolismart_app_page_détails.png|300px]]
| style="vertical-align:top;" |
* 1: Return to the Dolismart home page
* 2: Return to the previous page
* 3: Pop-up corresponding to the item tabs (here, calendar and attached documents)
* 4: Item status
* 5: Linked Tier sheet
* 6: Product sheet
* 7: Service sheet
* 8: Preview icon
* 9: Payment sheet
* 10: Navigation to other menu items
 
As mentioned previously, the details screen adapts based on the user's access rights. Each user only sees the modules and information they are authorized to access.
|}

====Element Action Buttons====
Depending on the element displayed AND the user's rights, there is an action button that opens a menu with a set of available actions.

The first part of the menu triggers a direct action, the second opens a second action window (to sign the intervention, for example).
{| class="wikitable"
! style="vertical-align:top; width:300px;" | '''Elements'''
! style="vertical-align:top; width:600px;" | '''Available Action(s)'''
|-
| style="vertical-align:top;" |
Interventions
| style="vertical-align:top;" |
* Validate - Reopen - Close
* Sign
|-
| style="vertical-align:top;" |
Contract
| style="vertical-align:top;" |
* Validate - Close
|-
| style="vertical-align:top;" |
Quote
| style="vertical-align:top;" |
* Validate - Close - Return to draft - Filed Invoiced
* Accepted - Rejected
|-
| style="vertical-align:top;" |
Order
| style="vertical-align:top;" |
* Validate - Reopen - Close - Return to draft - Filed Invoiced
|-
| style="vertical-align:top;" |
Invoice
| style="vertical-align:top;" |
* Validate - Return to draft
* Pay
|-
| style="vertical-align:top;" |
Shipments
| style="vertical-align:top;" |
* Validate - Close
* Sign
|}

== DoliSmart Sections ==
=== Third Party Section (Third Party Area and Contacts) ===

This section contains both the Dolibarr Third Parties and their contacts.

{| class="wikitable"
! style="vertical-align:top; width:400px;text-align:center"| Third-Party Space
! style="vertical-align:top; width:300px;" | '''Third-Party Details'''
! style="vertical-align:top; width:400px;" | '''Elements present in a Third-Party Details screen'''
|-
| style="vertical-align:top;" |
* Third-Party Search Box
* Quarterly Table of New Third-Parties
** Selection Button by Customer, Prospect, or Supplier
* Monthly Chart of New Third-Parties
* Top Customers
** Selection Button by the Entire Period, Year, or Current Quarter
* Latest Updated Customers
* Outstanding Customers
| style="vertical-align:top;" |
[[File:dolismart_app_tiers_page_tiers_03.png|300px]]
| style="vertical-align:top;" |
* 1: Return to the Dolismart home page
* 2: Return to the previous page
* 3: Popup corresponding to the item tabs (here, calendar and attached documents)
* 4: Tier contact information (address; telephone number; email address accessible from the smartphone)
* 5: Item status
* 6: Table of items associated with the item (here, the Third Party's contacts)
* 7: Tier contact/address
* 8: Invoice associated with the Tier
* 9: Navigation to other menu items
 
As mentioned previously, the details screen adapts based on the user's access rights. Each user only sees the modules and information they are authorized to access.
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Contact Area
! style="vertical-align:top; width:450px;text-align:center"| Contact Details
|-
| style="vertical-align:top;" |
* Contact search area
* Quarterly table of new contacts
* Monthly graph of new contacts
* Latest contacts updated with the contact record and their associated tier.
| style="vertical-align:top;" |
* Contact information table
** Events popup
** Documents popup
* Detail row
|}


===Products Section (Product and Services Areas)===

This section groups together both products and services.

Please note that inventory and shipping management, which can be found in the Dolibarr product menu, is located in another area of DoliSmart.

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Product Area
! style="vertical-align:top; width:450px;text-align:center"| Product Details
|-
| style="vertical-align:top;" |
* Product search area.
* Table of the most recently updated products.
* Table of the top products.
| style="vertical-align:top;" |
* Information banner
** Events Popup
** Documents Popup
* Invoiced sales of the product by quarter (number of sales, quantity sold, amount including tax)
* Monthly sales graph of the product.
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Services Area
! style="vertical-align:top; width:450px;text-align:center"| Service Details
|-
| style="vertical-align:top;" |
* Services search area.
* Table of the most recently updated services.
* Table of the top services.

| style="vertical-align:top;" |
* Information banner
** Events popup
** Documents popup
* Number of invoiced product sales per quarter (number, quantity, amount including tax)
* Monthly service sales graph.
|}


===Warehouses Section (Warehouse and Shipping Area)===

This section, located in Dolibarr among the products section, has been separated for better readability

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Warehouse Area
! style="vertical-align:top; width:450px;text-align:center"| Warehouse Detail
|-
| style="vertical-align:top;" |
* Warehouse search area.
* List of the most recently updated warehouses.
* Quarterly inventory movement table with filtering.
** By number.
** By quantity.
** By movement value amount.
* Monthly inventory movement graph
* Top products table.

| style="vertical-align:top;" |
* Warehouse information table.
* Events popup

* Quarterly warehouse inventory movement chart, filterable by number of movements, quantity, and valuation.
* Monthly warehouse inventory movement chart.
* Warehouse product chart.
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Shipments Area
! style="vertical-align:top; width:450px;text-align:center"| Shipment Sheet
|-
| style="vertical-align:top;" |
* Shipment search area
* Shipment table by quarter with filtering
** By number.
** By quantity.
** By valuation.
* Monthly stock movement graph
* Table of latest shipments with filtering

| style="vertical-align:top;" |
* Shipment Information Table
** Events Popup
** Documents Popup
** Signature Popup
* List of various products linked to the shipment (with information in the list)
* Table of linked items
|}


===Commerce Section (Quote and Customer Order Area)===

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Commercial Proposal Area
! style="vertical-align:top; width:450px;text-align:center"| Proposal Search
! style="vertical-align:top; width:450px;text-align:center"| Customer Quote Details
|-
| style="vertical-align:top;" |
* Proposal search area.
* Customer quote table by quarter with filtering (number, amount excluding and including tax).
* Monthly chart
* List of latest proposals
| style="vertical-align:top;" |
* Status filter
[Draft | Approved | Signed | Unsigned]
* Filter by commercial proposal date
[Year | Quarter | Month | Week]
* Commercial proposal scrolling list
| style="vertical-align:top;" |
* Information banner
** Events popup
** Documents popup
* Detail line
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Order Area
! style="vertical-align:top; width:450px;text-align:center"| Order Search
! style="vertical-align:top; width:450px;text-align:center"| Order Details
|-
| style="vertical-align:top;" |
* Order search area
* Quarterly order table with filtering (Number, Amount excluding and including VAT)
* Monthly order chart
* List of recent orders
| style="vertical-align:top;" |
* Status filter
[Draft | Validated | Closed]
* Order search date filter
[Year | Quarter | Month | Week]
* Order scrolling list

| style="vertical-align:top;" |
* Customer Order Information Table
** Quote Events Popup
** Quote Documents Popup
* Detail Line
|}


===Commitment Section (Contracts and Interventions Area)===

This section, located in Dolibarr among the Commerce section, has been separated for better readability

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Contracts Area
! style="vertical-align:top; width:450px;text-align:center"| Contract Details
|-
| style="vertical-align:top;" |

* [[File:app_icons_recherche.png|30px]] '''Contract Search Area'''
* [[File:app_icons_filtres.png|30px]] '''Status & Period Filter'''
* '''Table of Contracts by Quarter''' with filtering:

(Number, Open, Closed)
* '''Monthly Graph''' of Contracts
* '''List of Recent Contracts'''

| style="vertical-align:top;" |
* Head icons:
** [[File:app_icons_contact.png|30px]] '''Contact'''
** [[File:app_icons_001.png|30px]] '''Calendar'''
** [[File:app_icons_document.png|30px]] '''Documents / Attachments'''
** [[File:app_icons_notes.png|30px]] '''Notes'''
** [[File:app_icons_actions.png|30px]] '''Actions'''

Scroll down the page:
* '''Contract Information Table'''
* '''Detail Line''' of the selected contract & view [[File:app_icons_vue_de_ligne.png|30px]]
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Interventions Space
! style="vertical-align:top; width:450px;text-align:center"| Research Intervention
! style="vertical-align:top; width:450px;text-align:center"| Intervention Details
|-
| style="vertical-align:top;" |
* [[File:app_icons_recherche.png|30px]] '''Intervention Search Area'''
* [[File:app_icons_filtres.png|30px]] '''Status & Period Filter'''
* [[File:app_icons_creation_intervention.png|30px]] '''Creating an Intervention'''
* '''Table of Interventions by Quarter''' with filtering:

(Number, Number of Hours, Number of Days)
* '''Monthly Graph''' of Interventions
* '''List of Recent Interventions'''
| style="vertical-align:top;" |

* [[File:app_icons_recherche.png|30px]] '''Intervention Search Area'''
* [[File:app_icons_filtres.png|30px]] '''Status & Period Filter'''

(Draft, Validated, Closed)

(Draft, Validated, Closed)

(Signed, Unsigned)

(Year, Quarter, Month, Week)
* '''List of Interventions'''

| style="vertical-align:top;" |
* Head icons:
** [[File:app_icons_contact.png|30px]] '''Contact'''
** [[File:app_icons_001.png|30px]] '''Calendar'''
** [[File:app_icons_document.png|30px]] '''Documents / Attachments'''
** [[File:app_icons_notes.png|30px]] '''Notes'''
** [[File:app_icons_actions.png|30px]] '''Actions'''

Page layout:
* '''Intervention information table'''
* '''Detail line''' of the selected intervention & visualization [[File:app_icons_vue_de_ligne.png|30px]]
|}


===Invoice Section (Invoices and Payments Area)===

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Invoice Area
! style="vertical-align:top; width:450px;text-align:center"| Invoice Search
! style="vertical-align:top; width:450px;text-align:center"| Invoice Details
|-
| style="vertical-align:top;" |
* Invoice search area
* Quarterly invoice table with filtering (number, excluding VAT, including VAT)
* Monthly invoice graph
* List of latest invoices
| style="vertical-align:top;" |
* Status filter
[Draft | Validated | Closed]
* Proposal date filter
[Year | Quarter | Month | Week]
* Invoice scrolling list
| style="vertical-align:top;" |
* Invoice Information Table
** Invoice Related Events Popup
** Invoice Related Documents Popup
* Detail Line
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Settlements Area
! style="vertical-align:top; width:450px;text-align:center"| Settlement Details
|-
| style="vertical-align:top;" |
* Settlement search area
* Quarterly settlement table with filtering (Number & Amount)
* Monthly settlement graph
* List of latest settlements
| style="vertical-align:top;" |
* Intervention information table
** Intervention-related events popup
* Detail line
|}


===Bank Section (Accounts and Entries Area)===

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Accounts Area
! style="vertical-align:top; width:450px;text-align:center"| Account Details
|-
| style="vertical-align:top;" |
* Account search area
* List of accounts
* Quarterly accounting entries table with filtering (A, D, C)
* Monthly account chart
* List of recent transactions

| style="vertical-align:top;" |
* Account Information Table
** Intervention Documents Popup
* Detail Line
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Entries Area
! style="vertical-align:top; width:450px;text-align:center"| Entries Details
|-
| style="vertical-align:top;" |
* Entries search area
* Quarterly entries table with filtering (A, D, C)
* Monthly entries graph
* List of recent entries

| style="vertical-align:top;" |
* Scripture Information Table
* Detail Line
|}


===Calendar Section (Event List and Agenda View)===

In the '''Calendar''' area, you will find the tabs:

{| class="wikitable"
! style="vertical-align:top; width:450px; text-align:center"| List of Events
|-
| style="vertical-align:top;" |
* Event Search Box
* List of Latest Events
|}
{| class="wikitable"
! style="vertical-align:top; width:450px; text-align:center"| Event Details
|-
| style="vertical-align:top;" |
* Intervention Information Table
** Intervention Documents Popup
* Detail Line
|}

{| class="wikitable"
! style="vertical-align:top; width:450px; text-align:center"| Calendar View
|-
| style="vertical-align:top;" |
* Calendar with filtering (Day, Week, Month)
|}

===Ticket Section (Ticket Area and Knowledge Base)===
{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Ticket Area
! style="vertical-align:top; width:450px;text-align:center"| Ticket Details
|-
| style="vertical-align:top;" |
* Ticket Search Box
* Quarterly Ticket Chart
* Monthly Ticket Chart
* Latest Ticket List
| style="vertical-align:top;" |
* Ticket Information Table
** Ticket Events Popup
** Ticket Documents Popup
* Detail Row
|}

{| class="wikitable"
! style="vertical-align:top; width:450px;text-align:center"| Knowledge Base Area
! style="vertical-align:top; width:450px;text-align:center"| Knowledge Base Details
|-
| style="vertical-align:top;" |
* Article search area
* Quarterly article chart
* Monthly article chart
* List of latest articles

| style="vertical-align:top;" |
* Scripture Information Table
** Article Events Popup
** Article Documents Popup
* Detail Line
|}

Translations:DoliSmart/58/fr

2025-11-05T17:22:37Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

====Icônes des écrans des espaces====
{| class="wikitable" style="text-align:center; width:100%"
! Icône !! Fonction !! Description
|-
| [[File:app_icons_014.png|40px]] || NB (Nombre) || Nombre de vente
|-
| [[File:app_icons_015.png|40px]] || HT (Hors Taxes) || Montant calculé hors taxes
|-
| [[File:app_icons_016.png|40px]] || TTC (Toutes Taxes Comprises) || Montant final facturable avec taxes
|-
| [[File:app_icons_005.png|40px]] || Adresse / Google Maps || Lien cliquable vers Google Maps avec l’adresse renseignée
|-
| [[File:app_icons_006.png|40px]] || Téléphone || Lance un appel si un numéro est renseigné (sur mobile)
|-
| [[File:app_icons_007.png|40px]] || Mail (application native) || Ouvre l’application de messagerie du téléphone
|-
| [[File:app_icons_008.png|40px]] || Client || Désigne un client confirmé
|-
| [[File:app_icons_009.png|40px]] || Prospect || Tiers en phase de prospection commerciale
|-
| [[File:app_icons_010.png|40px]] || Fournisseur || Désigne un fournisseur (achat, logistique…)
|-
| [[File:app_icons_011.png|40px]] || Totalité des éléments || Vue de la totalité des éléments
|-
| [[File:app_icons_012.png|40px]] || Calendrier annuel || Vue filtrée ou triée par année
|-
| [[File:app_icons_013.png|40px]] || Trimestre || Regroupement par trimestre (Q1, Q2, etc.)
|-
| [[File:app_icons_filtres.png|40px]] || Filtre Etats & Période || Brouillons ; Signée ; Année ; Trimestre ; etc...
|-
| [[File:app_icons_creation_intervention.png|40px]] || Création d'une intervention || Tier ; Customer ref & Description
|-
| [[File:app_icons_recherche.png|40px]] || Zone de recherche || Entête de recherche lié à l'espace dans lequel vous vous situez
|}
| style="vertical-align:top; width:50%" |

CoefPricR/en

2025-11-05T17:22:08Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
<div class="mw-translate-fuzzy">
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:CoefPricR-250x250.png]]
|The CoefPricR Module allows the mass updating of the sales prices of products/services from their sales price, PMP or cost, by entering a multiplier coefficient.
|}
CoefPricR uses product/service categories to enable relevant filtering of prices to be updated. 
A mass deletion feature allows you to cancel successive changes to sales prices. It is based on the date and categories of previous changes.
IMAGE CHANGEMENT EN MASSE
IMAGE SUPRESSION EN MASSE
CoefPricR allows you to view the list of recorded coefficients and the price history of products/services.
== Install==
=== Activation ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config1.png |850px]]
| To activate the module, open the module list page from the Home > Configuration > Modules menus. The module will be displayed in the module list of the Patas-Tools table.
|}
== Settings==
=== Configuring module features ===
The module is configured from the module administration page accessible via the Home > Configuration > Modules menus by clicking on the icon at the end of the line. 
CoefPricR allows the price to be updated according to different elements, all independent of each other, each can therefore be activated or not.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config2_en.png |850px]]
|The different options determine the following operations: 
Allow the calculation mode by multiplication of the last sale price: This price update mode takes the last price of the products/services and applies the selected update mode to it. 
Allow the calculation mode by multiplication of the PMP: This update mode requires that the PMP of the products be supplied. It therefore requires the use of supplier orders and invoices. 
Allow the calculation method of the last sales price by index (Experimental): This price update method requires the prior creation of an index table. 
Warning: The functionality for updating prices from indices is still at the experimental stage. 
Allow the calculation method by multiplying the cost price: The cost price (CostPrice) is a field allowing the free entry of a price on the product/service sheets. 
|}
</div>

<div class="mw-translate-fuzzy">
=== Permissions ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config3.png |850px]]
| The default permissions Home > Configuration > Security > Default permissions, granted to any user created after the module installation, if they are not added to a group.
|}
== Starting ==
The CoefPricR features are accessible from the main menu tab Products/service which then displays the secondary menu entries.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config4.png |850px]]
|Main entry CoefPricR: This entry will display a dashboard of sales price update activity. 
Mass change: The entry will display the page for entering a new index or coefficient for mass modification of sales prices. 
Mass deletion: The entry will display a page for deleting saved updates. 
List of indices: The entry will display the list of indices saved successively. 
Price history: You will display the list of products and services, their initial and current sales prices and a history of the changes made.
|}
== General operation ==
The initial step of changing prices is the same for all price update modes. 
From the menu entries Products/Services > CoefPricR > Mass change, display the sales price update page:
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config5.png |850px]]
| Price change calculation method: Select the calculation method to apply between the values according to the last sale price, according to the PMP or according to the cost price. 
Coefficient to apply: Enter the value of the change. 
Note: Enter 105 to apply a 5% increase, 95 for a 5% decrease. 
Coefficient application date: This data will be useful to know when the updated mass prices can be applied. 
Note: Entering a later date will have no effect on the sale prices of your products and services.
|}
After clicking on the mass price change button, a summary table of the quantities of prices modified will be displayed:
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config6.png |850px]]
|At the same time, the Price History secondary menu link will display the price evolution of your products/services.
|}
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
== Démarrage ==
Les fonctionnalités de CoefPricR sont accessibles depuis l'onglet de menu principal Produits/service qui affiche alors les entrées de menu secondaire .
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config4.png |850px]]
| Entrée principale CoefPricR : Cette entrée affichera un tableau de bord de l'activité de mise à jour des prix de ventes. 
Changement en masse : L'entrée affichera la page de saisie d'un nouvel indice ou coefficient de modification en masse des prix de vente. 
Suppression en masse : L'entrée affichera une page permettant de supprimer des mises à jour enregistrées. 
Liste des indices : L'entrée affichera la liste des indices enregistrés successivement. 
Historique des prix : Vous afficherez la liste des produits et services, leur prix de vente initial, actuel et un historique des modifications apportées.
|}
== Fonctionnement général ==
L'étape initiale de modification des prix est identique pour tous les modes de mise à jour des prix. 
Depuis les entrées de menu Produits/Services > CoefPricR > Changement en masse, affichez la page de mise à jour des prix de vente:
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config5.png |850px]]
| Mode de calcul de changement de prix : Sélectionnez le mode de calcul à appliquer entre les valeurs selon le dernier prix de vente, selon le PMP ou selon le prix de revient. 
Coefficient à appliquer : Saisissez la valeur de l'évolution. 
Remarque : Saisissez 105 pour appliquer une augmentation de 5 %, 95 pour une baisse de 5%. 
Date d'application du coefficient : Ces données seront utiles pour savoir quand les prix de masse actualisés pourront être appliqués. 
Note : La saisie d'une date ultérieure n'aura aucun effet sur les prix de vente de vos produits et services.
|}
Suite au clic sur le bouton changement de prix en masse, un tableau récapitulatif des quantités de prix modifiés sera affiché :
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config6.png |850px]]
| Parallèlement, le lien de menu secondaire Historiques des prix affichera l'évolution des prix de vos produits/services.
|}
</div>

== Mass price change ==
For future situations, let's start from the following base of products and services:
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config7.png |850px]]
|}
=== Based on a sale price ===
Let's apply a 10% increase to the prices of products and services based on their sale price. 
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config8.png |850px]]
|}
Note: Any new coefficient entered during subsequent updates will apply to the last recorded sales price. 
Warning: CoefpricR acts on the default price of the products. If your products have a price per customer, these will remain unchanged following a mass update with CoefpricR. 
The price of the product "Product - Test" then becomes:{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config9.png |850px]]
|}
=== Price change from PMP or cost price ===
The operation is exactly the same for a price update from PMP or cost price as that seen previously.
== Price change from purchase price ==
The operation is exactly the same as that seen previously.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config10.png |850px]]
| Starting situation
|}
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config12.png |850px]]
| Let's apply a 250% increase in the purchase price
|}
Attention: In case of activation of the supplier reputation, if the supplier whose price is the minimum (or maximum) is not registered as a favorite, the price of the product will not be updated.
== Mass deletion ==
To start a mass deletion, click on the menu entry Products/services > CoefPricR > mass deletion.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config13.png |850px]]
| Enter the recording date of the prices to be deleted and click the Start mass deletion button.
|}
Once the deletion is done, the message Deletion completed is displayed at the top right of your screen. 
CoefpricR cannot delete the prices of a product if at least one default price is not present in the product sheet, sale price tab. 
If this is the case, you will get the error message Deletion impossible and the products concerned will keep their last recorded price.
== Other Features ==
=== Price History ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config14.png |850px]]
| The menu link Products/services > CoefPricR > price history displays a summary table of updates made to the sales prices of your products/services.
|}

CoefPricR/fr

2025-11-05T17:21:54Z

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

<languages/>
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:CoefPricR-250x250.png]]
| Le Module CoefPricR permet la mise à jour en masse des prix de vente des produits/ services à partir de leur prix de vente, PMP ou de revient, par la saisie d'un coefficient multiplicateur.
|}
CoefPricR utilise les catégories de produits/services pour permettre un filtrage pertinent des prix à mettre à jour. 
Une fonctionnalité de suppression en masse permet d'annuler les modifications successives apportées aux prix de vente. Elle se base sur les date et les catégories des précédentes modifications.
IMAGE CHANGEMENT EN MASSE
IMAGE SUPRESSION EN MASSE
CoefPricR permet de visualiser la liste des coefficients enregistrés et l'historique des prix des produits/services.
== Installation ==
=== Activation ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config1.png |850px]]
| Pour activer le module, ouvrez la page de la liste des modules depuis les menus Accueil > Configuration > Modules. Le module sera affiché dans la liste des modules du tableau Patas-Tools.
|}
== Paramétrage ==
=== Configuration des fonctionnalités du module ===
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus Accueil > Configuration > Modules en cliquant sur l'icône ou (1) en bout de ligne. 
CoefPricR permet la mise à jour de prix en fonction de différents éléments, tous indépendants les uns des autres, chacun peut donc être activé ou non .
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config2.png |700px]]
| Les différentes options conditionnent les fonctionnements suivants : 
Autoriser le mode de calcul par multiplication du dernier prix de vente : Ce mode de mise à jour des prix reprend le dernier prix des produits/services et lui applique le mode de mise à jour sélectionné. 
Autoriser le mode de calcul par multiplication du PMP : Ce mode de mise à jour nécessite que le PMP des produits soit alimenté. Il requiert donc l'utilisation des commandes et factures fournisseurs. 
Autoriser le mode de calcul du dernier prix de vente par indice (Expérimental) : Ce mode de mise à jour des prix nécessite la création préalable d'une table d'indices. 
Attention: La fonctionnalité de mise à jour des prix à partir d'indices est encore au stade expérimental . 
Autoriser le mode de calcul par multiplication du prix de revient (cost price) : Le prix de revient (CostPrice) est un champ permettant la saisie libre d'un prix sur les fiches des produits/services. 
|}

=== Permissions ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config3.png |850px]]
| Les permissions par défaut Accueil > Configuration > Sécurité > Permissions par défaut, accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe .
|}

== Démarrage ==
Les fonctionnalités de CoefPricR sont accessibles depuis l'onglet de menu principal Produits/service qui affiche alors les entrées de menu secondaire .
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config4.png |850px]]
| Entrée principale CoefPricR : Cette entrée affichera un tableau de bord de l'activité de mise à jour des prix de ventes. 
Changement en masse : L'entrée affichera la page de saisie d'un nouvel indice ou coefficient de modification en masse des prix de vente. 
Suppression en masse : L'entrée affichera une page permettant de supprimer des mises à jour enregistrées. 
Liste des indices : L'entrée affichera la liste des indices enregistrés successivement. 
Historique des prix : Vous afficherez la liste des produits et services, leur prix de vente initial, actuel et un historique des modifications apportées.
|}
== Fonctionnement général ==
L'étape initiale de modification des prix est identique pour tous les modes de mise à jour des prix. 
Depuis les entrées de menu Produits/Services > CoefPricR > Changement en masse, affichez la page de mise à jour des prix de vente:
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config5.png |850px]]
| Mode de calcul de changement de prix : Sélectionnez le mode de calcul à appliquer entre les valeurs selon le dernier prix de vente, selon le PMP ou selon le prix de revient. 
Coefficient à appliquer : Saisissez la valeur de l'évolution. 
Remarque : Saisissez 105 pour appliquer une augmentation de 5 %, 95 pour une baisse de 5%. 
Date d'application du coefficient : Ces données seront utiles pour savoir quand les prix de masse actualisés pourront être appliqués. 
Note : La saisie d'une date ultérieure n'aura aucun effet sur les prix de vente de vos produits et services.
|}
Suite au clic sur le bouton changement de prix en masse, un tableau récapitulatif des quantités de prix modifiés sera affiché :
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config6.png |850px]]
| Parallèlement, le lien de menu secondaire Historiques des prix affichera l'évolution des prix de vos produits/services.
|}

== Changement de prix en masse ==
Pour les situations à venir, partons de la base de produits et services suivante :
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config7.png |850px]]
|}
=== Selon un prix de vente ===
Appliquons une augmentation de 10% aux prix des produits et services sur la base de leur prix de vente. 
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config8.png |850px]]
|}
Note : Tout nouveau coefficient saisi lors des mises à jour suivantes s'appliquera au dernier prix de vente enregistré. 
Attention : CoefpricR agit sur le prix par défaut des produits, Si vos produits possèdent un prix par client, ceux-ci resteront inchangés suite à une mise à jour en masse avec CoefpricR. 
Le prix du produit "Produit - Test" deviennent alors :
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config9.png |850px]]
|}
=== Changement de prix depuis le PMP ou le prix de revient ===
Le fonctionnement est exactement le même pour une mise à jour des prix depuis le PMP ou prix de revient que celle vue précédemment.
== Changement de prix depuis le prix d'achat ==
Le fonctionnement est exactement le même que celle vue précédemment.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config10.png |850px]]
| Situation de départ
|}
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config12.png |850px]]
| Appliquons une hausse de 250% du prix d'achat
|}
Attention : Dans le cas de l'activation de la réputation fournisseur, si le fournisseur dont le prix est le minimum (ou maximum) n'est pas enregistré comme favori, le prix du produit ne sera pas mis à jour.
== Suppression en masse ==
Pour lancer une suppression en masse, cliquez sur l'entrée de menu Produits/services > CoefPricR > suppression en masse.
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config13.png |850px]]
| Saisissez la date d'enregistrement des prix à supprimer et cliquez sur le bouton Lancer la suppression en masse.
|}
Une fois la suppression effectué, le message Suppression effectuée s'affiche en haut à droite de votre écran. 
CoefpricR ne peut pas supprimer les prix d'un produit si au moins un prix par défaut n'est pas présent dans la fiche du produit, onglet prix de vente. 
Si tel est le cas, vous obtiendrez le message d'erreur Suppression impossible et les produits concernés conserveront leur dernier prix enregistré.
== Autres fonctionnalités ==
=== Historique de prix===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config14.png |850px]]
| Le lien de menu Produits/services > CoefPricR > historique de prix affiche un tableau récapitulatif des mises à jour effectuées sur les prix de vente de vos produits/services .
|}

Translations:CoefPricR/4/fr

2025-11-05T17:21:53Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

== Démarrage ==
Les fonctionnalités de CoefPricR sont accessibles depuis l'onglet de menu principal Produits/service qui affiche alors les entrées de menu secondaire .
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config4.png |850px]]
| Entrée principale CoefPricR : Cette entrée affichera un tableau de bord de l'activité de mise à jour des prix de ventes. 
Changement en masse : L'entrée affichera la page de saisie d'un nouvel indice ou coefficient de modification en masse des prix de vente. 
Suppression en masse : L'entrée affichera une page permettant de supprimer des mises à jour enregistrées. 
Liste des indices : L'entrée affichera la liste des indices enregistrés successivement. 
Historique des prix : Vous afficherez la liste des produits et services, leur prix de vente initial, actuel et un historique des modifications apportées.
|}
== Fonctionnement général ==
L'étape initiale de modification des prix est identique pour tous les modes de mise à jour des prix. 
Depuis les entrées de menu Produits/Services > CoefPricR > Changement en masse, affichez la page de mise à jour des prix de vente:
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config5.png |850px]]
| Mode de calcul de changement de prix : Sélectionnez le mode de calcul à appliquer entre les valeurs selon le dernier prix de vente, selon le PMP ou selon le prix de revient. 
Coefficient à appliquer : Saisissez la valeur de l'évolution. 
Remarque : Saisissez 105 pour appliquer une augmentation de 5 %, 95 pour une baisse de 5%. 
Date d'application du coefficient : Ces données seront utiles pour savoir quand les prix de masse actualisés pourront être appliqués. 
Note : La saisie d'une date ultérieure n'aura aucun effet sur les prix de vente de vos produits et services.
|}
Suite au clic sur le bouton changement de prix en masse, un tableau récapitulatif des quantités de prix modifiés sera affiché :
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config6.png |850px]]
| Parallèlement, le lien de menu secondaire Historiques des prix affichera l'évolution des prix de vos produits/services.
|}

Translations:CoefPricR/2/fr

2025-11-05T17:21:53Z

FuzzyBot : Importation d’une nouvelle version depuis une source externe.

=== Permissions ===
{| class="wikitable"
|- style="vertical-align:top;"
| [[File:coefPricR_Config3.png |850px]]
| Les permissions par défaut Accueil > Configuration > Sécurité > Permissions par défaut, accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe .
|}