b27899aa73 | ||
---|---|---|
NotificationsBundle | ||
.gitignore | ||
README.md | ||
composer.json |
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