FAQ Desarrolladores

Volver al índice
Documentación desarrolladores

Page waiting for translation. To translate, create an account, go back and clic on "Modify". Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier". Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar". Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica". Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar". Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten". 页面等待翻译。若要翻译本页，先创建一个帐户、登录并返回本页后单击“编辑”。

Recuperar/actualizar una versión CVS de desarrollo

Realizar un guardado de sus datos y su configuración

Si ya dispone de una instalación en marcha, guarde su fichero htdocs/conf/conf.php.

Recuperación última versión de los fuentes por descarga

Este método permite recuperar la versión CVS de la rama principal de desarrollo (llamada HEAD). La operación consiste en recuperar la última versión de los ficheros de Dolibarr que són reagrupados cada noche en un zip. Para ello, vaya a versión CVS del día. Los nuevos archivos sobrescribirán a los antiguos.

Recuperación última versión de los fuentos por CVS

Para recuperar la última versión en fase de desarrollo, puede utilizar directamente el servidor CVS en modo anónimo, si dispone de un cliente CVS (comandos CVS en Linux, ó TortoiseCVS en Windows, por ejemplo).

El comando que permite recuperar una instantánea integral (sin seguimiento cvs) en la carpeta actual es:

CVSROOT=:pserver:anonymous@cvs.savannah.nongnu.org:/sources/dolibarr
export CVSROOT
cvs -q checkout -r HEAD -d ./ dolibarr/

HEAD significa que queremos la última versión en fase de desarrollo.

El comando que permite actualizar localmente una copia de trabajo CVS que ya ha sido recuperado:

En Linux (script shell):

CVSROOT=:pserver:anonymous@cvs.savannah.nongnu.org:/sources/dolibarr
export CVSROOT
cvs -q update -P -d

En windows con Tortoise cvs

"C:\Program Files\CVSNT\cvs.exe" -q update -P -d
CVSROOT=:pserver:anonymous@cvs.savannah.nongnu.org:/sources/dolibarr

Y para dejar su copia local anulando sus modificaciones con los ficheros integrados en cvs:

"C:\Program Files\CVSNT\cvs.exe" -q update -P -C -d
CVSROOT=:pserver:anonymous@cvs.savannah.nongnu.org:/sources/dolibarr

Si es necesario, modifique los derechos de propiead de los dosiers, para que el servidor tenga acceso.

Recuperación de otra rama en el CVS

Si desea una versión particular (con sus patchs), debe seguir el mismo procedimiento que el anterior pero sustituyendo HEAD con el nombre de la rama. Por ejemplo DOLIBARR_2_2_BRANCH para la rama 2.2 ó DOLIBARR_2_4_BRANCH para la rama 2.4.

Restaurar su configuración

Restaure el fichero de configuración (./htdocs/conf/conf.php) de su copia de seguridad si lo ha desconfigurado

Actualización de la base de datos

El segundo paso es migrar la base de datos. Para ello, simplemente vaya a http://maracinedolibarr/install/ y escoja la opción "Mise à jour".

Este procedimiento de migración/actualización está diseñado para funcionar independientemente del estado de inicio y puede ser realizado varias veces sin riesgo.

Iniciar el desarrollo

Consulte totalmente la Documentación Desarrolladores para asimilar todas las normas y principios impusetos a los desarrolladores. También puede consular los siguientes FAQ.

Cómo crear un nuevo Tema

Para ello consulte la página Temas

Cómo desarrollar mi própio sistema de menús

Para ello consulte la página Sistema_de_menus

Cómo desarrollar mi própio módulo

Para ello consulte la página Desarrollo_de_un_módulo

Cómo añadir o completar una traducción

Para ello consulte la página Documentación Traductores

Cambiar mi sistema de numeración de las facturas en curso

Si el nuevo sistema de numeración no entra en conflicto con el antiguo, será suficiente con ir al menú Configuración - Módulos - Configuración facturas y escojer un nuevo modelo de la lista. Si el nuevo sistema entra en conflicto, será necesario renumerar las referencias existentes. Esto se puede realizar mediante una consulta SQL. Por ejemplo, para pasar de Jupiter (FYYYYMM99) a Terre (FAYYMM-999), puede ejecutar la siguiente consulta:

update llx_facture set facnumber=concat('FA',substr(facnumber,4,4),'-',substr(facnumber,8))
where facnumber like 'F%' and facnumber not like 'FA%';

Por ejemplo, para pasar de un modelo FAYYMM999 a Terre (FAYYMM-999), puede ejecutar la siguiente consulta:

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 '%-%';

Enviar un parche, mejora o participar en el desarrollo

