Liste des événements dans le noyau¶
Pour plus d’informations sur le fonctionnement des événements, visitez Événements et Hooks plugin.
Contenu
Note
Certains événements sont marqués par (séquence) cela signifie que ces événements ont également un événement :before
et :after
. Voyez également Séquence d’événement
Événements système¶
- plugins_load, system (séquence)
Déclenché avant que les plugins ne soient chargés. Rarement utilisé. init, system est utilisé à la place. Peut être utilisé pour charger des bibliothèques supplémentaires.
- plugins_boot, system (séquence)
Déclenché juste après le chargement des plugins. Rarement utilisé. init, system est utilisé à la place.
- init, system (séquence)
Les plugins ont tendance à utiliser cet événement pour l’initialisation (extension des vues, enregistrement des rappels, etc.)
- ready, system (séquence)
Déclenché après l’événement
init, system
. Tous les plugins sont entièrement chargés et le moteur est prêt à servir les pages.- shutdown, system
Déclenché après l’envoi de la page à l’utilisateur. Des opérations coûteuses pourraient être faites ici sans que cela fasse attendre l’utilisateur.
Note
Selon la configuration de votre serveur, la sortie PHP peut ne pas être affichée avant la fin du processus. Cela signifie que tous les processus longs retarderont toujours le chargement de la page.
Note
Cet événement est préféré à l’utilisation de register_shutdown_function
car vous n’avez peut-être pas accès à tous les services Elgg (par ex. la base de données) dans la fonction d’arrêt, alors que vous l’aurez dans l’événement.
Note
La session Elgg est déjà terminée avant cet événement. La manipulation de la session n’est plus possible.
- regenerate_site_secret:before, system
Renvoyez false pour annuler la régénération du secret du site. Vous devez également fournir un message à l’utilisateur.
- regenerate_site_secret:after, system
Déclenché après que le secret du site a été régénéré.
- log, systemlog
Appelé pour tous les événements déclenchés par le plugin
system_log
. Utilisé en interne parElgg\SystemLog\Logger::log()
pour remplir la tablesystem_log
.- upgrade, system
Déclenché une fois la mise à niveau du système terminée. Tous les scripts de mise à niveau sont exécutés, mais les caches ne sont pas effacés.
- upgrade:execute, system (séquence)
Déclenché lors de l’exécution d’un
ElggUpgrade
. L’objet$object
de l’événement est leElggUpgrade
.- activate, plugin
Renvoyez false pour empêcher l’activation du plugin.
- deactivate, plugin
Renvoyez false pour éviter la désactivation du plugin.
- init:cookie, <name>
Renvoyez false pour remplacer la définition d’un cookie.
- cache:invalidate, system (séquence)
Invalide les caches internes et externes.
- cache:clear, system (séquence)
Efface les caches internes et externes, par défaut, y compris system_cache, simplecache et memcache. Il est possible de l’utiliser pour réinitialiser d’autres caches comme APC, OPCache ou WinCache.
- cache:purge, system (séquence)
Purge les caches internes et externes. Il s’agit de supprimer le contenu ancien/obsolète des caches.
- send:before, http_response
Déclenché avant l’envoi d’une réponse HTTP. Les gestionnaires recevront une instance de la réponse SymfonyComponentHttpFoundationResponse qui doit être envoyée au demandeur. Les gestionnaires peuvent mettre fin à l’événement et empêcher l’envoi de la réponse en renvoyant false.
- send:after, http_response
Déclenché après l’envoi d’une réponse HTTP. Les gestionnaires recevront une instance de la réponse SymfonyComponentHttpFoundationResponse qui a été envoyée au demandeur.
- reload:after, translations
Déclenché après que les traductions ont été (re)chargées.
Événements utilisateur¶
- login:before, user
Déclenché lors de la connexion. Renvoyer false empêche l’utilisateur de se connecter
- login:after, user
Déclenché après que l’utilisateur se soit identifié.
- login:first, user
Déclenché après une connexion réussie. Uniquement s’il n’y a pas de connexion précédente.
- logout:before, user
Déclenché pendant la déconnexion. Renvoyer false empêche l’utilisateur de se déconnecter.
- logout:after, user
Déclenché après que l’utilisateur se soit déconnecté.
- validate, user
Lorsqu’un utilisateur s’inscrit, le compte de l’utilisateur est désactivé. Cet événement est déclenché pour permettre à un plugin de déterminer comment l’utilisateur doit être validé (par exemple, par le biais d’un e-mail avec un lien de validation).
- validate:after, user
Déclenché lorsque le compte utilisateur a été validé.
- invalidate:after, user
Déclenché lorsque la validation du compte de l’utilisateur a été révoquée.
- profileupdate, user
L’utilisateur a modifié son profil
- profileiconupdate, user
L’utilisateur a modifié son icône de profil
- ban, user
Déclenché avant qu’un utilisateur ne soit banni. Retournez false pour l’éviter.
- unban, user
Déclenché avant qu’un utilisateur ne soit réintégré. Retournez false pour l’éviter.
- make_admin, user
Déclenché avant qu’un utilisateur ne soit promu administrateur. Retournez false pour l’éviter.
- remove_admin, user
Déclenché avant que le rôle d’administrateur ne soit retiré à un utilisateur. Retournez false pour l’éviter.
Événements des relations¶
- create, relationship
Déclenché après la création d’une relation. Renvoyez false pour supprimer la relation qui vient d’être créée.
- delete, relationship
Déclenché avant la suppression d’une relation. Renvoyez false pour éviter qu’elle soit supprimée.
- join, group
Déclenché après que l’utilisateur
$params['user']
a rejoint le groupe$params['group']
.- leave, group
Déclenché avant que l’utilisateur
$params['user']
n’ait quitté le groupe$params['group']
.
Événements des entités¶
- create, <entity type>
Déclenché pour les entités user, group, object et site après leur création. Renvoyez false pour supprimer l’entité.
- update, <entity type>
Déclenché avant une mise à jour pour les entités user, group, object et site. Renvoyez false pour empêcher la mise à jour. La méthode d’entité
getOriginalAttributes()
peut être utilisée pour identifier les attributs qui ont changé depuis la dernière fois que l’entité a été enregistrée.- update:after, <entity type>
Déclenché après une mise à jour pour les entités user, group, object et site. La méthode d’entité
getOriginalAttributes()
peut être utilisée pour identifier les attributs qui ont changé depuis la dernière fois que l’entité a été enregistrée.- delete:before, <entity type>
Déclenché avant la suppression d’une entité. Retournez false pour éviter la suppression.
- delete, <entity type>
Déclenché avant la suppression d’une entité.
- delete:after, <entity type>
Déclenché après la suppression d’une entité.
- disable, <entity type>
Déclenché avant qu’une entité soit désactivée. Retournez false pour éviter la désactivation.
- disable:after, <entity type>
Déclenché après qu’une entité a été désactivée.
- enable, <entity type>
Retournez false pour éviter l’activation.
- enable:after, <entity type>
Déclenché après qu’une entité a été activée.
Événements des métadonnées¶
- create, metadata
Appelé après qu’une métadonnée a été créée. Retournez false pour supprimer la métadonnée qui vient d’être créée.
- update, metadata
Appelé après qu’une métadonnée a été modifiée. Retournez false pour supprimer la métadonnée.
- delete, metadata
Appelé avant que métadonnée soit supprimée. Retournez false pour éviter la suppression.
- enable, metadata
Appelé lors de l’activation de la métadonnée. Retournez false pour éviter l’activation.
- disable, metadata
Appelé lors de la désactivation d’une métadonnée. Retournez false pour éviter la désactivation.
Événements des annotations¶
- annotate, <entity type>
Appelé avant que l’annotation soit créée. Retournez false pour éviter l’annotation de cette entité.
- create, annotation
Appelé après que l’annotation a été créée. Retournez false pour supprimer l’annotation.
- update, annotation
Appelé après qu’une annotation a été modifiée. Retournez false pour supprimer l’annotation.
- delete, annotation
Appelé avant que l’annotation soit supprimée. Retournez false pour éviter la suppression.
- enable, annotation
Appelé lors de l’activation d’annotations. Retournez false pour éviter l’activation.
- disable, annotations
Appelé lors de la désactivation d’annotations. Retournez false pour éviter la désactivation.
Événements de la rivière¶
- create:before, river
Appelé avant que l’élément river ne soit enregistré dans la base de données. Renvoie
false
pour empêcher la création de l’élément.- create:after, river
Appelé après qu’un élément de la rivière a été créé.
- delete:before, river
Déclenché avant qu’un élément de la rivière soit supprimé. Renvoyer false annule la suppression.
- delete:after, river
Déclenché après qu’un élément de la rivière a été supprimé.
Événements des fichiers¶
- upload:after, file
Appelé après qu’un fichier téléchargé a été écrit dans le répertoire de fichiers. Reçoit une instance du
ElggFile
dans lequel le fichier téléchargé a été écrit. LeElggFile
peut ou non être une entité avec un GUID.
Notes¶
En raison de bogues dans le noyau de Elgg, certains événements peuvent être lancés plus d’une fois pour la même action. Par exemple, update, object
est lancé deux fois.