Ir al contenido
Quiet Social

Portadas

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

La portada de un post es su imagen: una Image del SDK, una URL, una ruta absoluta bajo una carpeta autorizada, o una ruta en un disco. El paquete la lee en el momento del envío, con salvaguardas contra lo que un modelo no debería hacer publicar.

Las cuatro formas

Portada Cómo se lee
Una Image del SDK Tal cual, con su propio texto alternativo.
Una URL http(s):// Descargada por el SDK al enviar el post. Las direcciones privadas y locales se rechazan, salvo si allow_private_network_images vale true.
Una ruta absoluta Solo se lee bajo una de las cover_roots, y solo si es una imagen.
Cualquier otra cadena Una ruta en el disco coverDisk, si no cover_disk, si no tu disco por defecto.
#[SocialPost(content: 'excerpt', cover: 'cover_path', coverAlt: 'cover_alt', coverDisk: 'public')]
class Article extends Model
{
    use PublishesToSocial;
}

Las salvaguardas

  • Carpetas autorizadas. Una ruta absoluta solo se lee bajo storage_path('app/public') o public_path() (la clave cover_roots, que se amplía publicando la configuración), y solo si el archivo es una imagen: una ruta guardada en un modelo no puede hacer que se envíe /etc/hosts o tu .env. storage/app/private no es una raíz por defecto: publicar desde esa carpeta debe ser una decisión.
  • Tamaño. Una portada más pesada que cover_max_bytes (20 MiB) se rechaza antes de leerla.
  • Red privada. Una URL hacia una dirección privada, local o reservada se rechaza, para que una dirección introducida por un usuario no alcance tu propia red. QUIET_SOCIAL_ALLOW_PRIVATE_NETWORK_IMAGES=true levanta ese rechazo en un equipo de desarrollo que sirve sus imágenes en http://localhost, nunca en producción. El detalle de la descarga está en la documentación del SDK PHP.

Cuando falla una portada

  • Un archivo o una ruta inexistente, fuera de las carpetas autorizadas, demasiado pesado o que no es una imagen hace que el post sea inválido: vínculo rejected y SocialPostRejected.
  • Un disco que no responde es un fallo pasajero, que se reintenta.
  • Una URL rechazada, o que su servidor no entrega, hace fallar el post: SocialPostFailed, y un vínculo failed que se reenvía en la siguiente modificación. Un error de servidor o un límite de frecuencia de su host se reintenta.

Texto alternativo y redes

coverAlt es el texto alternativo. Cada red puede tener su portada (#[Pinterest(cover: …)], pinterestCover()) y su texto alternativo; un texto alternativo de red sin portada de red describe la imagen común en esa red. Un post lleva una imagen, y una por red como máximo.

La huella de una portada

La huella de un archivo de portada se calcula sobre su ruta, su tamaño y su fecha de modificación, sin leerlo: comprobar que un post no ha cambiado no cuesta una lectura de archivo. Sustituir el archivo cambia su tamaño o su fecha, y por tanto el post.