Go to file
PaulCombal b27899aa73 auto 2019-03-01 16:03:41 +01:00
NotificationsBundle auto 2019-03-01 16:03:41 +01:00
.gitignore first 2019-03-01 12:18:06 +01:00
README.md auto 2019-03-01 16:02:12 +01:00
composer.json auto 2019-03-01 13:12:17 +01:00

README.md

Notifications bundle

Ajout de notifications pour les users (backend seulement)

Restrictions

Votre classe User doit absoluement être dans le namespace \App\Entity et s'appeler User, soit etre \App\Entity\User\.

Routes:

Pour installer les routes, ajouter ceci:

notifications:
    prefix: '/notifications'
    resource: '@NotificationsBundle/Resources/config/routes.yaml'

à votre config/routes.yaml

Il existe aussi le fichier routes_dev.yaml qui ajoute le endpoint à /add-dev qui permet d'ajouter une notification de test à l'utilisateur courant.

Pour créer des notifs, il faut utiliser le service. Effectivement on ne veut pas permettre aux clients de spammer les routes de notifications ou lire les notifs de toute le monde. Vous pouvez ajouter des routes dans votre application pour plus de flexibilité.

  • GET /get

Récupère toutes les notifications de l'utilisateur courant.

  • DELETE /delete/{id}

Supprime la notification à l'id indiqué si elle appartient à l'user courant.

  • POST /mark-seen/{id}

Marque la notifiquation à l'id indiqué comme lue si elle appartient à l'user courant.

Service

La classe est NotificationsService. Toutes les méthodes sont commentées, veuillez vous référer aux comentaires sur les méthodes plutot que ce README qui ne fait office que de listing de features.

Méthdodes:

  • notifyUsers:

    • Ajoute des notifications aux users
  • getForUser

    • Récupère toutes les notifications pour un user, sous format d'entité ou array TODO: ajouter des flags pour filtrer
  • toArray

    • Convertit un objet Notification en Array
  • duplicateNotification

    • Clone une notif (pour notifier un batch d'user) Normalement il n'y a aucun besoin d'utiliser cette méthode en dehors du bundle.

Entités

  • Notification: représente une notification pour un seul utilisateur