- Documentación
- Paquete Laravel · Versión 0.1
- Eventos de Laravel
Eventos de Laravel
El paquete emite ocho eventos de Laravel, todos en QuietSocial\Social\Events: tres vienen de la sincronización de tus modelos, cinco de los webhooks de Quiet Social. Escúchalos para avisar a un autor o reaccionar a una publicación.
Los eventos de la sincronización
| Evento | Se emite cuando | Propiedades |
|---|---|---|
SocialPostRejected |
La API, o el propio paquete, ha rechazado el post que describe un modelo: demasiado largo para una red, falta la imagen para Instagram, enlace relativo, portada inexistente… Sin nuevo intento; el mismo post no se reenvía, la siguiente modificación sí. | model, error (ValidationFailed), link (rejected, errores en last_error) |
SocialPostOutdated |
El modelo ha cambiado después de que saliera su post: no se envía nada para corregirlo. | model, link |
SocialPostFailed |
Una sincronización ha fallado por un motivo que un nuevo intento no resolverá (credenciales rechazadas, permiso ausente, error de configuración), o un fallo pasajero ha sobrevivido a todos los intentos. La excepción también se notifica con report(). |
model (null si se eliminó), error, link (o null) |
Se emiten una vez liberado el bloqueo del modelo, cada uno por separado: un listener puede guardar el modelo, y un listener que lanza una excepción se notifica sin que los demás se pierdan. SocialPostRejected solo se emite una vez por error: el mismo rechazo no se vuelve a registrar en cada guardado.
use Illuminate\Support\Facades\Event;
use QuietSocial\Social\Events\SocialPostOutdated;
Event::listen(function (SocialPostOutdated $event): void {
// El artículo ha cambiado después de que saliera su post: avisar a su autor.
});
Los eventos de los webhooks
| Evento | Notificación | Propiedades |
|---|---|---|
RemotePublicationCreated |
publication.created |
publication, payload, id(), reference() |
RemotePublicationPublished |
publication.published |
ídem |
RemotePublicationFailed |
publication.failed o publication.partially_published: lee publication['status'] para distinguirlos |
ídem |
RemotePublicationCancelled |
publication.cancelled: en el panel, por la API, o por este paquete |
ídem |
RemoteConnectionRequiresReconnect |
social_connection.requires_reconnect: no saldrá nada más en sus destinos mientras nadie la haya reconectado en el panel |
payload |
publication es la publicación tal como la devuelve la API, payload el cuerpo completo de la notificación. id() devuelve su identificador pub_…, reference() su external_reference, {clase morph}:{clave} para un post del paquete. El vínculo local se actualiza antes de que se emita el evento: un listener que vuelve a leer el modelo encuentra en él el estado anunciado.
Estos eventos solo se emiten si la ruta de webhook está configurada, y para los eventos a los que el endpoint está suscrito en el panel.