Ir al contenido
Quiet Social

El constructor manual

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

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.