{"id":7600,"date":"2026-07-23T08:44:34","date_gmt":"2026-07-23T06:44:34","guid":{"rendered":"https:\/\/helpdesk.kontainer.com\/?post_type=article&#038;p=7600"},"modified":"2026-08-10T13:12:03","modified_gmt":"2026-08-10T11:12:03","slug":"strapi-integrationsleitfaden","status":"publish","type":"article","link":"https:\/\/helpdesk.kontainer.com\/de\/article\/strapi-integrationsleitfaden\/","title":{"rendered":"Strapi-Integrationsleitfaden"},"content":{"rendered":"<p>Mit der Strapi-Integration von Kontainer k\u00f6nnen Ihre Redakteure Bilder, Videos und Dateien direkt aus Ihrem DAM ausw\u00e4hlen, ohne Dateien zu Strapi hochzuladen. Strapi speichert lediglich eine Referenz zur Datei; die eigentliche Datei bleibt im Kontainer und wird \u00fcber das CDN ausgeliefert.<\/p>\n<p>Weitere Informationen zu Anwendungsf\u00e4llen, Vorteilen usw. finden Sie auf der <a href=\"https:\/\/kontainer.com\/de\/integrations\/strapi-cms\" target=\"_blank\" rel=\"noopener\">Kontainer-Integrationsseite.<\/a><\/p>\n<h2>Voraussetzungen<\/h2>\n<ul>\n<li>Strapi v5 (Strapi v4 wird nicht unterst\u00fctzt)<\/li>\n<li>Node.js 18+<\/li>\n<li>Ein Kontainer-Konto (https:\/\/ihrunternehmen.kontainer.com)<\/li>\n<li>Ein Entwickler mit Zugriff auf Ihre Strapi-Codebasis und das Deployment<\/li>\n<\/ul>\n<h2>Was wird wo gespeichert<\/h2>\n<p>Ihre Dateien bleiben in Kontainer. Es wird nichts in die Strapi-Mediathek hochgeladen. Strapi speichert nur eine JSON-Referenz zur Datei, die folgendes enth\u00e4lt:<\/p>\n<ul>\n<li><code>fileId, fileName, folderId <\/code>\u2013 Kennungen zum Abrufen der Datei<\/li>\n<li><code>url<\/code> \u2013 die CDN-URL, einschlie\u00dflich der von Ihnen gew\u00e4hlten Download-Vorlage<\/li>\n<li><code>thumbnailUrl, type, extension, Abmessungen, Dateigr\u00f6\u00dfe<\/code><\/li>\n<li><code>alt, description <\/code> und alle benutzerdefinierten Kontainer-Felder<\/li>\n<\/ul>\n<p>Da der Alt-Text und alle benutzerdefinierten Feldwerte mit der Referenz \u00fcbertragen werden, m\u00fcssen Redakteure Metadaten nicht erneut in Strapi eingeben, und Ihr Frontend kann sie direkt aus der Strapi-API-Antwort auslesen.<\/p>\n<h2>Erste Schritte<\/h2>\n<h3>1. Plugin installieren<\/h3>\n<p>In Ihrem Strapi-Projekt:<\/p>\n<p><code> npm install @kontainer\/strapi-plugin<\/code><\/p>\n<p>Committen Sie package.json und package-lock.json, damit das Plugin mit Ihrem Deployment ausgeliefert wird. Strapi erkennt und aktiviert das Plugin automatisch \u2013 es sind keine \u00c4nderungen an Konfigurationsdateien erforderlich.<\/p>\n<h3>2. Kontainer-Feld zu einem Content-Type hinzuf\u00fcgen<\/h3>\n<p>W\u00e4hlen Sie im Content-Type Builder Custom fields \u2192 Kontainer media, oder f\u00fcgen Sie es direkt zum Schema hinzu:<\/p>\n<p><code>\"hero\": {<br \/>\n\"type\": \"customField\",<br \/>\n\"customField\": \"plugin::kontainer.media\"<br \/>\n}<\/code><\/p>\n<p>Der Content-Type Builder ist in der Produktionsumgebung nur lesbar, f\u00fchren Sie diese \u00c4nderung daher in Ihrer Entwicklungsumgebung durch und deployen Sie die Schema-\u00c4nderung.<\/p>\n<h3>3. Build<\/h3>\n<p>Die Admin-Oberfl\u00e4che des Plugins wird in das Admin-Bundle kompiliert. Dieser Schritt ist erforderlich \u2013 ohne ihn erscheint die Schaltfl\u00e4che \u201eChoose from Kontainer&#8220; nicht.<\/p>\n<ul>\n<li>Den Kontainer File Picker \u00fcber ein Medienfeld in Ihrem Content-Type \u00f6ffnen<\/li>\n<li>Assets anhand von Metadaten, Tags oder Dateinamen suchen<\/li>\n<li>Assets vor dem Einf\u00fcgen in der Vorschau ansehen<\/li>\n<li>Assets direkt in Ihre Content-Types und Komponenten einf\u00fcgen<\/li>\n<\/ul>\n<p><code> npm ci --omit=dev<br \/>\nnpm run build<br \/>\nnpm run start<br \/>\n<\/code><\/p>\n<h3>4. Mit Kontainer verbinden<\/h3>\n<p>Gehen Sie zu Settings \u2192 Kontainer \u2192 Configuration und geben Sie Ihre Kontainer-URL ein, z. B. https:\/\/ihrunternehmen.kontainer.com. Das ist die gesamte Einrichtung \u2013 es werden keine API-Schl\u00fcssel oder Umgebungsvariablen ben\u00f6tigt.<\/p>\n<p>Die Einstellungen werden in der Strapi-Datenbank gespeichert, daher m\u00fcssen Sie sie einmal pro Umgebung (Staging und Produktion getrennt) festlegen.<\/p>\n<h3>5. Assets ausw\u00e4hlen<\/h3>\n<p>Klicken Sie im Editor auf Choose from Kontainer im entsprechenden Feld. Durchsuchen, filtern und st\u00f6bern Sie in Ihrer Kontainer-Bibliothek, wenden Sie optional eine Download-Vorlage an (Zuschnitt, Gr\u00f6\u00dfen\u00e4nderung, Format) und w\u00e4hlen Sie die Datei aus. Strapi speichert die Referenz; die CDN-URL spiegelt die von Ihnen gew\u00e4hlte Vorlage wider.<\/p>\n<h2>Optional: Nutzungsverfolgung von Dateien<\/h2>\n<p>Kontainer kann Ihnen anzeigen, wo jede Datei in Strapi verwendet wird. Klicken Sie unter Settings \u2192 Kontainer auf Generate, um einen Token zu erstellen, und registrieren Sie anschlie\u00dfend die angezeigte Endpoint-URL zusammen mit dem Token als Integration in Kontainer unter Settings \u2192 Integrations. Kontainer fragt Strapi daraufhin ab und meldet die Nutzung \u00fcber alle Content-Types hinweg, einschlie\u00dflich Entw\u00fcrfe, Sprachversionen, Komponenten und Dynamic Zones.<\/p>\n<h2>Die Referenz in Ihrem Frontend verwenden<\/h2>\n<p>Die Referenz wird unver\u00e4ndert von der Strapi Content-API zur\u00fcckgegeben:<\/p>\n<p><code>const page = await fetch(`${STRAPI_URL}\/api\/pages\/${documentId}`).then((r) =&gt; r.json());<br \/>\nconst { url, alt } = page.data.hero;<\/code><\/p>\n<p>Rufen Sie die Datei \u00fcber url ab \u2013 sie wird von Kontainers CDN ausgeliefert.<\/p>\n<h2>Support<\/h2>\n<p>Wenn Sie Hilfe bei der Einrichtung oder Konfiguration des Strapi-Plugins ben\u00f6tigen, hilft Ihnen unser Support-Team gerne weiter.<\/p>\n<p>Bitte kontaktieren Sie uns unter: <a href=\"mailto:support@kontainer.com\">support@kontainer.com<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Mit der Strapi-Integration von Kontainer k\u00f6nnen Sie Bilder, Videos und Dateien ganz einfach direkt aus Ihrem DAM in das Admin-Panel von Strapi einf\u00fcgen \u2013 ohne manuelles Herunter- und Hochladen.<\/p>\n","protected":false},"author":16,"featured_media":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","article-category":[109,112],"article-tag":[117,118,126,127],"class_list":["post-7600","article","type-article","status-publish","format-standard","hentry","article-category-admin-einstellungen","article-category-integrationen-plugins","article-tag-dam","article-tag-add-on-funktion","article-tag-strapi","article-tag-cms-integration"],"translations":{"de":{"id":7600,"title":"Strapi-Integrationsleitfaden","url":"https:\/\/helpdesk.kontainer.com\/de\/article\/strapi-integrationsleitfaden\/"},"en":{"id":7597,"title":"Strapi Integration Guide","url":"https:\/\/helpdesk.kontainer.com\/article\/strapi-integration-guide\/"}},"_links":{"self":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7600","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article"}],"about":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/types\/article"}],"author":[{"embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/comments?post=7600"}],"version-history":[{"count":1,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7600\/revisions"}],"predecessor-version":[{"id":7601,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7600\/revisions\/7601"}],"wp:attachment":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/media?parent=7600"}],"wp:term":[{"taxonomy":"article-category","embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article-category?post=7600"},{"taxonomy":"article-tag","embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article-tag?post=7600"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}