hookscanner

Comprendere il sistema di hook di Dolibarr

Il sistema di hook di Dolibarr consente ai moduli di terze parti di intervenire nel comportamento nativo dell'applicazione senza modificarne il codice sorgente. Ogni volta che Dolibarr esegue $hookmanager->executeHooks('nomeHook', $parameters, $object), invita tutti i moduli registrati a rispondere tramite un metodo omonimo nel loro file actions_xxx.class.php. Questo è il meccanismo centrale di estensibilità di Dolibarr: creazione di fatture, visualizzazione della dashboard, validazione di moduli, invio di e-mail — tutto può essere intercettato e arricchito tramite un hook.

Il problema: con oltre 1.000 punti di estensione distribuiti in centinaia di file PHP, è praticamente impossibile sapere quali hook esistono, quali sono già implementati nei propri moduli e quali restano ancora da sfruttare.

Cosa fa HookScanner

HookScanner risolve questo problema eseguendo una scansione automatica dell'intera struttura di directory dell'installazione Dolibarr. Rileva ogni chiamata $hookmanager->executeHooks(...), estrae il nome dell'hook (1° parametro) e la variabile oggetto (3° parametro), e risale fino alla classe PHP corrispondente e al suo file .class.php. La scansione avviene in background tramite lotti AJAX, senza mai raggiungere il limite di timeout di PHP.

Dal tab Hook, ottenete una panoramica immediata di tutti i punti di estensione disponibili, filtrabili per nome, file sorgente o stato. Ogni hook mostra quanti file actions_*.class.php dei vostri moduli implementano già il metodo corrispondente. Espandendo una riga si accede a tutti i dettagli: chiamata completa, classe oggetto, file della classe e — per ciascun modulo — il metodo con il suo codice o un pulsante per iniettarlo automaticamente.

Dal tab File di azione, navigate tutti i file actions_*.class.php presenti sul server, con l'elenco dei loro metodi hook e un collegamento diretto all'hook corrispondente nel primo tab.

Disponibile in francese, inglese, tedesco, italiano e spagnolo.