Avec l'intégration de Kontainer à Strapi, vos éditeurs peuvent sélectionner des images, des vidéos et des fichiers directement depuis votre DAM, sans téléverser de fichiers dans Strapi.
Strapi ne conserve qu'une référence au fichier ; le fichier lui-même reste dans Kontainer et est diffusé via le CDN.

Rendez-vous sur la page des intégrations de Kontainer pour en savoir plus sur les cas d'usage, les avantages, etc.

Prérequis

  • Strapi v5 (Strapi v4 n'est pas pris en charge)
  • Node.js 18 ou supérieur
  • Un compte Kontainer (https://votreentreprise.kontainer.com)
  • Un développeur ayant accès au code de votre Strapi et capable de le déployer

Ce qui est stocké, et où

Vos fichiers restent dans Kontainer. Rien n'est téléversé dans la médiathèque de Strapi. Strapi ne stocke qu'une référence JSON au fichier, qui comprend :

  • fileId, fileName, folderId  : des identifiants pour retrouver le fichier
  • url : l'URL CDN, avec le modèle de téléchargement que vous avez choisi
  • thumbnailUrl, type, extension, dimensions, size
  • alt, description et tous les champs personnalisés de Kontainer

Comme le texte alternatif et toutes les valeurs des champs personnalisés accompagnent la référence, les éditeurs n'ont pas à ressaisir les métadonnées dans Strapi, et votre frontend peut les lire directement dans la réponse de l'API Strapi.

Pour commencer

1. Installer le plugin

Dans votre projet Strapi :

npm install @kontainer/strapi-plugin

Validez package.json et package-lock.json pour que le plugin soit livré avec votre déploiement. Strapi détecte et active le plugin automatiquement : aucune modification de fichier de configuration n'est nécessaire.

2. Ajouter le champ Kontainer à un type de contenu

Dans le Content-Type Builder, choisissez Custom fields → Kontainer media, ou ajoutez-le directement au schéma :

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

Le Content-Type Builder est en lecture seule en production : effectuez donc cette modification dans votre environnement de développement, puis déployez la modification du schéma.

3. Compiler

L'interface d'administration du plugin est compilée dans le bundle d'administration. Cette étape est obligatoire : sans elle, le bouton « Choose from Kontainer » n'apparaît pas.

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

4. Se connecter à Kontainer

Rendez-vous dans Settings → Kontainer → Configuration et saisissez l'URL de votre Kontainer. C'est toute la configuration : aucune clé d'API ni variable d'environnement n'est nécessaire.

Les paramètres sont enregistrés dans la base de données de Strapi : vous devrez donc les définir une fois par environnement (préproduction et production séparément).

5. Sélectionner des fichiers

Dans l'éditeur, cliquez sur « Choose from Kontainer » dans le champ. Parcourez, recherchez et filtrez votre bibliothèque Kontainer, appliquez si besoin un modèle de téléchargement (recadrage, redimensionnement, format), puis sélectionnez le fichier. Strapi enregistre la référence ; l'URL CDN reflète le modèle que vous avez choisi.

Facultatif : suivi de l'utilisation des fichiers

Kontainer peut vous montrer où chaque fichier est utilisé dans Strapi. Sous Settings → Kontainer, cliquez sur Generate pour créer un jeton, puis enregistrez l'URL du point d'accès affichée, avec le jeton, comme intégration dans Kontainer, sous Paramètres → Intégrations. Kontainer interroge ensuite Strapi et signale l'utilisation dans tous les types de contenu, y compris les brouillons, les langues, les composants et les zones dynamiques.

Utiliser la référence dans votre frontend

La référence est renvoyée telle quelle par l'API de contenu de Strapi :

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

Appelez le fichier à partir de url : il est servi depuis le CDN de Kontainer.

Support

Si vous avez besoin d'aide pour installer ou configurer le plugin Strapi, notre équipe de support se fera un plaisir de vous aider.

Contactez : support@kontainer.com