Dolibarr ERP CRM Wiki - User contributions [en]

Gaëtan Frenoy

2010-10-21T11:21:08Z

Jwarnier:

[[Category:Everybody]]
[[Category:Chasseur]]
[[Category:User Retired]]
{{UserInfo|
username=Gaetan Frenoy|
usercountry={{Flag_be}}|
userlogin=gfrenoy|
userdate=2007-08|
usercompany=|
userweb=|
usergrade={{LinkFighter}}|
userstatus=Retired|}}

Yannick Warnier

2010-10-21T11:19:13Z

Jwarnier:

[[Category:Everybody]]
[[Category:Admiral]]
[[Category:User Active]]
{{UserInfo|
username=Yannick Warnier|
usercountry={{Flag_be}}|
userlogin=ywarnier|
userdate=2005-02-26|
usercompany=BeezNest|
userweb=http://www.beeznest.com|
usergrade={{LinkAdmiral}}|
userstatus=active|}}

Yannick Warnier

2010-10-21T11:18:31Z

Jwarnier:

[[Category:Everybody]]
[[Category:Admiral]]
[[Category:User Active]]
{{UserInfo|
username=Yannick Warnier|
usercountry={{Flag_be}}|
userlogin=ywarnier|
userdate=2005-02-26|
usercompany=|
userweb=|
usergrade={{LinkAdmiral}}|
userstatus=active|}}

Roadmap and Release 2.1.0

2006-06-13T23:36:19Z

Jwarnier: /* Autre */

[[Roadmap]] Dolibarr pour la version 2.1.0

== Les fonctionnalités ==

* Corrections des retours de la 2.0 (En cours - Tous)
* Ajout de gestion des remises fixes et relatives (En cours - LaurentDestailleur)
* Ajout de gestion des avoirs de factures (En cours - LaurentDestailleur)
* <strike>Rendre le "modules de comptabilité standard" optionnel afin de permettre de faire disparaitre les notions purement comptables</strike> (Fait - LaurentDestailleur)
* <strike>Simplification du code. Utilisation d'un modèle unique de table pour tous les modules qui "active" des sous-modules de génération de document afin de réduire le code redondant</strike> (Fait - LaurentDestailleur).

== Modules à inclure/exclure pour la release ==
Tous les modules du CVS peuvent être inclus dans la release 2.1.0 à l'exception des suivants:

* Postnuke
Non stable

* Telephonie
Trop spécifique

* ClicktoDial
Non car hack grossier sur un système peu répandu

* bookmark4u
Non car peu utile

* barcode
Q: Est-il fini ?
R:

* Catégorie
Q : Semble stable maintenant. Quelqu'un l'utilise ?
R :

== Modèles à inclure/exclure pour la release ==
'''Modèle numérotation facture'''

Afin de simplifier et éviter doublons, je propose de supprimer de la livraison standard les modules de numérotation suivant:

deneb: non réglementaire

janus: non réglementaire, pas de plus-value par rapport à jupiter, saturne, lune

jupiter: non réglementaire, exemple coincide pas avec desc

lune: non réglementaire

mars: non réglementaire

pluton: non réglementaire, pas de plus-value par rapport à terre

saturne: non réglementaire

venus: non réglementaire, ne peut fonctionner si 2 factures pour le meme client le meme jour

'''Modèle génération facture'''

bigorneau: non reglementaire

tourteau: non reglementaire

bulot: non reglementaire

'''Modèle numérotation commande'''

ivoire: a virer car buggué. Ne peut fonctionner car basé sur compatge et non un max. Donc retombe sur doublons dès qu'une commande est supprimée.

== Autre ==

* Le support PosgreSQL n'est pas stable (Manque de testeurs) et ne sera donc pas intégré à la 2.1

* Le répertoire product/categorie est obsolète et peu être supprimé (remplacé par le répertoire boutique qui gère le module OScommerce).

Roadmap and Release 2.1.0

2006-06-13T23:35:01Z

Jwarnier: /* Modules à inclure/exclure pour la release */

[[Roadmap]] Dolibarr pour la version 2.1.0

== Les fonctionnalités ==

* Corrections des retours de la 2.0 (En cours - Tous)
* Ajout de gestion des remises fixes et relatives (En cours - LaurentDestailleur)
* Ajout de gestion des avoirs de factures (En cours - LaurentDestailleur)
* <strike>Rendre le "modules de comptabilité standard" optionnel afin de permettre de faire disparaitre les notions purement comptables</strike> (Fait - LaurentDestailleur)
* <strike>Simplification du code. Utilisation d'un modèle unique de table pour tous les modules qui "active" des sous-modules de génération de document afin de réduire le code redondant</strike> (Fait - LaurentDestailleur).

== Modules à inclure/exclure pour la release ==
Tous les modules du CVS peuvent être inclus dans la release 2.1.0 à l'exception des suivants:

