Liste des événements dans le cœur

Événements système

boot, system

Premier événement déclenché. Déclenché avant que les plugins aient été chargés.

plugins_boot, system

Déclenché juste après le chargement des plugins. Rarement utilisé. init, system est utilisé à la place.

init, system

Les plugins ont tendance à utiliser cet événement pour l’initialisation (extension des vues, enregistrement des rappels, etc.)

ready, system

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.

pagesetup, system (déprécié en 2.3)

Appelé juste avant la production du premier contenu. Est déclenché par elgg_view(). Utilisez plutôt les hooks de menu ou de coquille de page.

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.

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. Utilisé en interne par system_log_default_logger() 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, upgrade

Un script unique de mise à niveau vient de terminer son exécution. Un objet stdClass a été passé aux gestionnaires avec les propriétés

• from (de) - La version de Elgg partir de laquelle est faite la mise à niveau.

• to (à) - La version vers laquelle vient d’être faite la mise à niveau.

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:flush, system

Réinitialisez les caches internes et externes, y compris par défaut system_cache, simplecache et memcache. On pourrait l’utiliser pour en réinitialiser d’autres comme APC, OPCache ou WinCache.

send:before, http_response

Déclenché avant l’envoi d’une réponse HTTP. Les gestionnaires recevront une instance de \Symfony\Component\HttpFoundation\Response 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 \Symfony\Component\HttpFoundation\Response qui a été envoyée au demandeur.

É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é.

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).

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.

Note

Cet événement a été cassé dans Elgg 1.9 - 1.12.3, renvoyer false ne supprimait pas la relation. Ceci fonctionne à partir de 1.12.4

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 la 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, <entity type>

Déclenché avant la suppression d’une entité. Retournez false pour éviter la suppression.

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 matadonné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 de la 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 ait é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

created, river

Appelé après qu’un élément de la rivière a été créé.

Note

Utilisez le hook plugin creating, river pour annuler la création (ou modifier les options).

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 des bogues dans le noyau de Elgg, certains événements peuvent être lancés plus d’une fois sur la même action. Par exemple, update, object est lancé deux fois.