Dolibarr ERP CRM Wiki - User contributions [en]

FAQ Développeur

2006-12-10T18:45:17Z

Lionel.a: /* Soumettre une modification ou participer au développement */

== Mettre à 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 doivent écraser les anciens.

Le deuxième étape consiste à migrer la base. Pour celà, il suffit d'appeler la page
http://maracinedolibarr/install/
et choisir l'option "Mise à jour".

Cette procédure de migration/mise à jour est conçue pour fonctionner quel que soit l'état de départ et peut être repassée plusieurs fois sans risque.

== Soumettre une modification ou participer au développement ==

* '''Avec accès CVS en écriture '''
A ce jour, les accès en écriture au CVS sont restreints (le nombre de commit étant déjà suffisamment 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 actuelle 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 écriture'''
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 à 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_snapshot.tgz 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"'' (''Générer des retouches'' en version française). Saisir un nom de fichier comme ''"resultat.patch"'', cocher la case ''"Append"'' et choisir l'option ''"Format Unified"'' (''Style : unifié'' en version française). 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.

Au lieu de rechercher manuellement vos fichiers, si vous avez installé conjointement ''TortoiseCVS'' et ''Winmerge'', vous pouvez vous contenter de votre version modifiée sur votre ordinateur, et de la version CVS en ligne. Sous l'explorateur Windows, faites un clic droit sur le fichier qui doit être patché, et choisissez "CVS comparer" (pas WinMerge qui se trouve quelques lignes plus bas). Tortoise va lui-même lancer WinMerge. Puis reprenez la procédure décrite ci-dessus.

== Utilisation du cvs ==

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

== 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 développer mon propre module ==
Voir pour cela la page [[Developpement_module]]

== 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]]

FAQ Développeur

2006-12-10T10:51:41Z

Lionel.a: /* Soumettre une modification ou participer au développement */

== Mettre à 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 doivent écraser les anciens.

Le deuxième étape consiste à migrer la base. Pour celà, il suffit d'appeler la page
http://maracinedolibarr/install/
et choisir l'option "Mise à jour".

Cette procédure de migration/mise à jour est conçue pour fonctionner quel que soit l'état de départ et peut être repassée plusieurs fois sans risque.

== Soumettre une modification ou participer au développement ==

* '''Avec accès CVS en écriture '''
A ce jour, les accès en écriture au CVS sont restreints (le nombre de commit étant déjà suffisamment 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 actuelle 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 écriture'''
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 à 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_snapshot.tgz 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"'' (''Générer des retouches'' en version française). Saisir un nom de fichier comme ''"resultat.patch"'', cocher la case ''"Append"'' et choisir l'option ''"Format Unified"'' (''Style : unifié'' en version française). 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.

== Utilisation du cvs ==

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

== 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 développer mon propre module ==
Voir pour cela la page [[Developpement_module]]

== 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]]

FAQ Développeur

2006-12-08T11:01:55Z

Lionel.a: accents

== Mettre à 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 doivent écraser les anciens.

Le deuxième étape consiste à migrer la base. Pour celà, il suffit d'appeler la page
http://maracinedolibarr/install/
et choisir l'option "Mise à jour".

Cette procédure de migration/mise à jour est conçue pour fonctionner quel que soit l'état de départ et peut être repassée plusieurs fois sans risque.

== Soumettre une modification ou participer au développement ==

* '''Avec accès CVS en écriture '''
A ce jour, les accès en écriture au CVS sont restreints (le nombre de commit étant déjà suffisamment 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 actuelle 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 écriture'''
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 à 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_snapshot.tgz 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.

== Utilisation du cvs ==

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

== 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 développer mon propre module ==
Voir pour cela la page [[Developpement_module]]

== 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]]