* Postnuke
Non stable

* Telephonie
Trop spécifique

* ClicktoDial
Non car hack grossier sur un système peu répandu

* bookmark4u
Non car peu utile

* barcode
Q: Est-il fini ?
R:

* Catégorie
Q : Semble stable maintenant. Quelqu'un l'utilise ?
R :

== Modèles à inclure/exclure pour la release ==
'''Modèle numérotation facture'''

Afin de simplifier et éviter doublons, je propose de supprimer de la livraison standard les modules de numérotation suivant:

deneb: non réglementaire

janus: non réglementaire, pas de plus-value par rapport à jupiter, saturne, lune

jupiter: non réglementaire, exemple coincide pas avec desc

lune: non réglementaire

mars: non réglementaire

pluton: non réglementaire, pas de plus-value par rapport à terre

saturne: non réglementaire

venus: non réglementaire, ne peut fonctionner si 2 factures pour le meme client le meme jour

'''Modèle génération facture'''

bigorneau: non reglementaire

tourteau: non reglementaire

bulot: non reglementaire

'''Modèle numérotation commande'''

ivoire: a virer car buggué. Ne peut fonctionner car basé sur compatge et non un max. Donc retombe sur doublons dès qu'une commande est supprimée.

== Autre ==

* Le support Posgresql n'est pas stable (Manque de testeur) et ne sera donc pas intégré à la 2.1

* Le répertoire product/categorie est obsolète est peu etre supprimé (remplacé par le répertoire boutique qui gère le module OScommerce).

Accueil

2006-06-13T23:32:39Z

Jwarnier: /* Utilisateurs */

