E-mail et notifications¶

Evey prévient chaque profil quand de nouveaux films, séries, saisons, épisodes ou albums arrivent. Il prévient aussi :

la personne qui a fait une demande, quand elle reçoit une réponse ;
les administrateurs, des nouvelles demandes, des sauvegardes qui ont échoué, des erreurs de plugins et d'un cache de sous-titres plein.

Les notifications apparaissent dans les applications sans rien régler. Par e-mail, une fois que vous avez réglé un serveur de messagerie (plus bas).

Où apparaissent les notifications¶

Dans chaque application : la cloche, avec le nombre de notifications non lues. Toujours active. Une notification est gardée 30 jours. Chacun ne voit que les titres des bibliothèques que son compte peut ouvrir.
Dans le navigateur (push) : sur le web, chaque profil active Notifications push dans Paramètres → Notifications, une fois par navigateur. Les navigateurs ne le permettent que sur une adresse en https:// (ou localhost). Ailleurs, le réglage affiche Les notifications push exigent une adresse HTTPS : ouvrez ce serveur en HTTPS pour les activer. Les applications Android et TV ne reçoivent pas de notifications push.
Par e-mail : une fois l'e-mail réglé, chaque notification est aussi envoyée à l'adresse e-mail du compte, dans la langue du profil, avec un lien vers le serveur. Un compte avec plusieurs profils reçoit un seul e-mail par événement. Personne ne peut désactiver les e-mails pour lui-même.

Clés de push

Le serveur crée les clés dont le push du navigateur a besoin à son premier démarrage. Pour fournir les vôtres, voir E-mail et notifications.

Régler l'e-mail¶

Evey envoie les e-mails par un serveur de messagerie où vous avez déjà un compte : votre fournisseur d'e-mail, ou un service d'envoi. Les pages d'aide de votre fournisseur donnent les valeurs ci-dessous.

Allez dans Administration → Configuration du serveur → E-mail / SMTP.

Remplissez les champs :

Champ	Ce qu'il faut saisir
Hôte SMTP, Port	Le serveur de messagerie et son port. Les paires habituelles sont `587` avec `starttls`, ou `465` avec `ssl`.
Nom d'utilisateur, Mot de passe	Le compte avec lequel Evey se connecte.
Adresse d'expédition	L'adresse d'expéditeur affichée sur chaque message.
Mode TLS	`starttls` ou `ssl`, selon le port (voir plus haut). `none` envoie sans chiffrement.

Appuyez sur Enregistrer les paramètres SMTP. Cela s'applique tout de suite, sans redémarrage.
Appuyez sur Envoyer un e-mail de test. Evey envoie un court message à l'adresse de votre propre compte. En cas d'échec, il affiche la réponse du serveur de messagerie.

L'erreur la plus courante est un mode TLS qui ne correspond pas au port.

L'e-mail sert aux notifications et à la réinitialisation des mots de passe. Les invitations sont des liens que vous envoyez vous-même.

Régler l'e-mail plutôt dans l'environnement

Les variables EVEY_SMTP_*, sous environment: dans le fichier compose, ne servent que tant que la carte n'a pas d'hôte :

docker-compose.yml

services:
  evey:
    environment:
      EVEY_SMTP_HOST: smtp.example.com
      EVEY_SMTP_PORT: "587"
      EVEY_SMTP_USERNAME: notifications@example.com
      EVEY_SMTP_PASSWORD: your-smtp-password
      EVEY_SMTP_FROM: noreply@example.com
      EVEY_SMTP_TLS: starttls

Dès qu'un hôte est enregistré dans la carte, tous les champs viennent de la carte et les variables sont ignorées. Ainsi, le serveur n'envoie jamais le mot de passe des variables à un serveur de messagerie saisi dans le panneau. Videz l'hôte pour revenir aux variables.

Choisir ce qu'un profil reçoit¶

Dans Paramètres → Notifications, chaque profil choisit un niveau pour Films, Séries et Musique :

Niveau	Nouveaux titres dont vous êtes prévenu
Toutes	Tous. C'est le réglage par défaut.
Pertinentes	Seulement les titres qui ont un genre en commun avec ce que le profil regarde d'habitude.
Importantes uniquement	Pour l'instant, la même chose que Pertinentes.
Désactivé	Aucun.

Un genre compte comme « regardé d'habitude » quand il apparaît dans au moins 3 des 200 dernières lectures du profil. Un titre sans genre n'est jamais notifié aux niveaux Pertinentes et Importantes uniquement.

Quand plusieurs épisodes d'une même série arrivent en moins de 24 heures, vous recevez une seule notification qui les compte. Aucune n'est envoyée quand la série ou la saison vient d'être annoncée.

Permettre de réinitialiser son mot de passe¶

Réglez l'e-mail (plus haut).
Activez Récupération du mot de passe dans Administration → Configuration du serveur → Comptes et sécurité → Connexion et protection. Cela s'applique tout de suite.
La page de connexion affiche alors Mot de passe oublié ?. Ce lien envoie par e-mail un lien pour choisir un nouveau mot de passe.

Sans serveur de messagerie, le lien reste caché, même avec l'option activée.