• Con acceso CVS en modo escritura

A día de hoy, los accesos en escritura a CVS están restringidas (el número de confirmaciones és bastante dinámico). Si usted posee en la actualidad de un acceso en escritura CVS, utilícelo con la condición de que sus confirmaciones corresponden a su grado de desarrollador Dolibarr (Ver FAQ Desarrolladores - Convertirse en desarrollador oficial para los diferentes grados). Si no dispone de acceso a CVS (usted está en el grado de miembro o cazador de la alianza Dolibarr), deberá seguir el procedimento que sigue a continuación..

• Sin acceso CVS en escritura

Sin acceso CVA en escritura (sin cuenta desarrollador savannah), será necesario que envíe su fichero parche por correo.

En todos los SO:

He aquí el método Pro de como trabajar para poder generar un fichero patch:

- Tener una carpeta con la versión de referencia Dolibarr (resultante de la actualización desde CVS o bien el resultante de la descompresión de un snapshot tgz de Dolibarr). Llamaremos a esta carpeta viejo_rep. Puede recuperar el snapshot de la versión de desarrollo en curso en web ofical de Dolibarr.

- Tener otra carpeta que contiene Dolibarr pero en la que realiza o ha realizado sus modificaciones. Llamará a esta carpeta nuevo_rep.

para generar el fichero patch, deberá ejecutar el comando diff (estándard de Linux, en windows cygwin) de la siguiente manera:

diff -Naur --exclude=CVS --exclude=".#*" --exclude="*~" --exclude='*.rej' --exclude='*.orig'
 --exclude="*.bak" --exclude=conf.php --exclude=documents  ancien_rep  nouveau_rep  > fichier.patch

Envíe su parche en el ¿ML?. la integración de su parche no está garantizada, pero si el parche ha sido realizado siguiendo rigurosamente este procedimiento, tiene muchas posibilidades de que sea testeado (de otro modo las posibilidades estarán cercanas a 0).

Bajo Windows:

Si trabaja bajo Windows, un método menos Pro pero que dá el mismo resultado es el siguiente: Intale la excelente utilidad open source de comparación Winmerge, que puede realizar parches en formato diff -Naur. Para ello, compare con Winmerge el fichero de referencia y el modificado y escoja en el menú "Herramientas - Crear correción" (Générer des retouches en la versión francesa). Indicar un nombre de fichero como "resultat.patch", Marcar la casilla "Añadir" y escojer la opción de estilo "Unificado" (Style : unifié en la versión francesa). Haga clic en "Aceptar". Repetir el proceso para cada fichero modificado. Finalmente, obtendremos un bonito fichero que contiene todas las modificaciones en el formato correcto.

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.

Appliquer un patch Si votre patch n'a pas encore été appliqué, mais que vous souhaitez de votre coté l'appliquer sur votre serveur linux fraichement mis à jour depuis la CVS, cela est possible grace à l'utilitaire patch. En admettant que vous avez créé votre patch à partir du répertoire htdocs de votre copie locale du cvs modifiée par vos soins, et que vous avez envoyé votre patch (monfichier.patch) sur le serveur dans le dossier patchs situé au meme niveau que votre dossier htdocs distant, la commande suivante devrait faire l'affaire (executée depuis le dossier patchs):

patch -u -p0 -d ../htdocs < monfichier.patch

Pour information: -p0 permet d'utiliser le chemin entier tel que mentionné dans le fichier de patch (-pn en retire les n premiers niveau de l'arborescence) -d permet de préciser le chemin relatif vers le dossier htdocs à patcher. < permet de donner le chemin vers le fichier source à utiliser (le patch en mode unifié) -u permet de préciser que le patch est en mode unifié

Comment packager/livrer un module pour utilisation

Para ello consulte la página Desarrollo_de_un_módulo

Comment devenir développeur officiel

Dans la galaxie du projet Dolibarr, il existe plusieurs intervenants de différents niveaux/grades. Le nombre de développeurs et contributions est important, hors tout projet qui veut atteindre un certains niveau de qualité se doit d'avoir une gestion contrôlée et des modifications validées des évolutions, aussi bien au niveau des besoins fonctionnels que du code. Pour cette raison, les accès en écriture sur les sources (serveur CVS) sont limités et régies par une organisation qui est décrite dans les lignes qui suivent. Chaque développeur a un grade qui dépend de son ancienneté et de ces contributions passées. Le niveau d'habilitations d'une personne sur le projet augmente avec les étapes de promotion de grade.

