Recursos (biblioteca de imágenes)

Recursos es la biblioteca de imágenes de tu cuenta. Subes cada imagen una sola vez y la eliges desde cualquier sitio donde haga falta: el logo de un formulario, una imagen de un dashboard, una plantilla HTML, un PDF o un correo. No hay que pegar direcciones a mano ni volver a subir el mismo fichero.

Se abre desde el menú lateral, en Recursos.

Subir imágenes

Pulsa Subir imágenes o arrastra los ficheros sobre la zona de la cuadrícula. Puedes subir hasta 20 a la vez.


Tipos admitidos	JPG, PNG, WebP y GIF
Tamaño máximo	10 MB por imagen (lo fija el administrador)
No se admiten	SVG, PDF, vídeo ni otros ficheros

La pantalla muestra siempre los tipos y el tamaño máximo vigentes, y cuánto espacio llevas usado.
El tipo se comprueba por el contenido del fichero, no por su extensión: un texto renombrado como .png se rechaza.
En JPG, PNG y WebP se eliminan los metadatos de la foto (por ejemplo, la ubicación GPS) y se aplica la orientación correcta. Los GIF se guardan tal cual.
Si algunas imágenes fallan, las demás se suben igualmente y se indica el motivo de cada fallo.

Buscar y filtrar

Buscador: por nombre o por etiqueta.
Tipos: pulsa JPG, PNG, WebP o GIF para ver solo ese formato.
Solo las mías: muestra únicamente las que has subido tú.
Cada imagen se muestra con una miniatura, sus dimensiones y su tamaño. Si hay muchas, se paginan.

Detalle de una imagen

Al hacer clic en una imagen se abre su ficha:

