Ir al contenido
Quiet Social

Eventos de Laravel

Esta documentación está traducida del francés. Si ambas versiones difieren, prevalece la versión francesa.

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.