Aller au contenu
Quiet Social

É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.