{"id":7755,"date":"2026-09-24T07:36:35","date_gmt":"2026-09-24T05:36:35","guid":{"rendered":"https:\/\/helpdesk.kontainer.com\/?post_type=article&#038;p=7755"},"modified":"2026-09-24T07:36:35","modified_gmt":"2026-09-24T05:36:35","slug":"storyblok-integrationsleitfaden","status":"publish","type":"article","link":"https:\/\/helpdesk.kontainer.com\/de\/article\/storyblok-integrationsleitfaden\/","title":{"rendered":"Storyblok-Integrationsleitfaden"},"content":{"rendered":"<p>Mit der Storyblok-Integration von Kontainer k\u00f6nnen Ihre Redakteure Bilder, Videos und Dateien direkt aus Ihrem DAM ausw\u00e4hlen, ohne Dateien zu Storyblok hochzuladen. Storyblok speichert lediglich eine Referenz zur Datei; die eigentliche Datei bleibt in 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\" target=\"_blank\" rel=\"noopener\">Kontainer-Integrationsseite.<\/a><\/p>\n<h2>Voraussetzungen<\/h2>\n<ul>\n<li>Ein Storyblok-Space sowie <strong>Administratorrechte<\/strong> daf\u00fcr \u2013 ohne diese l\u00e4sst sich die Extension nicht installieren<\/li>\n<li>Ein Kontainer-Konto (https:\/\/ihrunternehmen.kontainer.com)<\/li>\n<li>Die aktivierte Storyblok-Integration in Ihrem Kontainer-Konto \u2013 kl\u00e4ren Sie mit Ihrem Account Manager, ob sie in Ihrem Tarif enthalten ist<\/li>\n<\/ul>\n<h2>Was wird wo gespeichert<\/h2>\n<p>Ihre Dateien bleiben in Kontainer. Es wird nichts in die Asset-Bibliothek von Storyblok hochgeladen. Storyblok speichert einen gew\u00f6hnlichen Asset-Wert, der auf das Kontainer-CDN verweist, zusammen mit der Kontainer-Referenz:<\/p>\n<ul>\n<li><code>filename<\/code> \u2013 die CDN-URL, einschlie\u00dflich der von Ihnen gew\u00e4hlten Download-Vorlage<\/li>\n<li><code>alt, title<\/code> \u2013 \u00fcbernommen aus der Beschreibung der Datei in Kontainer<\/li>\n<li><code>focus<\/code> \u2013 der in Kontainer gesetzte Fokuspunkt, im Format von Storyblok<\/li>\n<li><code>meta_data.kontainer_file_id, kontainer_folder_id, kontainer_url<\/code> \u2013 Kennungen zum Abrufen der Datei<\/li>\n<li><code>meta_data.kontainer_thumbnail_url, kontainer_extension, kontainer_type<\/code><\/li>\n<\/ul>\n<p>Da der Alt-Text und der Fokuspunkt mit der Referenz \u00fcbertragen werden, m\u00fcssen Redakteure Metadaten nicht erneut in Storyblok eingeben. Wird eine Datei in Kontainer ersetzt, aktualisiert sie sich \u00fcberall dort, wo sie verwendet wird.<\/p>\n<h2>Erste Schritte<\/h2>\n<h3>1. Integration in Kontainer aktivieren<\/h3>\n<p>Bitten Sie Ihren Account Manager, die Storyblok-Integration f\u00fcr Ihr Kontainer-Konto zu aktivieren. Dadurch darf Storyblok den Kontainer File Picker einbetten; ohne diesen Schritt \u00f6ffnet sich der Picker nicht.<\/p>\n<h3>2. Extension in Storyblok installieren<\/h3>\n<p>\u00d6ffnen Sie den Installationslink, w\u00e4hlen Sie den gew\u00fcnschten Space aus und best\u00e4tigen Sie:<\/p>\n<pre><code>https:\/\/app.storyblok.com\/#\/install\/kontainer@asset-picker<\/code><\/pre>\n<p>Daf\u00fcr ben\u00f6tigen Sie Administratorrechte f\u00fcr den Ziel-Space. Die Installation erfolgt einmal pro Space.<\/p>\n<h3>3. Kontainer-Feld zu einem Block hinzuf\u00fcgen<\/h3>\n<p>Gehen Sie in Ihrem Space zur <strong>Block Library<\/strong>, \u00f6ffnen Sie den Block, in dem Sie den Picker verwenden m\u00f6chten, und f\u00fcgen Sie ein neues Feld hinzu. Setzen Sie dessen Typ auf <strong>Plugin<\/strong> und w\u00e4hlen Sie <code>kontainer<\/code> aus der Liste.<\/p>\n<h3>4. Feld auf Ihr Kontainer ausrichten<\/h3>\n<p>F\u00fcgen Sie dem ausgew\u00e4hlten Feld die Option <code>kontainerHost<\/code> hinzu und tragen Sie Ihre Kontainer-Domain ein, zum Beispiel <code>ihrunternehmen.kontainer.com<\/code> (mit oder ohne <code>https:\/\/<\/code>).<\/p>\n<p>Storyblok speichert Plugin-Optionen pro Feld \u2013 wiederholen Sie diesen Schritt daher f\u00fcr jedes Feld, das den Picker verwendet. Optionswerte werden von Storyblok nicht zwischen Spaces \u00fcbernommen, jeder Space wird also separat konfiguriert.<\/p>\n<h3>5. Assets ausw\u00e4hlen<\/h3>\n<p>\u00d6ffnen Sie eine Story, die den Block verwendet, und klicken Sie im Feld auf <strong>Select from Kontainer<\/strong>. Melden Sie sich beim ersten Mal mit Ihrem gewohnten Kontainer-Benutzernamen und Passwort an. Durchsuchen und filtern Sie Ihre Bibliothek wie gewohnt, wenden Sie optional eine Download-Vorlage an (Zuschnitt, Gr\u00f6\u00dfen\u00e4nderung, Format) und w\u00e4hlen Sie die Datei aus.<\/p>\n<p>Das Feld zeigt anschlie\u00dfend eine Vorschau und den Dateinamen. Mit <strong>Replace asset<\/strong> w\u00e4hlen Sie eine andere Datei, mit <strong>Remove asset<\/strong> leeren Sie das Feld. F\u00fcr Dateien, die keine Bilder sind \u2013 etwa PDFs und Videos \u2013 wird anstelle einer Bildvorschau eine Dateikarte mit dem Dateityp angezeigt.<\/p>\n<h2>Feldoptionen<\/h2>\n<table>\n<tr>\n<th>Option<\/th>\n<th>Erforderlich<\/th>\n<th>Wert<\/th>\n<\/tr>\n<tr>\n<td><code>kontainerHost<\/code><\/td>\n<td>Ja<\/td>\n<td>Ihre Kontainer-Domain, z. B. <code>ihrunternehmen.kontainer.com<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>mode<\/code><\/td>\n<td>Nein<\/td>\n<td><code>external<\/code> (Standard) verlinkt die Datei in Kontainer. <code>import<\/code> kopiert sie in die Asset-Bibliothek von Storyblok.<\/td>\n<\/tr>\n<tr>\n<td><code>storyblokRegion<\/code><\/td>\n<td>Nur bei Import<\/td>\n<td><code>eu<\/code> (Standard), <code>us<\/code>, <code>ca<\/code>, <code>ap<\/code> oder <code>cn<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>storyblokManagementToken<\/code><\/td>\n<td>Nur bei Import<\/td>\n<td>Ein pers\u00f6nlicher Storyblok-Zugriffstoken mit Schreibrechten f\u00fcr Assets<\/td>\n<\/tr>\n<tr>\n<td><code>maxImportMb<\/code><\/td>\n<td>Nein<\/td>\n<td>Maximale Dateigr\u00f6\u00dfe f\u00fcr den Import, Standard <code>50<\/code><\/td>\n<\/tr>\n<\/table>\n<h2>Optional: Dateien nach Storyblok importieren<\/h2>\n<p>Manche Teams verlangen, dass s\u00e4mtliche Assets von Storyblok selbst gehostet werden. Wenn Sie <code>mode<\/code> auf <code>import<\/code> setzen, wird die Datei in die Asset-Bibliothek des Space kopiert statt verlinkt. Sie ist dann ein gew\u00f6hnliches Storyblok-Asset und kann vom Image Service von Storyblok transformiert werden.<\/p>\n<p>Zwei Punkte sollten Sie beachten, bevor Sie ein Feld auf den Import-Modus umstellen:<\/p>\n<ul>\n<li>Die Kopie wird nicht mehr aktualisiert, wenn sich die Datei in Kontainer \u00e4ndert.<\/li>\n<li>Der Management-Token ist eine Feldoption und wird damit an den Browser jedes Redakteurs ausgeliefert, der dieses Feld verwendet. Erstellen Sie daf\u00fcr ein <strong>eingeschr\u00e4nktes<\/strong> Token: Vergeben Sie in Storyblok ausschlie\u00dflich den Scope \u201eAssets\u201c und beschr\u00e4nken Sie das Token auf den einen Space, der es ben\u00f6tigt. Verwenden Sie kein Token, das Zugriff auf Ihr gesamtes Konto hat.<\/li>\n<\/ul>\n<h2>Das Asset in Ihrem Frontend verwenden<\/h2>\n<p>Das Feld gibt ein gew\u00f6hnliches Storyblok-Asset-Objekt zur\u00fcck und verh\u00e4lt sich damit wie jedes andere Asset-Feld:<\/p>\n<pre><code>const { filename, alt, focus } = story.content.hero;<\/code><\/pre>\n<p>Rufen Sie die Datei \u00fcber <code>filename<\/code> ab \u2013 sie wird von Kontainers CDN ausgeliefert.<\/p>\n<p>Der Image Service von Storyblok kann externe URLs weder skalieren noch zuschneiden. Verwenden Sie daher die Transformationsparameter von Kontainer oder eine bei der Auswahl gew\u00e4hlte Download-Vorlage, um Gr\u00f6\u00dfe und Format der ausgelieferten Datei zu steuern. Der Fokuspunkt steht sowohl als <code>focus<\/code>-Wert von Storyblok als auch als Pixelkoordinaten in <code>meta_data<\/code> zur Verf\u00fcgung.<\/p>\n<h2>Support<\/h2>\n<p>Wenn Sie Hilfe bei der Einrichtung oder Konfiguration des Storyblok-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 Storyblok-Integration von Kontainer k\u00f6nnen Ihre Redakteure Bilder, Videos und Dateien direkt aus Ihrem DAM in den Visual Editor von Storyblok einf\u00fcgen \u2013 ohne manuelles Herunter- und Hochladen.<\/p>\n","protected":false},"author":17,"featured_media":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","article-category":[109,112],"article-tag":[118,117,118,123],"class_list":["post-7755","article","type-article","status-publish","hentry","article-category-admin-einstellungen","article-category-integrationen-plugins","article-tag-add-on-funktion","article-tag-dam","article-tag-premium-pakete"],"translations":{"de":{"id":7755,"title":"Storyblok-Integrationsleitfaden","url":"https:\/\/helpdesk.kontainer.com\/de\/article\/storyblok-integrationsleitfaden\/"},"en":{"id":7754,"title":"Storyblok Integration Guide","url":"https:\/\/helpdesk.kontainer.com\/article\/storyblok-integration-guide\/"}},"_links":{"self":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7755","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\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/comments?post=7755"}],"version-history":[{"count":1,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7755\/revisions"}],"predecessor-version":[{"id":7758,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article\/7755\/revisions\/7758"}],"wp:attachment":[{"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/media?parent=7755"}],"wp:term":[{"taxonomy":"article-category","embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article-category?post=7755"},{"taxonomy":"article-tag","embeddable":true,"href":"https:\/\/helpdesk.kontainer.com\/de\/wp-json\/wp\/v2\/article-tag?post=7755"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}