Aller au contenu
Quiet Social

Publier, annuler et prévisualiser à la main

Le trait PublishesToSocial donne trois méthodes au modèle : publishToSocial() force la synchronisation, cancelSocialPublication() annule le post sans attendre, et toSocialPost() montre le post sans rien envoyer.

Forcer la publication

$article->publishToSocial();

Met en file la synchronisation du modèle tout de suite, forcée :

  • sa condition (when, skip, shouldPublishSocially()), son âge (ignore_older_than) et un sync coupé sont ignorés ;
  • un post inchangé est renvoyé s'il avait été refusé, avait échoué trois fois, avait été enregistré par social:baseline, ou avait été annulé ou avait échoué dans Quiet Social.

Elle ne publie jamais deux fois un post encore programmé ou déjà publié, et les réseaux que le modèle saute restent sautés. Un modèle pas encore enregistré lève InvalidSocialConfiguration : la synchronisation lit le modèle en base.

Annuler

$article->cancelSocialPublication();

Annule le post actif du modèle s'il n'est pas parti. C'est synchrone : l'appel atteint l'API avant que la méthode rende la main. Elle prend le verrou du modèle, l'attend lock_wait secondes, et lève une LockTimeoutException si une synchronisation le garde plus longtemps ; une erreur de l'API remonte en exception du SDK.

Le prochain enregistrement renvoie le post tant que la condition du modèle tient : rendez la condition fausse pour qu'il reste non publié.

Prévisualiser

use QuietSocial\Sdk\Network;

$post = $article->toSocialPost();

$post->content;                                   // le texte commun
$post->network(Network::LinkedIn)?->content;      // le texte LinkedIn, s'il en a un à lui
$post->scheduledAt;                               // null quand il partirait tout de suite

Construit le Post du SDK que décrit le modèle, sans aucun appel à l'API et sans ses cibles : un aperçu, pour un écran d'édition ou un test. Une couverture sur un disque est lue ; une URL n'est pas téléchargée. Un modèle mal décrit lève InvalidSocialConfiguration, des données invalides lèvent InvalidSocialPost.

Les liens d'un modèle

foreach ($article->socialPublications as $link) {
    $link->status;                  // scheduled, published, rejected, baseline…
    $link->remote_publication_id;   // pub_…, ou null pour un post refusé
}

socialPublications liste les liens du modèle, tenus à jour par les webhooks : status, remote_publication_id, scheduled_at, published_at, fingerprint (null pour une publication manuelle), last_error (en JSON, pour un lien rejected ou failed), closed_reason et cancelled_at. Ses dates sont rangées dans le fuseau de votre application.

Outre les statuts de l'API, un lien peut valoir creating (une tentative en cours), baseline (enregistré par social:baseline, jamais envoyé), rejected (refusé, sans publication distante) ou failed (n'est pas parti, renvoyé à la prochaine modification).