Desarrollo de un módulo
Para crear un nuevo módulo hay distintas fases a seguir. Este tutorial tiene como meta describir cada una de estas fases con el fin de ayudar a comprender las posibilidades de Dolibarr, como por ejemplo añadir una o varias de las siguientes funcionalidades:
- Añadir nuevas tablas a la base de datos.
- Añadir sus propias entradas en los menús.
- Añadir pantallas de edición/consulta de nuevas tablas.
- Añadir o eliminar pestañas en las páginas de vista/edición de objetos (factura, producto, pedido, evento, etc.)
- Añadir exportaciones predefinidas a la función “Exportar”.
- Añadir variables de substitución
- Añadir nuevas cajas a la página de inicio.
- Definir nuevos permisos.
- Activar código automático sobre una acción particular de Dolibarr.
- Insertar nuestro código mediante los hooks de Dolibarr
- Añadir un módulo de numeración
- Añadir un modelo de documento
- Añadir un nuevo tema
etc.
Crear un módulo
Los capítulos siguientes describen las acciones a realizar para crear un módulo Dolibarr. Los primeros capítulos son obligatorios cualquiera que sea la vocación de los módulos, los siguientes dependerán de lo que deba hacer el módulo
Crear un descriptor de Módulo (obligatorio)
Cuándo: Obligatorio cada vez que se desarrolla una extensión, cualquiera que sea su finalidad.
Crear su descriptor
La primera fase es la de crear un fichero descriptor del módulo. Para ello:
- Crear el directorio /htdocs/mimodulo/core/modules. Seguidamente ir al directorio htdocs/modulebuilder/template y copiar el archivo modMyModule.class.php en el directorio htdocs/mimodulo/core/modules.
A continuación, modificar el contenido del archivo, reemplazando:
- los "modMyModule" por un valor que corresponda a la finalidad de su módulo. Este valor debe siempre comenzar por mod.
ATENCIÓN: El MiModulo debe estar compuesto por una serie de caracteres, siendo los únicos permitidos [A-Za-z_] con longuitud max de MyModule de 12 caracteres.
- $this->numero = 100000 por un número de módulo que esté libre. Ver Listado de los id de módulos
- Modificar eventualmente otras variables definidas por los desarrolladores (ver el comentario en el código del esqueleto para ver su significado)
- Crear el directorio /htdocs/mimodulo/
Ahora su fichero descriptor está configurado.
Probar su descriptor
Ejecute Dolibarr y vaya a la página "Configuración > Módulo". Debería aparecer una nueva línea con su nuevo módulo y la posibilidad de activarlo o no (eche un vistazo a todas las pestañas de cada categoría para encontrarlo). Es el valor $this->special el que determina en qué pestaña se encuentra su módulo.
Árbol de un nuevo módulo
Crear un directorio 'mimodulo' que contendrá los archivos del módulo. Este directorio debe de estar en el directorio htdocs y contendrá los siguientes subdirectorios:
- mymodule/* contains php pages (note that you can also add any other subdir of your choice). Note: If your module is a metapackage (a module that will embed other modules in same zip, you must put here a file metapackage.conf)
- mymodule/build/ can contains any file you develop for compiling or building package
- mymodule/core/modules/ contains module descriptor file modMyModule.class.php
- mymodule/core/triggers contains triggers provided by module
- mymodule/admin/ contains pages to setup module
- mymodule/class/ contains PHP class files provided by module
- mymodule/css contains CSS files provided by module
- mymodule/js contains javascirpt files provided by module to add new functions
- mymodule/docs to provide doc and licence files
- mymodule/img contains images files provided by module
- mymodule/langs/xx_XX contains language files for language xx_XX (try to put at least en_US)
- mymodule/lib contains libraries provided and used by module
- mymodule/scripts to provide command line tools or scripts. Note: Command lines script must start with line #!/usr/bin/env php
- mymodule/sql contains SQL file provided by module to add new tables or indexes
- mymodule/theme/mytheme if module provide its own theme/skin
Crear sus tablas SQL y la clase PHP con los métodos de acceso (opcional)
Cuándo: Si su módulo necesita gestionar sus propios datos.
Crear sus ficheros .sql
Si su módulo de verdad requiere administrar datos que no existen en la base de datos en la versión estándar de Dolibarr, será necesario definir ciertas tablas SQL para registrar esos datos.
Revisa que en el descriptor de archivo (mymodule/core/modules/mymodule.class.php) la línea
$this->_load_tables('/mymodule/sql/');
esté descomentada y correctamente configurada.
Cree un subdirectorio sql en el directorio de su módulo (por ejemplo, htdocs/mimodulo/sql), con el fin de colocar los scripts sql que va a crear.
Regla a respetar:
- Agregue los archivos de orden de creación de sus tablas siguiendo el principio de un fichero llx_mitabla.sql por tabla, eventualmente acompañado del archivo llx_mitabla.key.sql' (ver los archivos existentes en install/mysql/tables, para tomar ejemplo).
- The recommended type and name for SQL fields are defined into page Language_and_development_rules#Table_and_fields_structures.
- En términos de orden de gestión de datos, todos deben estar en un archivo llamado data.sql situado en la misma carpeta /mimodulo/sql/.
Ejemplo de contenido de un fichero data.sql
delete from llx_const where name='MYMODULE_IT_WORKS' and entity='__ENTITY__';
insert into llx_const (name, value, type, note, visible, entity) values ('MYMODULE_IT_WORKS','1','chaine','A constant vor my module',1,'__ENTITY__');
Las órdenes SQL de los archivos deben de ser operacionales para la base de datos mysql. Nota: Los archivos de otras bases de datos no se mantienen. Se leen y se convierten al vuelo por el driver de la base de datos.
Probar su archivo .sql
Una vez que los archivos estén listos, puede volver a Dolibarr para desactivar el módulo, eliminar las tablas de la base de datos y reactivar el módulo. Las tablas deben ser recreadas por la activación del módulo. Si no es así, verifique sus scripts o consulte los logs Dolibarr.
Generar la clase PHP de acceso (DAO)
Una vez que sus tablas estén creadas en la base de datos, vaya al directorio dev/skeletons, copie el archivo build_class_from_table.php en el directorio sql/ de su módulo module, y ejecute el script
php build_class_from_table.php nombretabla
Nota: Si el comando no funciona, intente con php-cli en lugar de php.
Esto genera un archivo out.nombretabla.class.php que contiene la clase de gestión de la tabla “nombretabla”. En esta clase se encuentran los métodos CRUD (Create/Read/Update/Delete) ya operativos para hacer un insert, un fetch (select), un update, y un delete de una línea de la tabla. Suprima justo el "out" del nombre del archivo y póngalo en un subdirectorio de htdocs propio en su módulo (Por ejemplo en htdocs/mimodulo).
Un archivo out.nombretabla_script.php se genera igualmente y contiene un ejemplo de código para utilizar la clase para cada uno de los cuatro métodos CRUD.
Visualización de pestañas (opcional)
Añadir o eliminar pestañas en las fichas entidad
Cuándo : Para añadir su propia pestaña en las pestañas estándar de una ficha entidad (factura, pedido, presupuesto, miembro...)
Para ello, vaya al archivo descriptor del módulo creado anteriormente y modifique la tabla $this->tabs:
// Array to add new pages in new tabs or remove existing one
$this->tabs = array('objecttype:+tabname1:Title1:@mymodule:/mymodule/mynewtab1.php?id=__ID__', // To add a new tab identified by code tabname1
'objecttype:+tabname2:Title2:@mymodule:/mymodule/mynewtab2.php?id=__ID__', // To add another new tab identified by code tabname2
'objecttype:-tabname'); // To remove an existing tab identified by code tabname
La tabla debe contener una lista de cadena, cada cadena representa una nueva pestaña. El formato de la cadena se compone de 4 partes separadas por ":"
- Parte 1: El código de la entidad (objecttype) en la que debe aparecer la pestaña siendo el valor de ella misma:
- 'thirdparty' para añadir una pestaña en la vista de tercero
- 'intervention' para añadir una pestaña en la vista de intervención
- 'order_supplier' para añadir una pestaña en la vista de pedido a proveedor
- 'invoice_supplier' para añadir una pestaña en la vista de factura de proveedor
- 'invoice' para añadir una pestaña en la vista de factura a cliente
- 'order' para añadir una pestaña en la vista de pedido de cliente
- 'product' para añadir una pestaña en la vista de producto
- 'stock' para añadir una pestaña en la vista de stock
- 'propal' para añadir una pestaña en la vista de presupesto a cliente
- 'member' para añadir una pestaña en la vista de miembro
- 'contract' para añadir una pestaña en la vista de contrato
- 'user' para añadir una pestaña en la vista de usuario
- 'group' para añadir una pestaña en la vista de grupo
- 'contact' para añadir una pestaña en la vista de contacto
- 'categories_x' para añadir una pestaña en la vista de categoría (reemplazar 'x' por el típo de categoría (0=producto, 1=proveedor, 2=cliente, 3=miembro)
- Parte 2: El título de la pestaña. Puede ser una etiqueta directa o mejor un código de traducción de un archivo lang.
- Parte 3: El nombre del archivo .lang (sin la extensión .lang) que contiene la correspondencia entre el código de traducción y la etiqueta a mostrar. Si el nombre empieza con @, Dolibarr buscará el archivo en el directorio lang del propio módulo, es decir, htdocs/mimodulo/langs/code_CODE/mimodulo.lang, de lo contrario Dolibarr buscará el archivo de en /langs/code_CODE/mimodulo.lang
- Parte 4: La url de la página a mostrar cuando se haga click en las pestaña. La cadena __ID__ será reemplazada automáticamente por el Id de la entidad concerniente.
Para alimentar el contenido de la pestaña con los datos de la base de datos, vea el capítulo siguiente.
Añadir pestañas de una ficha entidad en su propia página
Cuándo : Para mostrar las pestañas estándar de ficha entidad (producto, tercero, etc.) en su propia pestaña de una entidad.
Hay que hacer lo siguiente :
1. Incluir los archivos que definen las funciones útiles dentro de sus archivos
Para cada ficha entidad, hay que incluir dos archivos con la instrucción
require_once($url_fichier) ;
Aquí le mostramos la lista de estos archivos (DOL_DOCUMENT_ROOT correspondiente al directorio dolibarr/htdocs/) :
- Entidad tercero (thirdparty) :
- DOL_DOCUMENT_ROOT/societe/class/societe.class.php
- DOL_DOCUMENT_ROOT/core/lib/company.lib.php
- Entidad producto (product) :
- DOL_DOCUMENT_ROOT/product.class.php
- DOL_DOCUMENT_ROOT/lib/product.lib.php
- Entidad factura (invoice) :
- DOL_DOCUMENT_ROOT/facture.class.php
- DOL_DOCUMENT_ROOT/lib/invoice.lib.php
2. Crear y cargar el objeto a mostrar en su pestaña
Crear el objeto de la clase deseada, y recuperar los datos del objeto a partir de la base de datos. Para ello deberá utilizar las funciones fetch() de la clase correspondiente, pasando el parámetro del indentificador del objeto que recupera desde la url (ej : /mononglet.php?id=1).
Ejemplo :
$id=$_GET["id"];
$product = new Product($db) ;
$result = $product->fetch($id) ; //Tester $result pour vérifier que l'accès à la base s'est bien passé
3. Recuperar la lista de pestañas correspondientes a la entidad seleccionada
Usar la función XXX_prepare_head($obj), donde XXX es le nombre de la entidad, para crear una tabla que contiene las definiciones de las pestañas a mostrar. El parámetro a pasar es el objeto del que desea mostrar las pestañas.
La tabla devuelta se compone de la siguiente manera :
$head // Tableau des onglets
$head[$h] // Élément décrivant un onglet. Il y aura autant de $h que d'onglets à afficher
$head[$h][0] // Url de la page affichée quand on clique sur l'onglet
$head[$h][1] // Titre de l'ongLet
$head[$h][2] // Code de l'onglet, à utiliser pour choisir quel onglet sera 'actif' (voir paragraphe suivant)
Ejemplo :
$head = product_prepare_head($product, $user) ; //le paramètre $user n'est pas présent sur certaines fonctions
4. Mostrar las pestañas en su pestaña
Use la función dol_fiche_head() que muestra las pestañas contenidas en la tabla $head devuelta por XX_prepare_head().
dol_fiche_head($links, $active='0', $title='', $notab=0, $picto='')
$links // Tableau des onglets, appelé $head plus haut.
$active // Onglet actif (mettre le nom de l'onglet défini dans votre fichier de module, ou un nom contenu dans $head[$h][2]). Cet onglet sera mis en surbrillance
$title // ?
$notab // Mettre ce paramètre à 1 permet de ne pas afficher de zone bleue en dessous des onglets.
$picto // Nom de l'image à utiliser au début de la barre des onglet. Les choix suivant sont possibles :
// product
// service
// company
Esta función muestra las pestañas deseadas y abre un elemento < div class="" > que corresponde a la zona azul bajo las pestañas (si el parámetro $notab = 0). Para cerrar la zona azul, simplemente cierre el elemento < /div > en el código PHP.
Nota: Para más detalles, consulte la documentación Doxygen o directamente el código de Dolibarr.
Crear sus páginas pantalla PHP (opcional)
Cuándo: Si su módulo consiste en añadir funcionalidades que necesitan nuevas pantallas.
Crear una página pantalla PHP
Debe crear a continuación pantallas PHP que se basen en los datos de sus tablas utilizando los esqueletos como ejemplo del directorio modulebuilder. (Para el desarrollo de un script en línea de comandos, ver Desarrollo de scripts).
Para crear una nueva página de usuario, cree un subdirectorio de htdocs (si es que no existe ya) propio en su módulo (En htdocs/mimodulo, por ejemplo), con el fin de ubicar en él las páginas que va a crear.
Copie allí el archivo myobject_page.php, que va a servir de punto de partida a su página. Modifique el archivo para que la ruta relativa de
// Load Dolibarr environment
$res=0;
// Try main.inc.php into web root known defined into CONTEXT_DOCUMENT_ROOT (not always defined)
if (! $res && ! empty($_SERVER["CONTEXT_DOCUMENT_ROOT"])) $res=@include($_SERVER["CONTEXT_DOCUMENT_ROOT"]."/main.inc.php");
// Try main.inc.php into web root detected using web root caluclated from SCRIPT_FILENAME
$tmp=empty($_SERVER['SCRIPT_FILENAME'])?'':$_SERVER['SCRIPT_FILENAME'];$tmp2=realpath(__FILE__); $i=strlen($tmp)-1; $j=strlen($tmp2)-1;
while($i > 0 && $j > 0 && isset($tmp[$i]) && isset($tmp2[$j]) && $tmp[$i]==$tmp2[$j]) { $i--; $j--; }
if (! $res && $i > 0 && file_exists(substr($tmp, 0, ($i+1))."/main.inc.php")) $res=@include(substr($tmp, 0, ($i+1))."/main.inc.php");
if (! $res && $i > 0 && file_exists(dirname(substr($tmp, 0, ($i+1)))."/main.inc.php")) $res=@include(dirname(substr($tmp, 0, ($i+1)))."/main.inc.php");
// Try main.inc.php using relative path
if (! $res && file_exists("../main.inc.php")) $res=@include("../main.inc.php");
if (! $res && file_exists("../../main.inc.php")) $res=@include("../../main.inc.php");
if (! $res && file_exists("../../../main.inc.php")) $res=@include("../../../main.inc.php");
if (! $res) die("Include of main fails");
sea la correcta, en función de la profundidad del directorio en el que se encuentra el archivo (quitando o añadiendo "../"). Es en el "main" donde se carga el entorno técnico y las habilitaciones. Los objetos variables se posicionan ahora:
- $user – El objeto que contiene las características del usuario y sus derechos.
- $conf – El objeto que contiene la configuración de Dolibarr.
- $db – El objeto que contiene el gestor de conexión abierto a la base de datos.
- $langs – El objeto que contiene el idioma del usuario.
- La inclusión de una clase o una biblioteca dedicada al módulo, sin saber a dónde se llamará el archivo, se realiza mediante una función de Dolibarr (no directamente mediante include_once):
Ejemplo :
dol_include_once('/mimodulo/class/miclass.class.php', 'MiClass');
- Las clases de llamadas Dolibarr utilice la siguiente sintaxis:
Ejemplo :
require_once DOL_DOCUMENT_ROOT.'/core/class/doli.class.php';
Acceso a la base de datos
Si necesita realizar modificaciones en su tabla de la base de datos, utilice la clase generada más arriba.
Si de todos modos quiere acceder a las tablas sin objeto PHP dedicado, esto es posible (por ejemplo para recuperar una lista de registros). En ese caso, piense en seguir estos ejemplos.
Para un insert, update o delete:
$db->begin(); // Debut transaction
$db->query("Ma requete insert, update ou delete");
$db->commit(); // Valide
o $db->rollback() // Annule
Para una lectura:
$resql=$db->query("Ma requete select");
if ($resql)
{
$num = $db->num_rows($resql);
$i = 0;
if ($num)
{
while ($i < $num)
{
$obj = $db->fetch_object($resql);
if ($obj)
{
// You can use here results
print $obj->field1;
print $obj->field2;
}
$i++;
}
}
}
Definición de estilos
Para que el aspecto de la página guarde coherencia con el tema Dolibarr, es necesario utilizar los estilos CSS de Dolibarr.
Por ejemplo:
- class="liste_titre"1 en las etiquetas tr y td para una línea de título de tabla.
- class=”pair” o class=”impair” en las etiquetas tr y td de las líneas de datos de la tabla.
- class=”flat” en todos los campos en los que se teclea (input, select, textarea...)
- class=”button” en los objetos de tipo input type=”submit”.
Utilizar el selector de fechas de Dolibarr
Si quiere, puede beneficiarse del selector de fechas en las pantallas Dolibarr. Para ello, utilice la siguiente línea:
$form=new Form($db);
$form->select_date('','mykey',0,0,0,"myform");
La cadena "mikey" identifica el campo fecha. Hace falta introducir un valor diferente en caso de que haya varios campos. La cadena "myform" es el nombre del campo "FORM" (en el formulario, name="myform" de la página html). La visualización de un selector de fecha debe por tanto estar integrada en un formulario html.
Para recuperar el valor, a la herencia de POST, el comando es:
$mydate = dol_mktime(12, 0 , 0, $_POST['mykeymonth'], $_POST['mykeyday'], $_POST['mykeyyear']);
print strftime('%A %d %B %Y', $mydate);
Definir su página de configuración (opcional)
Cuándo: Si su módulo ofrece varias opciones parametrizables.
Crear su página de edición de configuración
Si su módulo ofrece varias opciones parametrizables, es necesario crear una página PHP para editar las opciones (que serán guardadas en la tabla llx_const). Cree una página PHP llamada mimodulo_setuppage.php, que registre las opciones posibles y las ponga al día. Es necesario tomar como ejemplo una página de /admin que le muestre el método para leer o guardar en la base de datos su opción. Coloque esta página de configuración también en el directorio /admin. A continuación, en el descriptor del módulo, modifique la variable para indicar el nombre de esta página PHP (no es necesario modificar la ruta, ya que la página estará forzosamente en el directorio /admin).
$this->config_page_url = array("monmodule_setuppage.php");
Probar su página
Vaya a la página Configuración > módulo. Debería aparecer un icono que permite acceder a la página de configuración, y debería poder modificar estas opciones y verlas en la base de datos.
Definir sus entradas de menú (opcional)
Cuándo: Si ha creado páginas PHP, es necesario que estas pantallas sean accesibles desde el menú Dolibarr.
Definir sus entradas de menú
Para ello, hace falta definir en el archivo descriptor de menú de tabla this->menu, que declara los menús. Esta tabla contiene todas las entradas que aparecerán en los menús una vez que el módulo sea activado. Los archivos de descriptor de módulo contienen un ejemplo de cómo se declara el menú superior, así como las entradas correspondientes en el menú de la derecha
He aquí un ejemplo de declaración de entradas de menú en el fichero descriptor:
// Main menu entries
$this->menu = array(); // List of menus to add
$r=0;
// Add here entries to declare new menus
// Example to declare the Top Menu entry:
$this->menu[$r]=array( 'fk_menu'=>0, // Put 0 if this is a top menu
'type'=>'top', // This is a Top menu entry
'titre'=>'MyModule top menu',
'mainmenu'=>'mymodule',
'leftmenu'=>'mymodule',
'url'=>'/mymodule/pagetop.php',
'langs'=>'mylangfile', // Lang file to use (without .lang) by module. File must be in langs/code_CODE/ directory.
'position'=>100,
'enabled'=>'1', // Define condition to show or hide menu entry. Use '$conf->mymodule->enabled' if entry must be visible if module is enabled.
'perms'=>'1', // Use 'perms'=>'$user->rights->mymodule->level1->level2' if you want your menu with a permission rules
'target'=>'',
'user'=>2); // 0=Menu for internal users, 1=external users, 2=both
$r++;
// Example to declare a Left Menu entry:
$this->menu[$r]=array( 'fk_menu'=>'fk_mainmenu=xxx', // Use 'fk_mainmenu=xxx' or 'fk_mainmenu=xxx,fk_leftmenu=yyy' where xxx is mainmenucode and yyy is a leftmenucode of parent menu
'type'=>'left', // This is a Left menu entry
'titre'=>'MyModule left menu 1',
'mainmenu'=>'xxx',
'leftmenu'=>'yyy',
'url'=>'/mymodule/pagelevel1.php',
'langs'=>'mylangfile', // Lang file to use (without .lang) by module. File must be in langs/code_CODE/ directory.
'position'=>100,
'enabled'=>'1', // Define condition to show or hide menu entry. Use '$conf->mymodule->enabled' if entry must be visible if module is enabled.
'perms'=>'1', // Use 'perms'=>'$user->rights->mymodule->level1->level2' if you want your menu with a permission rules
'target'=>'',
'user'=>2); // 0=Menu for internal users,1=external users, 2=both
$r++;
Para condicionar el acceso al menú segun los permisos, modificar la propiedad perms de la tabla. Ver el capítulo sobre permisos, un poco más abajo, para saber como realizar los permisos.
Probar sus entradas de menú
Desactive y reactive su módulo bajo Dolibarr. Las entradas del menú deberían aparecer después de hacerlo (si la condición 'enabled' está activada).
Definir sus propios permisos (opcional)
Cuándo: Si quiere añadir nuevos permisos.
La definición de permisos que gestionará su módulo se hace en el archivo descriptor creado en la primera fase. Modifique la línea $this->rights_class = 'facture' para que diga:
$this->rights_class = 'mimodulo';
A continuación, rellene la tabla $this->rights con tantas entradas como permisos diferentes vaya a definir:
$this->rights[$r][0] = 10001;
$this->rights[$r][1] = 'Texto por defecto de mi permiso';
$this->rights[$r][3] = 1;
$this->rights[$r][4] = 'accion';
$this->rights[$r][5] = 'subaccion';
$r++;
En $this->rights[$r][0], introduzca un id de permiso que no haya sido ocupado ya (para saber qué id están siendo ya utilizadas, ver el menú Información del Sistema en una instalación de Dolibarr que esté funcionando. En $this->rights[$r][3], introduzca 1 si este permiso se atribuye por defecto a los usuarios según son creados. En $this->rights[$r][1] introduzca un texto por defecto -que será mostrado si no se encuentra traducción para su permiso en el archivo admin.lang). En $this->rights[$r][4] y $this->rights[$r][5], introduzca una cadena de acción y subacción sin espacios. Después puede probar si un usuario tiene los permisos bien, introduciendo la siguiente secuencia en el código PHP:
if ($user->rights->mimodulo->accion->subaccion) ...
Definir sus propios paneles (opcional)
Cuándo: Si su módulo tiene uno o varios paneles.
Defina sus paneles
Para ello, modifique las tablas $this->boxes del archivo descriptor de módulo. Es suficiente con añadir 2 líneas por cada archivo de panel que se encuentre en el directorio htdocs/mimodulo/core/boxes.
Ejemplo:
$this->boxes[0]['file']='mabox0.php@mimodulo'
$this->boxes[0]['note']='Mi panel 0'
...
$this->boxes[n]['file']='maboxn.php@mimodulo'
$this->boxes[n]['note']='Mi panel n'
A continuación cree los archivos htdocs/mimodulo/core/boxes/mabox0.php, htdocs/mimodulo/core/boxes/mabox1.php... tomando como ejemplo los paneles existentes (en el directorio htdocs/core/boxes)
Pruebe sus paneles en Dolibarr
Vaya al menú Inico – Configuración – Paneles. Sus paneles deben aparecer en la lista de paneles activables. Actívelos, vaya a la página de bienvenida y verifique que se muestran correctamente.
Definir sus propias exportaciones (opcional)
Cuándo: Si su módulo incorpora exportaciones predefinidas de datos (tanto para sus propias tablas o para otras tablas existentes de otros módulos de Dolibarr)
Definir la exportación
Para ello, descomente y modifique las tablas $this->export_xxx de su archivo descriptor de módulo.
Probar la exportación
Vaya al menú "Herramientas > Exportar" de Dolibarr. Su exportación debería aparecer en la lista de exportaciones predefinidas disponibles (si su módulo ha sido activado correctamente). Deberían aparecer, para que pudiera elegirlos, los campos que definió en la fase anterior en las tablas correspondientes. Seleccione algunos campos y pruebe a generar un archivo de exportación.
Definir sus estilos CSS (opcional)
Cuándo: Si en sus pantallas PHP utiliza clases de estilos distintas a las de los temas de Dolibarr (no recomendado).
Esta funcionalidad todavía no es operativa en la versión 2.4., a pesar de estar ya descrita.
Crear y declarar su hoja de estilos
Crear un archivo de estilos llamada mimodulo.css o mimodule.css.php y guardarla en el directorio mimodulo dentro de htdocs. Solo puede haber un archivo css propio a cada módulo. Recordamos que es mejor usar los estilos ya existentes en Dolibarr (el archivo css usado por Dolibarr es el archivo themes/nomtheme/nombretema.css.php.
Una vez su hoja de estilos esté disponible, declárela en su archivo descriptor de módulo modificando la propiedad $this->module_parts. El valor a indicar debe ser la ruta URL relativa de su archivo css. Por ejemplo
$this->module_parts = array('css' => array('/mimodulo/css/mimodulo.css.php'));
Probar su hoja de estilos
Desactivar y reactivar su módulo.
Ir la página de inicio de Dolibarr. Ver el código de la página HTML.
Debería ver en el encabezado HTML, una línea de declaración de su hoja de estilos.
Definir sus funciones Javascript (opcional)
Cuando: Si en sus pantallas en PHP utiliza funciones de Javascript no disponibles en estandard (archivo lib_head.js)
Si en sus pantallas en PHP utiliza funciones javascript, es necesario asegurarse de que las funciones declaradas en un archivo javascript htdocs/mimodulo/js/monmodule.js sea cargado en la cabecera del head html.
Para pedir a Dolibarr que gestione en la generación de la sección header la inclusión de uno de sus archivos javascript, es necesario proporcionar como parámetro a la función llxHeader(), al inicio de su página, la URL hacia el js a incluir.
Ejemplo para la página /htdocs/mimodulo/mapage.php :
require('../main.inc.php');
$morejs=array("/mimomulo/js/monmodule.js");
llxHeader('','Titulo','','','','',$morejs,'',0,0);
Ejecutar código sobre un evento Dolibarr (opcional)
Cuándo: Si quiere que se ejecuten acciones particulares al activar ciertas acciones estandar de Dolibarr (por ejemplo, si deseáramos actualizar una tabla de mi módulo cada vez que se crea una factura en Dolibarr), hará falta crear un archivo disparador (triggers).
Véase también Interfaces Dolibarr hacia el exterior e Interfaces del Exterior hacia Dolibarr
Insertar su código usando los hooks de Dolibarr (opcional)
Cuándo: Cuando desee cambiar o añadir otro tipo de código en un evento de negociado (véase lel capítulo anterior para esto).
Véase la página El sistema Hooks.
Añadir un módulo de numeración (opcional)
Cuándo: Si quiere añadir una regla de numeración no cubierta por los módulos por defecto.
Véase la página Crear un módulo de numeración.
Añadir un nuevo módulo de documento (opcional)
Cuándo: Si quiere añadir un nuevo modelo de documento.
La documentación relativa a la generación de documentos desde los modelos se encuentra disponible en la página Crear un modelo de documento PDF o Crear un modelo de documento ODT.
Añadir un tema (opcional)
Cuándo: Si quiere un interface con colores personalizados.
Véase la página Temas.
Algunas reglas de código
Las reglas de código a seguir se definen en la Documentación para desarrolladores, concretamente en la sección "Lenguaje" del capítulo de "Información General".
Crear un paquete para liberar e instalar su módulo
Este proceso debe ser usado para fabricar un paquete con el fin de enviarlo a la tienda oficial http://www.dolistore.com.
También puede usarlo para distribuir fácilmente su módulo vía su propio método de distribución.
- Vaya al directorio /build y copie el archivo makepack-dolibarrmodules.conf como makepack-mimodulo.conf. Cuidado: este directorio puede no ser suministrado en los paquetes de versión estables. Si es el caso, puede bajarte la última snapshot en la sección de Downloads del sitio de Dolibarr con el nombre “Development Version” (tome en este caso todos los directorios que sean autónomos e independientes de la versión).
Teclee en este archivo la lista de nombres de los nuevos archivos que ha creado para su módulo (descriptor de módulo, nuevos ficheros sql de tablas, páginas php, imágenes, etc...)
- Lance el script vía Perl (necesita la versión 5.0. o superiores de Perl)
perl makepack-dolibarrmodule.pl
El script le pide el nombre de su módulo, su versión mayor y menor. Se va a crear un fichero mimodulo.zip, que incluirá su módulo listo para ser liberado.
- La persona que reciba su módulo deberá ubicar el archivo en el directorio raíz de Dolibarr y ejecutar el comando:
tar -xvf monmodule.zip
- Si desea que su módulo sea aprovechado por todos, puede enviarlo (el fichero zip) al sitio web de Dolibarr, en la sección de descargas: DoliStore.com (debe de haber creado una cuenta y estar logeado para que aparezca el link "Submit a product").
- Si su módulo está correctamente realizado, será rápidamente validado.
- Si la calidad es suficiente, la licencia lo permite y la funcionalidad del módulo es de interés general, el código podrá añadirse al código fuente de Dolibarr (salvo que no lo desee).