- Documentación
- Paquete Laravel · Versión 0.1
- El constructor manual
El constructor manual
En esta página
Para una publicación escrita a mano en lugar de descrita por un modelo, SocialPublisher::post() abre un constructor que se lee como una frase y termina con un verbo: publicar, programar o guardar como borrador.
Publicar a mano
use QuietSocial\Social\Facades\SocialPublisher;
SocialPublisher::post()
->title('Nuevo horario')
->content('Ahora abrimos también el domingo por la mañana.')
->link('https://ejemplo.es/horarios')
->tags('Panadería', 'Horarios')
->destinations(['facebook', 'linkedin'])
->overrideFor('linkedin', content: 'Ahora abrimos también el domingo por la mañana. Detalles a continuación.')
->publish();
| Método | Efecto |
|---|---|
title(), content(), link(), tags() |
El título interno, el texto, el enlace, las etiquetas. |
image(Image $image) |
La imagen, enviada al enviar el post. |
media(['med_…']) |
Una imagen ya guardada por la API, por su identificador. |
brand('brd_…') |
La marca, en lugar de QUIET_SOCIAL_BRAND_ID. |
destinations([...]) |
Nombres de red (todos los destinos de la red capaces de publicar) o identificadores dst_…. Obligatorio. |
overrideFor('linkedin', content: …) |
Un texto propio de una red. |
reference('article:42'), onBehalfOf($model) |
Tu identificador, y el modelo que vincular. |
publish(), schedule($date), draft() |
Envía la publicación, y devuelve la respuesta de la API como array (['data' => [...]]). |
Sin destinations(), el envío lanza ValidationFailed (código destinations_required). Un post lleva una imagen: media() solo acepta un identificador.
Desde un modelo
publishSocially() abre el mismo constructor con la referencia del modelo, y vincula la publicación al modelo una vez que la API la acepta. Un modelo que solo publica a mano usa HasSocialPublications y declara la interfaz PublishesSocially. PublishesToSocial incluye el trait; la interfaz, que un trait no puede llevar, se declara en la clase cuando algo la comprueba (el relation manager del plugin de Filament lo hace).
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));
Las publicaciones enviadas así se vinculan sin huella: la sincronización automática nunca las cancela ni las sustituye, y los webhooks mantienen su estado al día como los demás.
Los errores
El constructor lanza las excepciones del SDK: ValidationFailed cuando la API rechaza el post, RateLimited y ServiceUnavailable para un fallo pasajero que hay que reintentar, AuthenticationFailed o PermissionDenied para la clave. Su tabla, y cuándo reintentar, está en la documentación del SDK PHP.
Sin referencia, cada llamada recibe una clave de idempotencia aleatoria: relanzar un publish() publica dos veces. Da una reference() estable para que una llamada relanzada se reconozca.