Hooks

YunoHost comprend un mécanisme de hooks déclenchés lors de nombreuses opérations modifiant le système. Vous pouvez utiliser ce mécanisme afin d'étendre le comportement d'une commande YunoHost.

Le cas le plus évident est l'ajout d'un utilisateur. Si vous aviez un hook post_user_create, ce hook sera déclenché dès qu'un utilisateur sera ajouté.

Comment ajouter un hook personnalisé sur une instance spécifique

Nous imaginons ci-dessous que nous voulons lancer une commande après chaque création d'utilisateur pour ajouter l'utilisateur à l'utilisateur samba.

Vous devez créer un répertoire avec le nom des hooks dans /etc/yunohost/hooks.d/ :

mkdir -p /etc/yunohost/hooks.d/post_user_create

Créez ensuite un script bash à l'intérieur de ce répertoire, préfixé par 2 chiffres et un tiret :

nano /etc/yunohost/hooks.d/post_user_create/05-add-user-to-samba

Comment ajouter un hook dans un paquetage d'application

Si vous empaquetez une application, vous ne devez pas mettre vous-même le hook dans /etc/yunohost/hooks.d mais vous devez créer un répertoire hooks à la racine de votre paquet.

.
├─── conf
├─── hooks
├── scripts

Dans le dossier des hooks, créer un script bash appelé avec le type de hook que vous voulez créer par exemple post_create_user.

-> Liste des hooks et leurs variables

Vous avez découvert des erreurs ? Vous pensez pouvoir améliorer cette documentation ? Cliquez sur Éditer en haut de la page, puis sur l'icone crayon sur Github pour proposer vos changements.