Ir al contenido
Quiet Social

Adoptar el paquete en una base existente

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

Lee esto antes de añadir PublishesToSocial a un modelo que ya tiene filas: sin el comando social:baseline, el primer guardado de cada modelo existente publica su post, y un artículo antiguo en el que se corrige una errata saldría ese mismo día en tus redes.

Lo que hace el comando

social:baseline registra el post que describe hoy cada modelo existente, sin enviar nada: ninguna llamada llega a la API. Después, un modelo solo se publica cuando su post cambia, o cuando publishToSocial() lo pide.

php artisan social:baseline "App\Models\Article" "App\Models\Event" --chunk=500

Admite una o varias clases, o alias de morph. Lee los modelos sin ámbitos globales, por lotes de --chunk (200 por defecto), y para cada uno:

  • un modelo cuya condición es verdadera (when, skip, shouldPublishSocially()) y que todavía no tiene ningún post de la sincronización recibe un vínculo baseline: la huella de su post, nunca enviado;
  • un modelo cuya condición es falsa se deja de lado: se publicará el día en que su condición pase a ser verdadera, como debe ocurrir con un post nuevo;
  • un modelo cuya fecha de publicación todavía está por llegar se deja de lado, contado como «scheduled in the future»: debe salir en su fecha, y su siguiente guardado (o publishToSocial()) lo envía;
  • un modelo en la papelera (eliminación suave) se deja de lado;
  • un modelo cuya sincronización se está ejecutando en ese momento se deja de lado, contado como «being synchronised»: el comando toma el mismo bloqueo que la sincronización, y lo espera lock_wait segundos;
  • un modelo que ya tiene un post de la sincronización se deja de lado: el comando puede ejecutarse dos veces;
  • un modelo que describe un post inválido se deja de lado, con una advertencia.

Muestra una línea por clase, y falla para una clase que no sea un modelo Eloquent que use PublishesToSocial:

App\Models\Article: 120 recorded, 3 scheduled in the future, 0 being synchronised, 7 left out.

El procedimiento recomendado

  1. Desactivar la sincronización durante el despliegue: QUIET_SOCIAL_SYNC_ENABLED=false.
  2. Desplegar el código que añade PublishesToSocial y su descripción, y luego ejecutar php artisan migrate.
  3. Registrar los modelos existentes con php artisan social:baseline, clase por clase o todas a la vez.
  4. Volver a activar la sincronización (quitar la variable o ponerla en true), refrescar una configuración en caché con php artisan config:cache, y reiniciar los workers con php artisan queue:restart.

El comando también puede ejecutarse con la sincronización activada: un modelo guardado mientras tanto se publica entonces, como corresponde, y el comando lo deja de lado.

Lo que protege sin el comando

El límite ignore_older_than (un día por defecto) impide enviar automáticamente un modelo cuya fecha de publicación es antigua. Es una segunda red de seguridad, no un sustituto: un modelo sin fecha de publicación nunca es demasiado antiguo, y un modelo con una fecha de hace menos de un día todavía sale.

Tras el comando, publishToSocial() envía de todos modos un post registrado como baseline: es la forma de volver a publicar a propósito un modelo antiguo.