- Documentation
- Paquet Laravel · Version 0.1
- Événements Laravel
Événements Laravel
Le paquet lève huit événements Laravel, tous dans QuietSocial\Social\Events : trois viennent de la synchronisation de vos modèles, cinq des webhooks de Quiet Social. Écoutez-les pour prévenir un auteur ou réagir à une publication.
Les événements de la synchronisation
| Événement | Levé quand | Propriétés |
|---|---|---|
SocialPostRejected |
L'API, ou le paquet lui-même, a refusé le post que décrit un modèle : trop long pour un réseau, image manquante pour Instagram, lien relatif, couverture introuvable… Pas de nouvel essai ; le même post n'est pas renvoyé, la prochaine modification l'est. | model, error (ValidationFailed), link (rejected, erreurs dans last_error) |
SocialPostOutdated |
Le modèle a changé après le départ de son post : rien n'est envoyé pour le corriger. | model, link |
SocialPostFailed |
Une synchronisation a échoué pour une raison qu'un nouvel essai ne réglera pas (identifiants refusés, droit manquant, erreur de configuration), ou un échec passager a survécu à toutes les tentatives. L'exception est aussi signalée par report(). |
model (null si supprimé), error, link (ou null) |
Ils sont levés une fois le verrou du modèle relâché, chacun pour soi : un écouteur peut enregistrer le modèle, et un écouteur qui lève une exception est signalé sans faire perdre les autres. SocialPostRejected n'est levé qu'une fois par erreur : le même refus n'est pas consigné de nouveau à chaque enregistrement.
use Illuminate\Support\Facades\Event;
use QuietSocial\Social\Events\SocialPostOutdated;
Event::listen(function (SocialPostOutdated $event): void {
// L'article a changé après le départ de son post : prévenir son auteur.
});
Les événements des webhooks
| Événement | Notification | Propriétés |
|---|---|---|
RemotePublicationCreated |
publication.created |
publication, payload, id(), reference() |
RemotePublicationPublished |
publication.published |
idem |
RemotePublicationFailed |
publication.failed ou publication.partially_published : lisez publication['status'] pour les distinguer |
idem |
RemotePublicationCancelled |
publication.cancelled : dans le panel, par l'API, ou par ce paquet |
idem |
RemoteConnectionRequiresReconnect |
social_connection.requires_reconnect : rien ne partira plus sur ses destinations tant que personne ne l'aura reconnectée dans le panel |
payload |
publication est la publication telle que la rend l'API, payload le corps entier de la notification. id() rend son identifiant pub_…, reference() son external_reference, {classe de morph}:{clé} pour un post du paquet. Le lien local est mis à jour avant que l'événement soit levé : un écouteur qui relit le modèle y trouve le statut annoncé.
Ces événements ne partent que si la route de webhook est configurée, et pour les événements auxquels l'endpoint est abonné dans le panel.