Nombre y etiquetas (separadas por comas; sirven para encontrarla).
Visible sin iniciar sesión: ver Imágenes públicas y privadas.
Copiar URL y Copiar referencia (resource://…, ver Referencias).
Borrar.

Quién puede hacer qué: todos los usuarios de la cuenta pueden ver y subir imágenes. Modificar o borrar una imagen solo puede quien la subió o un administrador.

Imágenes públicas y privadas

Cada imagen tiene el interruptor Visible sin iniciar sesión, activado por defecto:

	Qué significa
Pública	Su dirección funciona para cualquiera que la tenga, sin cuenta. Es lo que necesitan los formularios públicos, los dashboards públicos y los correos. La dirección es estable y no caduca.
Privada	Solo se ve dentro de Floogos mientras tienes la sesión iniciada. Las direcciones que genera Floogos para ella caducan a los 15 minutos.

Si eliges una imagen privada para usarla como dirección en un formulario, un dashboard o un HTML, el selector te avisa y te ofrece hacerla pública y usarla, porque quien no haya iniciado sesión no la vería.

Desactivar el interruptor revoca de inmediato la dirección pública anterior. Si la vuelves a activar, la misma dirección vuelve a funcionar.

Usar una imagen desde otras partes de Floogos

En todos los casos, el botón Elegir de la biblioteca (o Imagen) abre el mismo selector, con buscador, filtros y subida, y también puedes subir ahí una imagen nueva.

Dónde	Cómo
Dashboards	Widget Imagen → pestaña Datos → Elegir de la biblioteca.
Formularios	Campo Imagen → Elegir de la biblioteca. Además, en Ajustes del formulario hay un Logo del formulario que se muestra sobre el título en el formulario público.
Plantilla HTML (nodo HTML Template)	Botón Imagen de la barra del editor: inserta un `<img>` con su dirección pública en el punto del cursor.
Documentos PDF/HTML (nodo Document Generator)	En un bloque Imagen, usa `resource://<id>` (o una variable que lo contenga).
Correos (nodo sendMail)	En Archivos adjuntos, añade `resource://<id>`; se adjunta con su nombre original.

Referencias `resource://`

Cada imagen tiene un identificador. Su referencia es resource:// seguido del identificador, por ejemplo resource://0b6f1c2e-…. Se copia con Copiar referencia en la ficha de la imagen.

Se usa en los nodos que leen la imagen del servidor (PDF y adjuntos de correo). Floogos la traduce a la imagen real en el momento de ejecutar, por lo que:

no hay que conocer ni guardar rutas del servidor;
sigue funcionando aunque cambie dónde se almacenan las imágenes;
solo resuelve imágenes de tu propia cuenta.

En PDF: el PDF solo admite JPEG, así que la imagen se convierte automáticamente (se aplana sobre fondo blanco, por lo que las transparencias salen blancas, y se reduce a un máximo de 1600 px de ancho). En documentos HTML se usa la dirección pública de la imagen; si es privada, se incrusta en el propio documento.

Si una imagen referenciada ya no existe, el documento o el correo se generan igualmente, sin esa imagen, y queda un aviso en el registro de ejecución.

Para administradores (On-Premise)

Carpeta de almacenamiento

Las imágenes se guardan en una carpeta que se define en el .env del servidor:

# Carpeta raíz de las imágenes (obligatoria en producción)
RESOURCES_ROOT=/ruta/de/la/unidad/compartida/imagenes

Si hay varios servidores, la carpeta debe ser una unidad compartida (por ejemplo NFS) montada en la misma ruta en todos ellos, para que una imagen subida en uno se vea desde los demás. El usuario con el que se ejecuta Floogos necesita permiso de lectura y escritura sobre ella.

Dentro, Floogos crea sola esta estructura:

<RESOURCES_ROOT>/
  <id del cliente>/
     <identificador>.jpg | .png | .webp | .gif
     thumbs/<identificador>_160.webp  y  _480.webp   (miniaturas)
  .tmp/                                              (subidas en curso)

Cada cliente tiene su propia carpeta, con su número, y sus imágenes no se mezclan con las de otros.
Los nombres de fichero los genera el servidor; el nombre original solo se guarda como dato de la imagen.
La carpeta .tmp debe estar en la misma unidad, para que cada imagen se guarde de forma atómica y otro servidor nunca lea una a medias.
Si RESOURCES_ROOT no está definida en producción, el servidor rechaza las subidas (en lugar de guardarlas en el disco local de un solo servidor) y la pantalla de Recursos muestra un aviso.

Otras variables

Variable	Por defecto	Qué hace
`UPLOAD_MAX_MB`	`10`	Tamaño máximo por imagen, en MB.
`UPLOAD_ALLOWED_TYPES`	`jpg,png,webp,gif`	Tipos admitidos (puede reducirse, por ejemplo a `png,jpg`).
`RESOURCES_QUOTA_MB`	sin límite	Espacio total por cliente, en MB (solo On-Premise).
`RESOURCES_URL_SECRET`	usa `JWT_SECRET`	Secreto con el que se firman las direcciones de las imágenes.
`ENGINE_HOST`	—	Dirección pública del servidor Floogos. Hace falta para que las imágenes de PDF/HTML y correos tengan dirección completa.

Puesta en marcha

Crea la carpeta en la unidad compartida y comprueba que el usuario del servicio escribe en ella desde cada servidor.
Define RESOURCES_ROOT (y, si procede, ENGINE_HOST) en el .env y reinicia Floogos.
Si hay un proxy delante, asegúrate de que las rutas que empiezan por /r/ llegan al servidor Floogos: son las que sirven las imágenes.
Sube una imagen desde un servidor y comprueba que se ve desde el otro.

Copias de seguridad

Incluye la carpeta RESOURCES_ROOT en tu copia de seguridad junto con la base de datos: la base guarda el catálogo (nombres, etiquetas, quién subió cada imagen) y la carpeta guarda los ficheros. Una sin la otra no sirve.

Seguridad

Cada cuenta solo ve y usa sus imágenes.
Los ficheros se validan por contenido y se guardan con nombres propios; no se admite SVG (puede ejecutar código).
Las direcciones llevan una firma que no se puede falsificar; una dirección manipulada no sirve.
Las imágenes privadas nunca se sirven por la dirección pública.