[http://www.dolibarr.com Le site officiel francophone Dolibarr]

[http://www.dolibarr.org Le site officiel anglophone Dolibarr]

==News==

[[Nomination chef de projet]]

Prochaines versions [[Roadmap|ici]]

== Utilisateurs ==
* [[Documentation utilisateur|Documentation Utilisateur]]
* [http://www.dolibarr.org/demo/htdocs/ Demo Dolibarr 2.1alpha]
* [[FAQ_Utilisateur|FAQ Utilisateur]]
* [http://forum.dolibarr.com Forum général]

== Développeurs ==
* [[Documentation Développeur]]
* [[FAQ Développeur]]
* [[Développement|Toutes les ressources pour suivre ou aider le développement de Dolibarr]]

== Traducteurs ==
* [[Documentation traducteur]]

== Revue de presse ==
* [[Presse en ligne]]
* [[Presse papier]]

[http://meta.wikimedia.org/wiki/Help:Editing Règles de formattage de ce wiki]

Documentation utilisateur

2006-06-13T23:29:23Z

Jwarnier:

* Installation/Démarrage
# [[Installation / Mise a jour]]
# [[Premiers paramétrages]]

* Utilisation
# [[Sociétés]]
# [[Proposition commerciale]]
# [[Commande]]
# [[Facturation/Comptabilité]]
## [[TVA]]
# [[Projet]]
# [[Contrat]]
# [[Produits]] / [[Services]]
# [[Téléphonie]]
# [[Fournisseur]]
## [[CommandeFournisseur]]
## [[FactureFournisseur]]
# [[Mailing]]
# [[Calendrier]]

* Divers
# [[Glossaire]]

Documentation utilisateur

2006-06-13T23:28:37Z

Jwarnier:

Installation - Mise à jour

2006-06-13T23:25:58Z

Jwarnier: /* Procédure installation manuelle */

{{Navigation documentation}}
{{TemplateDocUtil}}

Les procédures suivantes décrivent comment installer ou mettre à jour Dolibarr.

== Procédure d'installation manuelle ==

Cette procédure décrit l'installation manuelle (recommandée) sur un système GNU/Linux (Debian, Mandrake, ...), elle est valable avec d'autres systèmes moyennant quelques modifications.
Elle est applicable pour toute version de Dolibarr >= 2.0.0

* Placez-vous dans le répertoire dans lequel installer Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)
$ cd /var/www

* Récupérez l'archive de l'application (lien ci-dessous par exemple)
$ wget http://dolibarrint.jexiste.fr/en/index.php?module=documents&JAS_DocumentManager_op=downloadFile&JAS_File_id=17

* Décompressez l'archive
$ tar xvfz dolibarr-2.0.1.tgz

* Renommer le répertoire dolibarr-2.0.1 en dolibarr afin d'avoir un nom de répertoire indépendant de la version
$ mv dolibarr-2.0.1 dolibarr

* En tant que root, créez, dans le répertoire dolibarr/htdocs/conf, un fichier de configuration vide, et attribuez-le, en tant que propriétaire du fichier, à l'utilisateur du serveur web (exemple www-data sur debian, nobody sur une vieille RedHat, apache sur une autre version ...). Ceci est requis car le serveur web a besoin d'écrire dans ce fichier lors de l'installation.

# cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php

* Toujours en root, créez le repository qui servira aux documents générés et stockés par Dolibarr (factures pdf, images, ...), et attribuez-le, en tant que propriétaire du répertoire, à l'utilisateur du serveur web (exemple www-data sur Debian, nobody sur une vieille RedHat, Apache sur une Mandriva ou une RedHat récente, ...). Le serveur web doit avoir les droits en écriture dans ce répertoire.

# mkdir documents ; chown www-data documents

* Créez une base de données vierge pour accueillir Dolibarr

# mysqladmin create dolibarr

* Pointez votre navigateur sur la page principale

http://127.0.0.1/dolibarr/

* Suivez les instructions de l'installation

* Pour des raisons de sécurité nous vous conseillons, une fois l'installation terminée, de mettre le fichier conf.php en lecture seule et de supprimer le répertoire d'installation

# chmod 600 htdocs/conf/conf.php ; rm -fr htdocs/install/

== Procédure mise à jour manuelle ==

Cette procédure décrit la mise à jour manuelle de Dolibarr (depuis une ancienne version) vers une plus récente.
Elle est applicable dès lors que la mise à jour se fait pour une version de Dolibarr >= 2.0.0

* Placez-vous dans le répertoire dans lequel a été installé Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)
$ cd /var/www

* Récupérez l'archive de la nouvelle version
$ wget http://dolibarrint.jexiste.fr/en/index.php?module=documents&JAS_DocumentManager_op=downloadFile&JAS_File_id=17

* Décompressez l'archive
$ tar xvfz dolibarr-2.0.1.tgz

* Recopiez les nouveaux fichiers (qui ont été décompressés dans le répertoire dolibarr-2.0.1) dans le répertoire où vous avez votre ancienne version de Dolibarr
$ cp -r dolibarr-2.0.1/* dolibarr

* Vous pouvez alors supprimer le répertoire des fichiers sources
# rm -fr dolibarr-2.0.1

* Pointez votre navigateur sur la page d'install
http://127.0.0.1/dolibarr/install/

* Choisissez ''Mise à jour'' dans le menu proposé

* Pour des raisons de sécurité nous vous conseillons, une fois la mise à jour terminée, de supprimer le répertoire d'installation. Dans le cas contraire, Dolibarr vous avertira d'un message dans l'interface une fois loggé
# rm -fr dolibarr/htdocs/install/

Installation - Mise à jour

2006-06-13T23:22:06Z

Jwarnier: /* Procédure mise a jour manuelle */

{{Navigation documentation}}
{{TemplateDocUtil}}

Les procédures suivantes décrivent comment installer ou mettre à jour Dolibarr.

== Procédure installation manuelle ==

Cette procédure décrit l'installation manuelle (recommandée) sur un système Linux (Debian, Mandrake, ...), elle est valable avec d'autres systèmes moyennant quelques modifications.
Elle est applicable pour toute version de Dolibarr >= 2.0.0

* Placez-vous dans le répertoire dans lequel installer Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)
$ cd /var/www

* Récupérez l'archive de l'application (lien ci-dessous est pour exemple)
$ wget http://dolibarrint.jexiste.fr/en/index.php?module=documents&JAS_DocumentManager_op=downloadFile&JAS_File_id=17

* Décompressez l'archive
$ tar xvfz dolibarr-2.0.1.tgz

* Renommer le répertoire dolibarr-2.0.1 en dolibarr afin d'avoir un nom de répertoire indépendant de la version
$ mv dolibarr-2.0.1 dolibarr

* En tant que root, créez, dans le répertoire dolibarr/htdocs/conf, un fichier de configuration vide, et donner lui, comme propriétaire du fichier, le user du serveur web (exemple www-data sur debian, nobody sur une vieille redhat, apache sur une version ...). Ceci est requis car le serveur web a besoin d'écrire dans ce fichier lors de l'installation.

# cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php

* Toujours en root, créez le repository qui servira aux documents générés et stockés par Dolibarr (factures pdf, images, ...), et donnez lui, comme propriétaire du répertoire, le user du serveur web (exemple www-data sur debian, nobody sur une vieille redhat, apache sur une Mandriva ou une redhat récente, ...). Le serveur web doit avoir les droits en écriture dans ce répertoire.

# mkdir documents ; chown www-data documents

* Créez une base de données vierge pour accueillir Dolibarr

# mysqladmin create dolibarr

* Pointez votre navigateur sur la page principal

http://127.0.0.1/dolibarr/

* Suivez les instructions de l'installation

* Pour des raisons de sécurité nous vous conseillons, une fois l'installation terminée, de définir en lecture seule le fichier conf.php, et de supprimer le répertoire d'installation

# chmod 600 htdocs/conf/conf.php ; rm -fr htdocs/install/

== Procédure mise à jour manuelle ==

Cette procédure décrit la mise à jour manuelle de Dolibarr (depuis une ancienne version) vers une plus récente.
Elle est applicable dès lors que la mise à jour se fait pour une version de Dolibarr >= 2.0.0

* Placez-vous dans le répertoire dans lequel a été installé Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)
$ cd /var/www

* Récupérez l'archive de la nouvelle version
$ wget http://dolibarrint.jexiste.fr/en/index.php?module=documents&JAS_DocumentManager_op=downloadFile&JAS_File_id=17

* Décompressez l'archive
$ tar xvfz dolibarr-2.0.1.tgz

* Recopiez les nouveaux fichiers (qui ont été décompressés dans le répertoire dolibarr-2.0.1) dans le répertoire où vous avez votre ancienne version de Dolibarr
$ cp -r dolibarr-2.0.1/* dolibarr

* Vous pouvez alors supprimer le répertoire des fichiers sources
# rm -fr dolibarr-2.0.1

* Pointez votre navigateur sur la page d'install
http://127.0.0.1/dolibarr/install/

* Choisissez ''Mise à jour'' dans le menu proposé

* Pour des raisons de sécurité nous vous conseillons, une fois la mise à jour terminée, de supprimer le répertoire d'installation. Dans le cas contraire, Dolibarr vous avertira d'un message dans l'interface une fois loggé
# rm -fr dolibarr/htdocs/install/

Module Mailing

2006-06-13T23:20:01Z

Jwarnier:

{{Navigation documentation}}
{{TemplateDocUtil}}

Les fonctions de mailings sont accessibles depuis le menu (sous condition que le module [[Mailing]] ait été activé).
On trouve le lien Mailing dans le menu du haut sur le gestionnaire de menu "''Defaut''" ou dans le menu "''Outil''" sur le gestionnaire de menu "''Eldy''".

- Le principe est de créer un mailing avec un titre, un sujet, un email expéditeur.

- On choisit ensuite les destinataires, dans des listes prédéfinies.

- On affine le choix issu de ces listes (pour supprimer un ou deux destinataires par exemple).

- Le responsable validation valide le contenu du mailing et sa liste de destinataires. Il peut effectuer un test vers sa propre adresse e-mail pour en vérifier le rendu sur son logiciel de messagerie.
Si le résultat et la liste des destinataires lui conviennent, il passe le mailing au statut validé.

- L'envoi du mail en masse se fait ensuite en ligne de commande via le script ''scripts/mailing-send.php''.

- Le statut global du mailing, ainsi que de le résultat de l'envoi pour chaque destinataire, est mis à jour par ce script.

Premiers paramétrages

2006-06-13T23:19:12Z

Jwarnier:

{{Navigation documentation}}
{{TemplateDocUtil}}

Après l'installation proprement dite de Dolibarr, vous devez le paramétrer pour l'adapter à vos besoins avant de le mettre en production.

== Institution ==

Pour commencer, à partir de la page d'accueil, rendez-vous dans la partie "Configuration" et éditez les informations de votre institution.
N'oubliez pas d'indiquer votre pays car certains paramétrages (TVA) en dépendent.

== Affichage ==

Cette partie vous permet de choisir la langue et la présentation des pages. Dans un premier temps vous devriez conserver les options par défaut.

== Modules ==

L'activation des modules est très importante. Elle dépend de l'utilisation que vous prévoyez faire de Dolibarr. Il est très peu probable que vous ayez besoin de la totalité des modules.
Il vous faut donc activer les modules dont vous aurez très probablement besoin. Par exemple: Sociétés, Factures éventuellement Comptabilité.

Si vous n'êtes pas sûr de vous, activez les modules les uns après les autres et voyez les fonctionnalités qu'ils ajoutent dans Dolibarr (vérifiez avant les droits, voir ci-dessous). Il est bien sûr possible de désactiver des modules après coup.

Une fois activés, certains modules nécessitent une configuration supplémentaire (cliquer sur l'icone qui apparait tout à droite sur la même ligne). Voir en particulier pour les factures [[FactureConfiguration]]

== Autre ==
Les autres entrées du menu Configuration sont des options avancées.
Il n'est pas obligatoire de les parcourir.

== Utilisateurs ==
La dernière étape consiste à créer les utilisateurs. Pour cela, vous pouvez vous rendre dans la partie "Utilisateurs & Groupes" pour définir les utilisateurs et leurs droits. Attention, pensez à définir les droits utilisateurs, et aussi à les vérifier quand vous ajoutez un module (voir plus loin).
La liste des droits disponibles dépendant des modules activés (voir plus haut), il est recommandé de configurer cette partie après avoir activé les modules désirés.
Pour certaines actions, si vous n'avez pas les droits pour faire une action, Dolibarr ne vous la proposera pas. Vous risquez de rater des choses utiles et/ou importantes.

Module Tiers

2006-06-13T23:17:18Z

Jwarnier:

{{Navigation documentation}}
{{TemplateDocUtil}}

Le module société permet de gérer les entités clients, prospects et/ou fournisseurs.

Il est un prérequis indispensable pour de nombreux autres [[Premiers paramétrages#Modules|modules]] qui se basent sur ces notions (factures, commandes, contrats, proposition commerciales, etc...).

Vous pouvez aussi créer 1 à plusieurs Contacts à l'intérieur de la Société (nécessaires pour créer ensuite une [[proposition commerciale]] ou une [[Facturation/Comptabilité|facture]]).

Une société est donc une entité métier: client, prospect ou fournisseur (Exemple: Une SARL, un commerce, une association, un particulier).
Le contact quant à lui représente une personne physique ou contact générique vers une personne physique (Exemple: PDG ou ouvrier de la SARL, vendeur principal du commerce, président ou trésorier de l'association, ou encore particulier).

Dolibarr gère de la même manière les particuliers et les entreprises. Aussi pour les particuliers, on saisira en général un "Contact" qui contient les mêmes caractéristiques que l'objet "Société".

== Créer une nouvelle société ==

Aller dans le menu Client - Nouveau client ou Prospect - Nouveau prospect ou encore Fournisseur - Nouveau fournisseur. Saisissez les informations demandées (vous n'êtes pas obligé de remplir tous les champs).

Une fois la société créée , vous pouvez ajouter des Notes dans l'onglet correspondant, et joindre des documents liés.

== Modifier une société ==
Aller dans le menu Société, cliquer sur le nom de la société à modifier.

Cliquer sur le bouton "éditer" (en bas à droite).

Saisir les modifications.

Cliquer sur le bouton "enregistrer".

== Supprimer une société ==

== Cycle de vie d'une société ==

Une société ne peut avoir qu'un seul état. Elle existe ou pas.
Une société supprimée ne change pas d'état, mais elle disparait complètement de Dolibarr.

Module Services

2006-06-13T23:06:10Z

Jwarnier: /* Définition de Services */

{{Navigation documentation}}
{{TemplateDocUtil}}

== Définition de Services ==
Les produits et services sont souvent confondus. Pourtant ils répondent à des règles différentes.
Un service est un bien non matériel qui peut être vendu, acheté ou offert. Un service peut être ponctuel ou s'inscrire dans la durée.

Voici les caractéristiques qui identifient un service:
* Un service peut être ponctuel (installation d'un matériel à domicile) ou avoir une durée (comme une garantie d'un [[Produits|Produit]])
* Un service ne peut pas se stocker dans un entrepôt
* Des services ne sont donc pas soumis à un inventaire

Module Tiers

2006-06-13T22:59:40Z

Jwarnier:

{{Navigation documentation}}
{{TemplateDocUtil}}

Le module société permet de gérer les entités clients, prospects et/ou fournisseurs.

Il est un prérequis indispensable pour de nombreux autres [[Premiers paramétrages#Modules|modules]] qui se basent sur ces notions (factures, commandes, contrats, proposition commerciales, etc...).

Vous pouvez aussi créer 1 à plusieurs Contacts à l'intérieur de la Société (nécessaires pour créer ensuite une [[proposition commerciale]] ou une facture).

Une société est donc une entité métier: client, prospect ou fournisseur (Exemple: Une SARL, un commerce, une association, un particulier).
Le contact quant à lui représente une personne physique ou contact générique vers une personne physique (Exemple: PDG ou ouvrier de la SARL, vendeur principal du commerce, président ou trésorier de l'association, ou encore particulier).

Dolibarr gère de la même manière les particuliers et les entreprises. Aussi pour les particuliers, on saisira en général un "Contact" qui contient les mêmes caractéristiques que l'objet "Société".

== Créer une nouvelle société ==

Aller dans le menu Client - Nouveau client ou Prospect - Nouveau prospect ou encore Fournisseur - Nouveau fournisseur. Saisissez les informations demandées (vous n'êtes pas obligé de remplir tous les champs).

Une fois la société créée , vous pouvez ajouter des Notes dans l'onglet correspondant, et joindre des documents liés.

== Modifier une société ==
Aller dans le menu Société, cliquer sur le nom de la société à modifier.

Cliquer sur le bouton "éditer" (en bas à droite).

Saisir les modifications.

Cliquer sur le bouton "enregistrer".

== Supprimer une société ==

== Cycle de vie d'une société ==

Une société ne peut avoir qu'un seul état. Elle existe ou pas.
Une société supprimée ne change pas d'état, mais elle disparait complètement de Dolibarr.

Premiers paramétrages

2006-06-13T22:57:17Z

Jwarnier: /* Utilisateurs */

{{Navigation documentation}}
{{TemplateDocUtil}}

Après l'installation proprement dite de Dolibarr, vous devez le paramétrer pour l'adapter à vos besoins avant de le mettre en production.

== Institution ==

Pour commencer, à partir de la page d'accueil, rendez-vous dans la partie "Configuration" et éditez les informations de votre institution.
N'oubliez pas d'indiquer votre pays car certains paramétrages (TVA) en dépendent.

== Affichage ==

Cette partie vous permet de choisir la langue et la présentation des pages. Dans un premier temps vous devriez conserver les options par défaut.

== Modules ==

L'activation des modules est très importante. Elle dépend de l'utilisation que vous prévoyez faire de Dolibarr. Il est très peu probable que vous ayez besoin de la totalité des modules.
Il vous faut donc activer les modules dont vous aurez très probablement besoin. Par exemple: Sociétés, Factures éventuellement Comptabilité.

Si vous n'êtes pas surs de vous, activez les modules les uns après les autres et voyez les fonctionnalités qu'ils ajoutent dans Dolibarr (vérifiez avant les droits, voir ci-dessous). Il est bien sûr possible de désactiver après coup les modules.

Une fois activés certains modules nécessitent une configuration supplémentaire (cliquer sur l'icone qui apparait tout à droite sur la même ligne). Voir en particulier pour les factures [[FactureConfiguration]]

== Autre ==
Les autres entrée du menu configuration sont des options avancées.
Il n'est pas obligatoire de les parcourir.

== Utilisateurs ==
La dernière étape consiste à créer les utilisateurs. Pour cela, vous pouvez vous rendre dans la partie "Utilisateurs & Groupes" pour définir les utilisateurs et leurs droits. Attention, pensez à définir les droits utilisateurs, et aussi à les vérifier quand vous ajoutez un module (voir plus loin).
La liste des droits disponibles dépendant des modules activés (voir plus haut), il est recommandé de configurer cette partie après avoir activé les modules désirés.
Pour certaines actions, si vous n'avez pas les droits pour faire une action, Dolibarr ne vous la proposera pas. Vous risquez de rater des choses utiles et/ou importantes.

Configuration module facture

2006-06-13T22:55:43Z

Jwarnier: /* Modèles de facture pdf */

{{TemplateDocUtil}}

==Module de numérotation des factures==

Chaque entreprise numérotant ses factures selon ses règles la numérotation dans Dolibarr utilise des modèles, un seul modèle à la fois peut être utilisé à ce jour. Si aucun préexistant ne vous convient, vous avez tout loisir d'en créer un spécialement ou de vous adresser à un développeur pour cela. Attention, certains modèles proposés ne respectent pas les règles comptables actuelles. Une partie au moins de la numérotation doit être constituée d'une suite continue ininterrompue (pas de remise à zéro mensuelle).

==Date des factures==
Si cette option est activée la date des factures est définie automatiquement lors de la validation, sans cette option vous êtes libre de définir la date de la facture.

==Modèles de facture pdf==

De même que pour la numérotation, vous pouvez utiliser différents modèles de factures. Pour utiliser un modèle particulier, dans le bas de la page de facturation, dans le tableau "Documents", sélectionnez le modèle et cliquez sur "Générer" pour régénérer la facture à partir de ce modèle.

Afin d'activer les différents modèles de facture que vous placeriez dans htdocs/includes/modules/facture, veillez à bien activer chaque modèle manuellement dans la configuration du module facture!

Pour visualiser les modèles de facture actuellement disponible, suivez ce lien vers l'[[apercuDesModeles]]

==Mode de règlement à afficher sur les factures==

==Options fiscales de facturation de la TVA==

Interfaces Dolibarr vers exterieur

2006-06-12T18:19:26Z

Jwarnier: /* Ajouter son code sur un évênement */

== Ajouter son code sur un événement ==

Pour permettre de déclencher du code personnalisé en réaction à un évènement Dolibarr (création/modification/suppression d'une société/facture/produit), Dolibarr propose un mécanisme de triggers. Ce mécanisme vous permet de personnaliser un workflow afin que les événements de gestion Dolibarr soient répercutés dans une autre application. Rien n'empèche également de l'utiliser pour modifier le comportement de Dolibarr même: par exemple, pour que la validation d'une facture provoque la création d'un contrat automatiquement.

Donc, pour ajouter son propre code à déclencher par trigger, la procédure est la suivante:
# Copier le fichier ''includes/triggers/interface_demo.class.php'' sous le nom ''interface_xxx.class.php'' (ou xxx est une chaine de votre choix), en laissant ce nouveau fichier dans le même répertoire. Par exemple ''includes/triggers/interface_monworkflow.class.php''
# Editer ce fichier ''interface_monworkflow.class.php'' afin de renommer la classe ''InterfaceDemo'' par ''InterfaceMonWorkflow'' et ajouter votre code dans la fonction ''run_trigger''. Cette fonction est appelée à chaque événement Dolibarr. Placer votre code en fonction du ou des événements sur lesquels vous voulez réagir, chaque événement étant identifié par un test sur la variable $action:

function run_trigger($action,$object,$user,$lang,$conf)
{
// Mettre ici le code à exécuter en réaction de l'action
// Le type de l'évènement Dolibarr est stocké dans $action
// Les données de l'action sont stockées dans $object
// La configuration, utilisateur et langage sont dans $conf,$user et $lang
if ($action == 'COMPANY_CREATE')
{
dolibarr_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_MODIFY')
{
dolibarr_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_DELETE')
...
}

Il n'y a plus qu'à tester, en provoquant l'événement déclencheur dans Dolibarr.

== Gérer de nouveaux évènements ==

Les évènements Dolibarr qui provoquent un appel de triggers sont, pour l'instant, identifiés par les codes évènements suivants:

* USER_CREATE
* USER_MODIFY
* USER_DISABLE
Dans ces 3 cas, la variable $object contient un objet de type user.class.php

* COMPANY_CREATE
* COMPANY_MODIFY
* COMPANY_DELETE
Dans ces 3 cas, la variable $object contient un objet de type societe.class.php

* PRODUCT_CREATE
* PRODUCT_MODIFY
* PRODUCT_DELETE
Dans ces 3 cas, la variable $object contient un objet de type product.class.php

* ORDER_CREATE
* ORDER_MODIFY
* ORDER_DELETE
Dans ces 3 cas, la variable $object contient un objet de type commande.class.php

* PROPAL_CREATE
* PROPAL_MODIFY
* PROPAL_VALIDATE
* PROPAL_CLOSE_SIGNED
* PROPAL_CLOSE_REFUSED
Dans ces 5 cas, la variable $object contient un objet de type societe.class.php

* CONTRACT_CREATE
* CONTRACT_MODIFY
* CONTRACT_ACTIVATE
* CONTRACT_CANCEL
* CONTRACT_CLOSE
* CONTRACT_DELETE
Dans ces 6 cas, la variable $object contient un objet de type contract.class.php

* BILL_CREATE
* BILL_MODIFY
* BILL_VALIDATE
* BILL_CANCEL
* BILL_DELETE
Dans ces 5 cas, la variable $object contient un objet de type facture.class.php

* PAYMENT_CUSTOMER_CREATE
Dans ce cas, la variable $object contient un objet de type paiement.class.php

* PAYMENT_SUPPLIER_CREATE
Dans ce cas, la variable $object contient un objet de type paiementfourn.class.php

* MEMBER_CREATE
* MEMBER_VALIDATE
* MEMBER_SUBSCRIPTION
* MEMBER_MODIFY
* MEMBER_RESILIATE
* MEMBER_DELETE
Dans ces cas, la variable $object contient un objet de type adherent.class.php

Pour gérer d'autre évènements que ceux ci-dessus, il faut modifier le code Dolibarr pour y ajouter la séquence suivante dans les méthodes métiers des classes utilisées pour gérer les évenements:

// Appel des triggers
include_once(DOL_DOCUMENT_ROOT . "/interfaces.class.php");
$interface=new Interfaces($this->db);
$interface->run_triggers('XXXXX_YYYYYY',$this,$user,$lang,$conf);
// Fin appel triggers

Ici, $this doit être l'objet de la classe métier qui contient toutes les informations à passer au trigger. Remplacer, de plus, le 'XXXXX_YYYYYY' par un code évènement non déjà utilisé.
Il sera alors possible d'ajouter dans la méthode run_trigger, un if qui permet de gérer ce code. La méthode run_trigger serait alors de la forme :

function run_trigger($action,$object,$user,$lang,$conf)
{
// Mettre ici le code à exécuter en réaction de l'action
// Le type de l'évènement Dolibarr est stocké dans $action
// Les données de l'action sont stockées dans $object
// La configuration, utilisateur et langage sont dans $conf,$user et $lang
<b>
if ($action == 'XXXXX_YYYYY')
{
dolibarr_syslog("Trigger for action '$action' launched. id=".$object->id);
}
</b>
elseif ($action == 'COMPANY_CREATE')
{
dolibarr_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_MODIFY')
{
dolibarr_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_DELETE')
...
}

FAQ Développeur

2006-06-08T16:32:27Z

Jwarnier: /* Modification du code, participer au développement */

== Utilisation du cvs ==

Sur le forum dolibarr:
[http://forum.dolibarr.com/viewforum.php?f=12 Forum cvs]

== Modification du code, participer au développement ==

* '''Avec accès CVS en ecriture '''
A ce jour, les accès en écriture au CVS sont restreint (le nombre de commit étant déjà suffisemment dynamique). Il n'est pas exclu d'accueillir d'autres développeurs en modification à d'autres horizons. Si vous bénéficiez donc à l'heure actuel d'un accès CVS en écriture, utilisez-le. Sinon, il est nécessaire de suivre la procédure qui suit (Modification du code, sans accès CVS en ecriture)

* '''Sans accès CVS en ecriture'''
Si vous n'avez pas de compte développeur, il est nécessaire de fournir par mail, votre fichier patch.

Sous tout OS:

Voici la ''méthode Pro'' selon laquelle travailler pour pouvoir générer un tel fichier patch:

- Avoir un répertoire qui contient la version de Dolibarr de référence (résultat de la mise a jour CVS ou bien tout simplement l'arborescence résultant de la décompression d'un snapshot tgz de Dolibarr). On appelera ce répertoire '''ancien_rep'''. Vous pouvez récuperer le snapshot de la version de dev en cours en cliquant [http://forum.dolibarr.com/files/dolibarr_lastcvs.tar.gz ce lien].

- Avoir un autre répertoire qui contient l'arborescence de Dolibarr mais dans laquelle vous faites ou avez fait vos modifications. On appelera ce répertoire '''nouveau_rep'''.

Pour générer le fichier patch, il suffit alors de lancer la commande ''diff'' (en standard sous Linux, fourni dans cygwin sous Windows) de la manière suivante:
<pre>
diff -Naur ancien_rep nouveau_rep > fichier.patch
</pre>
Envoyer votre patch sur la ML.
L'intégration de votre patch n'est toutefois pas garantie, pas plus que le délai.

Sous Windows:

Si vous êtes sous Windows, une ''méthode moins Pro'' mais qui donne le même résultat est la suivante. Installer l'excellent outil open source de comparaison Winmerge qui sait fabriquer des patchs au format ''diff -Naur''. Pour cela, comparer avec Winmerge le fichier référence et le fichier modifié et choisir dans le menu ''"Tools - Generate patch"''. Saisir un nom de fichier comme ''"resultat.patch"'', cocher la case ''"Append"'' et choisir l'option ''"Format Unified"''. Cliquer sur ''"Ok"''.
Éventuellement recommencer pour chaque fichier modifié.
Au final, on obtient un beau fichier ''resultat.patch'' qui contient toutes les modifications au bon format.

== Mettre a jour la version développeur ==

La première opération consiste à récupérer les dernières versions CVS (Voir FAQ [http://forum.dolibarr.com/viewforum.php?f=13 Forum cvs] pour cela). Les nouveaux fichiers annulent et remplacent les anciens.

Le deuxième étape consiste à migrer la base. Pour cela aller dans le répertoire mysql/migration et exécuter le script de migration qui correspond le mieux à votre cas. Par exemple, si vous êtes en version 1.2, ou 2.0 dev, il vous faut prendre le script de migration 1.1.0-2.0.0.sql
La règle est que: La version à gauche du tiret doit être inférieure ou égale à votre version actuele, la version à droite du tiret, doit etre la plus élevée possible, le CVS contenant le travail pour cette version).

- Si votre version est exactement celle à droite du tiret, le script de migration doit s'exécuter sans erreur.
<pre>
mysql -uuser -ppassword -Dnom_base_dolibarr < nomscript.sql
</pre>
- Si votre version est entre les deux, (parce que vous avez déjà fait une mise à jour CVS par exemple), vous aurez des erreurs à l'exécution du script. Ignorez les. Pour cela, sous mysql, vous devez lancer le script sql avec l'option -f:
<pre>
mysql -f -uuser -ppassword -Dnom_base_dolibarr < nomscript.sql
</pre>

== Comment créer un nouveau theme ==
Voir pour cela la page [[Themes]]

== Comment développer mon propre système de menu ==
Voir pour cela la page [[Système_de_menus]]

== Comment ajouter une traduction ==
Voir pour cela la page [[Documentation_traducteur]]

== Changer mon système de numérotation des factures en cours de route ==
Si le nouveau système de numérotation n'entre pas en conflit avec l'ancien, il suffit d'aller dans le menu Configuration - Modules - Configuration factures et prendre un nouveau modèle dans la liste.
Si le nouveau système rentre en conflit, il est nécessaire de renuméroter vos références existantes. Cela peut-être fait avec une requête SQL.
Par exemple, pour passer de Jupiter (FYYYYMM99) à Terre (FAYYMM-999), vous pouvez exécuter la requête suivante:
<pre>
update llx_facture set facnumber=concat('FA',substr(facnumber,4,4),'-',substr(facnumber,8))
where facnumber like 'F%' and facnumber not like 'FA%';
</pre>

Par exemple, pour passer d'un modele FAYYMM999 à Terre (FAYYMM-999), vous pouvez exécuter la requête suivante:
<pre>
update llx_facture set facnumber=concat('FA',substr(facnumber,3,4),'-',substr(CONCAT('0000',substr(facnumber,7)),-4))
where facnumber like 'FA%' and facnumber not like '%-%';
</pre>

== Comment devenir développeur ==
Voir pour cela la page [[Devenir développeur]]