- Documentación
- Paquete Laravel · Versión 0.1
- Publicar, cancelar y previsualizar a mano
Publicar, cancelar y previsualizar a mano
En esta página
El trait PublishesToSocial da tres métodos al modelo: publishToSocial() fuerza la sincronización, cancelSocialPublication() cancela el post sin esperar, y toSocialPost() muestra el post sin enviar nada.
Forzar la publicación
$article->publishToSocial();
Pone en cola la sincronización del modelo de inmediato, forzada:
- su condición (
when,skip,shouldPublishSocially()), su antigüedad (ignore_older_than) y unsyncdesactivado se ignoran; - un post sin cambios se reenvía si había sido rechazado, había fallado tres veces, había sido registrado por
social:baseline, o había sido cancelado o había fallado en Quiet Social.
Nunca publica dos veces un post todavía programado o ya publicado, y las redes que el modelo omite siguen omitidas. Un modelo aún no guardado lanza InvalidSocialConfiguration: la sincronización lee el modelo en la base de datos.
Cancelar
$article->cancelSocialPublication();
Cancela el post activo del modelo si no ha salido. Es síncrono: la llamada llega a la API antes de que el método devuelva el control. Toma el bloqueo del modelo, lo espera lock_wait segundos, y lanza una LockTimeoutException si una sincronización lo retiene más tiempo; un error de la API sube como excepción del SDK.
El siguiente guardado reenvía el post mientras se cumpla la condición del modelo: haz que la condición sea falsa para que siga sin publicar.
Previsualizar
use QuietSocial\Sdk\Network;
$post = $article->toSocialPost();
$post->content; // el texto común
$post->network(Network::LinkedIn)?->content; // el texto de LinkedIn, si tiene uno propio
$post->scheduledAt; // null cuando saldría enseguida
Construye el Post del SDK que describe el modelo, sin ninguna llamada a la API y sin sus destinos: una vista previa, para una pantalla de edición o una prueba. Una portada en un disco se lee; una URL no se descarga. Un modelo mal descrito lanza InvalidSocialConfiguration, y unos datos inválidos lanzan InvalidSocialPost.
Los vínculos de un modelo
foreach ($article->socialPublications as $link) {
$link->status; // scheduled, published, rejected, baseline…
$link->remote_publication_id; // pub_…, o null para un post rechazado
}
socialPublications lista los vínculos del modelo, mantenidos al día por los webhooks: status, remote_publication_id, scheduled_at, published_at, fingerprint (null para una publicación manual), last_error (en JSON, para un vínculo rejected o failed), closed_reason y cancelled_at. Sus fechas se guardan en la zona horaria de tu aplicación.
Además de los estados de la API, un vínculo puede valer creating (un intento en curso), baseline (registrado por social:baseline, nunca enviado), rejected (rechazado, sin publicación remota) o failed (no salió, se reenvía en la siguiente modificación).