- Documentation
- Paquet Laravel · Version 0.1
- Le constructeur manuel
Le constructeur manuel
Sur cette page
Pour une publication écrite à la main plutôt que décrite par un modèle, SocialPublisher::post() ouvre un constructeur qui se lit comme une phrase et se termine par un verbe : publier, programmer ou garder en brouillon.
Publier à la main
use QuietSocial\Social\Facades\SocialPublisher;
SocialPublisher::post()
->title('Nouvel horaire')
->content('Nous ouvrons désormais le dimanche matin.')
->link('https://exemple.fr/horaires')
->tags('Boulangerie', 'Horaires')
->destinations(['facebook', 'linkedin'])
->overrideFor('linkedin', content: 'Nous ouvrons désormais le dimanche matin. Détails ci-dessous.')
->publish();
| Méthode | Effet |
|---|---|
title(), content(), link(), tags() |
Le titre interne, le texte, le lien, les tags. |
image(Image $image) |
L'image, envoyée à l'envoi du post. |
media(['med_…']) |
Une image déjà rangée par l'API, par son identifiant. |
brand('brd_…') |
La marque, à la place de QUIET_SOCIAL_BRAND_ID. |
destinations([...]) |
Des noms de réseau (toutes les destinations du réseau capables de publier) ou des identifiants dst_…. Obligatoire. |
overrideFor('linkedin', content: …) |
Un texte propre à un réseau. |
reference('article:42'), onBehalfOf($model) |
Votre identifiant, et le modèle à lier. |
publish(), schedule($date), draft() |
Envoie la publication, et rend la réponse de l'API en tableau (['data' => [...]]). |
Sans destinations(), l'envoi lève ValidationFailed (code destinations_required). Un post porte une image : media() n'accepte qu'un identifiant.
Depuis un modèle
publishSocially() ouvre le même constructeur avec la référence du modèle, et lie la publication au modèle une fois que l'API l'accepte. Un modèle qui ne publie qu'à la main utilise HasSocialPublications et déclare l'interface PublishesSocially. PublishesToSocial comprend le trait ; l'interface, qu'un trait ne peut pas porter, se déclare sur la classe quand quelque chose la vérifie (le relation manager du plugin Filament le fait).
use QuietSocial\Social\Concerns\HasSocialPublications;
use QuietSocial\Social\Contracts\PublishesSocially;
class Workshop extends Model implements PublishesSocially
{
use HasSocialPublications;
}
$workshop->publishSocially()
->content($workshop->summary)
->destinations(['facebook'])
->schedule(now()->addDay()->setTime(9, 0));
Les publications envoyées ainsi sont liées sans empreinte : la synchronisation automatique ne les annule ni ne les remplace jamais, et les webhooks tiennent leur statut à jour comme les autres.
Les erreurs
Le constructeur lève les exceptions du SDK : ValidationFailed quand l'API refuse le post, RateLimited et ServiceUnavailable pour un échec passager à retenter, AuthenticationFailed ou PermissionDenied pour la clé. Leur table, et quand réessayer, est dans la documentation du SDK PHP.
Sans référence, chaque appel reçoit une clé d'idempotence aléatoire : relancer un publish() publie deux fois. Donnez une reference() stable pour qu'un appel relancé soit reconnu.