Ir al contenido
Quiet Social

Publicar, cancelar y previsualizar a mano

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

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 un sync desactivado 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).