Ir al contenido
Quiet Social

Instalación y configuración

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

El paquete se instala con Composer junto con el SDK PHP, crea su tabla mediante una migración, y se configura con variables de entorno QUIET_SOCIAL_*: una clave API, una marca, y algunos ajustes de sincronización.

Requisitos

  • PHP 8.2 o posterior, y Laravel 12 o 13 (Laravel 13 exige por sí mismo PHP 8.3). Laravel 11 ya no es compatible: ninguna de sus versiones está libre de vulnerabilidades conocidas.
  • El SDK PHP quiet-social/php-social, instalado con el paquete.
  • Una caché que admita bloqueos y que compartan todos los procesos que guardan modelos o ejecutan la cola: Redis, Memcached o la caché en base de datos. Consulta Sincronización automática.
  • Una cola, recomendada en producción.
  • Un espacio de trabajo de Quiet Social y una clave API.

Instalar

composer require quiet-social/laravel-social
php artisan migrate

El proveedor de servicios se descubre automáticamente. Sus migraciones crean la tabla social_publication_links, donde el paquete guarda lo que ha enviado para cada modelo. Para cambiar los valores por defecto, publica la configuración:

php artisan vendor:publish --tag=social-config

¿El modelo ya tiene filas? Lee Adoptar el paquete en una base existente antes de desplegar.

Crear una clave

Las claves se crean en el panel, página Clés API (claves API), por el propietario o un administrador del espacio de trabajo. El recorrido se describe en la guía. El secreto se muestra una sola vez:

QUIET_SOCIAL_CLIENT_ID=qsc_a1b2c3d4e5f6g7h8i9j0k1l2
QUIET_SOCIAL_CLIENT_SECRET=qss_...
QUIET_SOCIAL_BRAND_ID=brd_...
QUIET_SOCIAL_WEBHOOK_SECRET=whsec_...

QUIET_SOCIAL_BRAND_ID es necesario cuando la clave cubre todo un espacio de trabajo: entonces hay que decir a la API para qué marca publicar. Una clave vinculada a una marca no lo necesita.

Los permisos que necesita la clave

Lo que hace el paquete Permisos
Enviar un post publications:create, y media:create cuando el post lleva una portada
Resolver los nombres de red, encontrar las redes que declara un modelo destinations:read
Leer el estado de un post antes de sustituirlo, recuperar un intento publications:read
Cancelar un post que no ha salido publications:cancel

El constructor manual pide los mismos permisos, más media:read para una imagen dada por su identificador med_…. El paquete no usa brands:read. Cada permiso se describe en los permisos de la API.

Cada clave de configuración

Cada variable se lee como env('X') ?: valor_por_defecto: una variable presente pero vacía en .env vuelve a su valor por defecto.

Clave Variable Por defecto Función
url QUIET_SOCIAL_URL https://quietsocial.dev/api/v1 La dirección de la API, versión incluida.
panel_url QUIET_SOCIAL_PANEL_URL https://quietsocial.dev El panel, donde se reconecta una cuenta social.
client_id QUIET_SOCIAL_CLIENT_ID ninguno El identificador qsc_… de la clave.
client_secret QUIET_SOCIAL_CLIENT_SECRET ninguno Su secreto qss_…. Unas credenciales ausentes se revelan con AuthenticationFailed en la primera llamada.
brand_id QUIET_SOCIAL_BRAND_ID null La marca brd_… por defecto.
sync QUIET_SOCIAL_SYNC_ENABLED true La sincronización automática. false la detiene en todas partes, incluidos los jobs ya en cola; publishToSocial() sigue funcionando.
queue.connection QUIET_SOCIAL_QUEUE_CONNECTION null (tu conexión por defecto) La conexión de cola de los jobs de sincronización.
queue.name QUIET_SOCIAL_QUEUE null (la cola por defecto) Su cola.
lock_wait QUIET_SOCIAL_LOCK_WAIT 10 Segundos durante los que una sincronización espera el bloqueo de su modelo antes de volver a ponerse en cola.
ignore_older_than QUIET_SOCIAL_IGNORE_OLDER_THAN 1440 Minutos. Un modelo cuya fecha de publicación sea más antigua no se envía automáticamente. 0 elimina el límite.
destinations_ttl QUIET_SOCIAL_DESTINATIONS_TTL 300 Segundos durante los que los destinos capaces de publicar se guardan en caché, para los modelos que no nombran sus redes. 0 los vuelve a leer cada vez.
cover_disk QUIET_SOCIAL_COVER_DISK null (tu disco por defecto) El disco donde se lee una ruta de portada relativa.
cover_roots ninguna [storage_path('app/public'), public_path()] Las únicas carpetas donde se lee una ruta de portada absoluta. Una entrada relativa se lee desde base_path().
cover_max_bytes QUIET_SOCIAL_COVER_MAX_BYTES 20971520 (20 MiB) La portada más grande que se lee. 0 o menos se ignora.
allow_private_network_images QUIET_SOCIAL_ALLOW_PRIVATE_NETWORK_IMAGES false Autoriza una URL de portada hacia una dirección privada o local. Solo para un equipo de desarrollo.
webhook_secret QUIET_SOCIAL_WEBHOOK_SECRET null El secreto de firma whsec_…. Sin él, la ruta de webhook no existe.
webhook_path QUIET_SOCIAL_WEBHOOK_PATH social/webhook La ruta del webhook.
webhook_tolerance QUIET_SOCIAL_WEBHOOK_TOLERANCE 300 Segundos durante los que una firma sigue siendo válida.
webhook_replay_window QUIET_SOCIAL_WEBHOOK_REPLAY_WINDOW 43200 (12 h) Segundos durante los que se recuerda una entrega ya procesada. 0 desactiva el reconocimiento de reintentos.
connect_timeout QUIET_SOCIAL_CONNECT_TIMEOUT 5 Segundos para conectarse a la API.
timeout QUIET_SOCIAL_TIMEOUT 20 Segundos para una llamada completa.