Difference between revisions of "Système de Hooks"
(o) |
|||
| Line 60: | Line 60: | ||
Où | Où | ||
| − | * '''$parameters'''est un tableau (array) de meta-data regroupant les | + | * '''$parameters'''est un tableau (array) de meta-data regroupant les données du hook (son contexte accessible par $parameters->context) |
| − | * '''$object''' | + | * '''$object''' est l'objet sur lequel vous désuirez travailler (par exemple : product pour le contexte productcard) |
| − | * '''$action''' | + | * '''$action''' désigne l'action à exécuter (par exemple "create", "edit" or "view"). |
| − | + | = Liste des Hooks disponibles = | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | = | ||
{{ToComplete}} | {{ToComplete}} | ||
| − | * '''formObjectOptions''': | + | * '''formObjectOptions''': appelé chaque fois qu'un champ associé à l'objet principal est affiché ou modifié (formulaires de création, modification, affichage...) |
| − | + | Trouver les hooks disponibles ? | |
| − | + | Faites une recherche sur "'''executeHooks('''" et vous trouverez facilement les fonctions déjà implémentées | |
| − | = | + | = Voir aussi = |
* [[Triggers]] | * [[Triggers]] | ||
* [[Interfaces Dolibarr toward foreign systems]] | * [[Interfaces Dolibarr toward foreign systems]] | ||
* [[Interfaces from foreign systems toward Dolibarr]] | * [[Interfaces from foreign systems toward Dolibarr]] | ||
Revision as of 13:10, 12 December 2011
|
|
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".
Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten".
页面等待翻译。若要翻译本页，先创建一个帐户、登录并返回本页后单击“编辑”。Les Hooks permettent aux développeurs d'ajouter du code personnalisé aux pages standard de Dolibarr sans avoir à modifier les fichiers du coeur de Dolibarr. Contrairement aux triggers (autre manière d'interagir avec le code de Dolibarr) qui sont liés aux événements de Dolibarr, les Hooks peuvent s'exécuter n'importe ou et à n'importe quel moment. Ce sont des points d'entrée dans le programme.
- Les Hooks agissent selon le contexte (càd le module : par exemple "productcard" pour les produits, "invoicecard" pour les factures...). Pour trouver les Hooks existants faites une recherche pour "callHooks("
- Les Hooks sont des foncitons qui peuvent être surchargées. Vous décidez si votre code s'ajoute à celui de dolibarr ou s'il le remplace. Pour rechercehr le code qu'il est possible de surcharger faites une recherche pour "executeHooks("
Implementation
Pour utiliser un Hook (donc surcharger une fonction), vous devez d'abord avoir défini un module (voir le wiki sur la création d'un module). Ensuite vous devez suivre les étapes suivantes :
1. Pour ajouter votre module au contexte où me hook doit d'éxécuter Ce qui veut dire que lorsqu'on se trouve dans le contexte donné (module dolibarr), votre module sera appelé. Pour cela, éditer le descripteur de votre module (/htdocs/includes/modYourModuleName.class.php) et renseignez la variable $this->const comme par exemple (modifiez le code en gras selon votre module)
$this->const = array(
0=>array(''''MAIN_MODULE_YOURMODULENAME_HOOKS'''', 'chaine', ''''productcard:invoicecard:propalcard'''',
''''Hooks list for managing printing functions of the CustomFields module'''', 0, 'current', 1)
);
Rappel Note: format d'une déclaration de constante :
$key=>array($const_name,$type,$value,$description,$visible_on_admin_panel=0,$entity='current',$deleteonunactive=0),
$key2=>...
où $key being est un entier positif.
IMPORTANT: n'oubliez pas de désactiver puis de réactiver votre module pour que la modification soit prise en compte. Attention le dernier paramètre doit être 1 et no 0 (valeur par défaut) pour écraser une éventuelle valeur précédente.
2. Pour remplacer une fonction existante par la votre (surcharge)
Créez /htdocs/yourmodulename/class/actions_yourmodulename.class.php dans votre module avec un code comme celui-ci
class ActionsYourModuleName // extends CommonObject
{
/** 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)
{
print_r($parameters);
echo "action: ".$action;
print_r($object);
if ($parameters->context == 'somecontext')
{
// do something only for the context 'somecontext'
}
}
}
Où
- $parametersest un tableau (array) de meta-data regroupant les données du hook (son contexte accessible par $parameters->context)
- $object est l'objet sur lequel vous désuirez travailler (par exemple : product pour le contexte productcard)
- $action désigne l'action à exécuter (par exemple "create", "edit" or "view").
Liste des Hooks disponibles
|
|
- formObjectOptions: appelé chaque fois qu'un champ associé à l'objet principal est affiché ou modifié (formulaires de création, modification, affichage...)
Trouver les hooks disponibles ? Faites une recherche sur "executeHooks(" et vous trouverez facilement les fonctions déjà implémentées