Liste des événements dans le noyau

Pour plus d’informations sur le fonctionnement des événements, visitez Événements et Hooks plugin.

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 par Elgg\SystemLog\Logger::log() pour remplir la table system_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 le ElggUpgrade.

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. Le ElggFile 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.