El sistema Hooks: Difference between revisions
No edit summary |
|||
| Line 37: | Line 37: | ||
* @return void | * @return void | ||
*/ | */ | ||
function doActions($parameters, $object, $action) | function doActions($parameters, &$object, &$action, $hookmanager) | ||
{ | { | ||
print_r($parameters); | print_r($parameters); | ||
| Line 47: | Line 47: | ||
// do something only for the context 'somecontext' | // do something only for the context 'somecontext' | ||
} | } | ||
$this->results=array('myreturn'=>$myvalue) | |||
$this->resprints='A text to show'; | |||
return 0; | |||
} | } | ||
} | } | ||
Revision as of 18:51, 22 January 2013
Introducción
Hooks es una funcionalidad de desarrollo (con Dolibarr 3.2) que permite a los desarrolladores agregar código personalizado en el código del núcleo de Dolibarr sin necesidad de parchear Dolibarr. Al contrario que los triggers (otra funcionalidad para interactuar con el código de Dolibarr) que están vinculados a una acción de negociado, los hooks pueden producirse en cualquier lugar y en cualquier momento, son un punto de entrada en el programa.
- Hooks trabaja por contexto (es decir por módulo, ej: "productcard" para productos, "invoicecard" para facturas, etc.). Es fácil de encontrar, solo hay que burcar por "initHooks("
- Hooks son funciones que pueden ser sobrecargadas por las suyas propias. Usted es el que decide si su código se añade al código estandar de Dolibarr o si reemplaza al código de Dolibarr. Puede encontrar funciones sobrecargables buscando por "executeHooks("
Implementación
Para usar un hook (sobrecarga de una función), debe de haber definido un módulo antes (vea la wiki para ello), y entonces tiene que hacer 2 cosas:
1- Añadir su módulo a los hooks del contexto que desee. Esto significa que cuando este contexto (módulo) va a suceder, el módulo será llamado. Para ello edite su /htdocs/sumodulo/includes/modSuModulo.class.php y edite la variable $this->module_parts con algo como esto:
$this->module_parts = array(
'hooks' => array('hookcontext1','hookcontext2') // Set here all hooks context managed by module
);
IMPORTANTE: Tenga cuidado: No olvide DESACTIVAR y luego ACTIVAR el módulo en el panel de administración para aceptar los nuevos valores de las constantes, ya que estas constantes solo se añaden a la base de datos cuando se activa el módulo.
2- Sobrecargar un hook (una función) con la suya propia.
Cree un archivo /htdocs/sumodulo/class/actions_sumodulo.class.php y luego escriba algo como esto:
class ActionsYourModuleName
{
/** Overloading the doActions function : replacing the parent's function with the one below
* @param parameters meta datas of the hook (context, etc...)
* @param object the object you want to process (an invoice if you are in invoice module, a propale in propale's module, etc...)
* @param action current action (if set). Generally create or edit or null
* @return void
*/
function doActions($parameters, &$object, &$action, $hookmanager)
{
print_r($parameters);
echo "action: ".$action;
print_r($object);
if (in_array('somecontext',explode(':',$parameters['context'])))
{
// do something only for the context 'somecontext'
}
$this->results=array('myreturn'=>$myvalue)
$this->resprints='A text to show';
return 0;
}
}
donde
- $parameters es un array de meta-datos acerca de los datos contenidos en el hook (ej: el contexto, siempre accesible mediante $parameters['context']).
- $object es el objeto con el que va a trabajar. Ej: el producto si se encuentra en el contexto productcard.
- $action es la acción si se ha enviado alguna (generalmente "create", "edit" o "view").
Listado de Hooks disponibles
¿Cómo encontrar hooks disponibles? Realice una búsqueda de "executeHooks(" y le será fácil encontrar las llamadas a los métodos Hook.