Wikipédia:LiveRC/Documentation/Hooks/BeforeInitActivationProcess/fr
"BeforeInitActivationProcess"
est le nom d'un hook inséré dans le code de LiveRC permettant à des fonctions annexes définies par une extension d'être exécutées juste avant la définition du process de chargement de LiveRC.
Utilisation
modifierCe hook est exécuté juste avant la définition du processus de chargement de LiveRC (processus défini au sein de la variable globale LiveRC_Config["LaunchProcess"]
). Il permet, avant la définition des fonctions inclues dans cette variable, de forcer l'activation de certaines d'entre elles, notamment lorsque leur exécution est nécessaire en dehors de la page de lancement de LiveRC. Il peut être utilisé par exemple pour forcer le chargement des infos sur l'utilisateur ou les traductions de l'interface.
La variable LiveRC_Config["LaunchProcess"]
est un tableau dont chaque élément est composé :
- d'un item
functions
, qui peut être soit une fonction, soit une Array composée de fonctions.- La fonction ou la dernière des fonctions doit se terminer par l'instruction
LiveRC_LaunchProcessNextStep()
qui permet de lancer l'étape suivante du processus. Elle est nécessaire même si il n'y a pas d'autres étapes prévues dans le processus : une extension est toujours susceptible d'en ajouter par la suite.
- La fonction ou la dernière des fonctions doit se terminer par l'instruction
- d'un item
condition
, qui définit une condition à l'exécution de la ou des fonctions définies dans cette ligne.- Cet item est facultatif
Le hook BeforeInitActivationProcess
permet de modifier la condition via la valeur d'un item de l'objet LiveRC_Config["LaunchProcessForce"]
, valeur qui est vérifiée par la fonction LiveRC_ForceProcess()
au moment de définir la valeur de la condition (true ou false). Au sein d'une fonction appelée par ce hook, il est donc possible de définir un item de l'objet LiveRC_Config["LaunchProcessForce"]
à true pour forcer l'exécution de la ou les fonctions correspondante(s).
Voir aussi le code source de LiveRC : Wikipédia:LiveRC/Miroir#Initialisation
Exemples
modifierLes extensions suivantes utilisent ce hook :