Con la integración de Kontainer con Strapi, tus editores pueden elegir imágenes, vídeos y archivos directamente desde tu DAM sin subir archivos a Strapi.
Strapi solo guarda una referencia al archivo; el archivo en sí permanece en Kontainer y se entrega a través de la CDN.

Ve a la página de integraciones de Kontainer para saber más sobre los casos de uso, las ventajas y más.

Requisitos

  • Strapi v5 (Strapi v4 no es compatible)
  • Node.js 18 o superior
  • Una cuenta de Kontainer (https://yourcompany.kontainer.com)
  • Un desarrollador con acceso al código de tu Strapi y con capacidad para desplegar

¿Qué se guarda y dónde?

Tus archivos se quedan en Kontainer. No se sube nada a la biblioteca multimedia de Strapi. Strapi solo guarda una referencia JSON al archivo, que incluye:

  • fileId, fileName, folderId : identificadores para recuperar el archivo
  • url: la URL de la CDN, incluida la plantilla de descarga que hayas elegido
  • thumbnailUrl, type, extension, dimensions, size
  • alt, description y todos los campos personalizados de Kontainer

Como el texto alternativo y todos los valores de los campos personalizados viajan con la referencia, los editores no tienen que volver a escribir los metadatos en Strapi, y tu frontend puede leerlos directamente de la respuesta de la API de Strapi.

Primeros pasos

1. Instala el plugin

En tu proyecto de Strapi:

npm install @kontainer/strapi-plugin

Sube a tu repositorio (commit) package.json y package-lock.json para que el plugin se incluya en tu despliegue. Strapi detecta y activa el plugin automáticamente: no hace falta cambiar ningún archivo de configuración.

2. Añade el campo de Kontainer a un tipo de contenido

En el Content-Type Builder, elige «Custom fields → Kontainer media» (campos personalizados), o añádelo directamente al esquema:

"hero": {
"type": "customField",
"customField": "plugin::kontainer.media"
}

El Content-Type Builder es de solo lectura en producción, así que haz este cambio en tu entorno de desarrollo y despliega el cambio de esquema.

3. Compila

La interfaz de administración del plugin se compila dentro del paquete de administración. Este paso es obligatorio: sin él, el botón «Choose from Kontainer» no aparece.

npm ci --omit=dev
npm run build
npm run start

4. Conéctate a Kontainer

Ve a «Settings → Kontainer → Configuration» (ajustes, Kontainer, configuración) e introduce la URL de tu Kontainer. Eso es toda la configuración: no hacen falta claves de API ni variables de entorno.

Los ajustes se guardan en la base de datos de Strapi, así que tendrás que definirlos una vez por entorno (preproducción y producción por separado).

5. Elige archivos

En el editor, haz clic en «Choose from Kontainer» (elegir desde Kontainer) en el campo. Navega, busca y filtra tu biblioteca de Kontainer, aplica opcionalmente una plantilla de descarga (recorte, cambio de tamaño, formato) y elige el archivo. Strapi guarda la referencia; la URL de la CDN refleja la plantilla que hayas elegido.

Opcional: seguimiento del uso de archivos

Kontainer puede mostrarte dónde se usa cada archivo en Strapi. En «Settings → Kontainer», haz clic en «Generate» (generar) para crear un token y registra después la URL del endpoint que se muestra, junto con el token, como integración en Kontainer, en Ajustes → Integraciones. Kontainer consulta entonces Strapi e informa del uso en todos los tipos de contenido, incluidos borradores, idiomas (locales), componentes y zonas dinámicas.

Usar la referencia en tu frontend

La referencia vuelve sin cambios de la API de contenido de Strapi:

const page = await fetch(`${STRAPI_URL}/api/pages/${documentId}`).then((r) => r.json());
const { url, alt } = page.data.hero;

Solicita el archivo desde url: se sirve desde la CDN de Kontainer.

Soporte

Si necesitas ayuda para configurar el plugin de Strapi, nuestro equipo de soporte te ayudará encantado.

Escribe a: support@kontainer.com