Le cursus d'un développeur Dolibarr passe donc par ces étapes, que l'on classe par un titre familié aux adeptes de sciences fictions. Voici ces étapes. Il est important de comprendre que cette organisation a pour seul but d'améliorer la qualité de Dolibarr et qu'il est nécessaire qu'elle soit rigoureusement respectée afin d'attendre ce but. Ne soyez donc pas offensé si, en tant que développeur, vous ne pouvez disposer d'un accès CVS en écriture avant un certain délai.

• Membre de l'alliance

La première chose qu'une personne désireuse d'aide doit faire et d'abord se familiariser avec les règles et normes de développements. En lisant toute la Documentation Développeur, vous faites preuve de volonté suffisante pour devenir automatiquement Membre de l'alliance Dolibarr (Votre grade est au niveau Membre). Et tout lire, c'est pas le plus facile...

Ce grade s'obtient sans validation supérieure.

• Chasseur de l'alliance

L'étape suivante consiste à soumettre des patch, en commençant par des simples, soit sur la Mailing List dev (voir FAQ Développeur pour la procédure), soit sur le forum (Mailing List préférée).

A votre première soumission acceptée (incluse dans le CVS par un Amiral ou Jedi), vous entrez alors automatiquement dans la famille des Chasseurs de l'alliance Dolibarr.

Le nombre de chasseurs n'est pas limité. Plus, il y en aura, plus on sera fort. Les chasseurs représentent la force vive principale de l'alliance Dolibarr.

• Amiral de l'alliance

Ce n'est qu'au bout d'un temps variable (qui peut être très long) au rang de Chasseur, et si la qualité des patch qui ont été envoyée est satisfaisante, qu'un Yoda en place vous offrira un accès CVS direct. Vous êtes devenu un Amiral de l'alliance Dolibarr.

Ce titre ne se demande pas, il s'obtient par décision ou proposition d'un Jedi ou Yoda qui estime que vous avez soumis suffisamment de patch pour être un sérieux Amiral. L'accès CVS d'un Amiral doit cependant n'être utilisé que pour commiter soit des traductions, soit des corrections de bugs déclarées sur Savannah ou le forum (que ces corrections soit personnelles ou issues d'un patch soumis par un Chasseur). Tout commit CVS doit ainsi obligatoirement inclure, dans la description (le champ log de commit), le numéro du bug Savannah corrigé OU le titre du message du forum signalant le problème. Seul une traduction échappe à cette contrainte (pas de restrictions pour les traductions). Le non respect de cette contrainte, peut provoquer une rétrogradation au rang de Chasseur. Pour la soumission de nouvelles fonctionnalités, il faut donc obligatoirement continuer sur le principe de patchs envoyés sur la ML.

L'obtention du grade d'Amiral est toutefois rare car limité. La qualité de Dolibarr ne pouvant être atteinte que par un nombre d'Amiraux contrôlé, ce qui n'empêche pas d'avoir un nombre de développeurs (Chasseurs) très important (grâce au système de patch).

• Jedi

C'est encore au bout d'un temps variable (surement le plus long de tous) au rang d'Amiral, et si la qualité des patch qui ont été envoyée est satisfaisante, qu'un Yoda vous signalera que vous êtes autorisé à réaliser des commits sans restrictions de fonctionnalités, à condition d'avoir cependant l'aval de principe d'un Maitre Yoda à qui vous aurez expliquer la fonctionnalité. Il peut toutefois y avoir une restriction temporaire définie par un Yoda pour raison de release proche. Vous êtes alors devenu un Jedi.

Ce titre ne se demande pas, il s'obtient par proposition d'un autre Jedi ou d'un Yoda.

Ce privilège est toutefois exceptionnel. La qualité de Dolibarr ne pouvant être atteinte que par un nombre de Jedi contrôlé, ce qui n'empêche pas d'avoir un nombre de développeurs (Chasseurs) très important (grâce au système de patch).

• Yoda

Au nombre de 1 à 5, être un Yoda, c'est assurer la gestion globale du développement du projet. Ce rang s'obtient par succession, suite au départ d'un Yoda qui se retire, par nomination directe ou vote organisé par le Yoda partant.

...Et Dark Vador alors ?

Il existe. Dans la galaxie Dolibarr, on qualifie de Dark Vador, le parasite qui pollue le forum ou la mailing-list de messages ou critiques non constructives, qui ralentissent le développement de Dolibarr plutôt que d'offrir des critiques constructives qui aident à progresser. La mauvaise foie ou le mauvais ton est souvent de rigueur chez les Dark Vador... Heureusement, statistiquement, on ne constate l'apparition et la mort que d'un seul Dark Vador par an environ...

Voir la page Le projet Dolibarr pour connaitre la liste des personnes à chaque grade actuellement.