Med Kontainers integration för Storyblok kan era redaktörer välja bilder, videor och filer direkt från ert DAM utan att ladda upp filer till Storyblok. Storyblok sparar bara en referens till filen – själva filen stannar i Kontainer och levereras via CDN.

Gå till Kontainers integrationssida för att läsa mer om användningsområden, fördelar med mera.

Krav

  • Ett Storyblok-space och administratörsrättigheter till det – tillägget kan inte installeras utan dem
  • Ett Kontainer-konto (https://yourcompany.kontainer.com)
  • Integrationen för Storyblok aktiverad på ert Kontainer-konto – kontrollera med er kontoansvarige att den ingår i ert paket

Vad sparas var?

Era filer stannar i Kontainer. Inget laddas upp till Storybloks filbibliotek. Storyblok sparar ett vanligt tillgångsvärde som pekar på Kontainers CDN, tillsammans med Kontainer-referensen:

  • filename – CDN-URL:en, inklusive den nedladdningsmall ni valde
  • alt, title – hämtas från filens beskrivning i Kontainer
  • focus – den fokuspunkt ni har angett i Kontainer, i Storybloks eget format
  • meta_data.kontainer_file_id, kontainer_folder_id, kontainer_url – identifierare för att hämta filen
  • meta_data.kontainer_thumbnail_url, kontainer_extension, kontainer_type

Eftersom alt-text och fokuspunkt följer med referensen behöver redaktörerna inte skriva in metadata på nytt i Storyblok, och om en fil byts ut i Kontainer uppdateras den överallt där den används.

Kom i gång

1. Aktivera integrationen i Kontainer

Be er kontoansvarige att aktivera integrationen för Storyblok på ert Kontainer-konto. Det gör att Storyblok kan bädda in Kontainers filväljare, och det krävs innan väljaren kan öppnas.

2. Installera tillägget i Storyblok

Öppna installationslänken, välj det space som tillägget ska installeras i och bekräfta:

https://app.storyblok.com/#/install/kontainer@asset-picker

Ni behöver administratörsrättigheter till målspacet. Installera en gång per space.

3. Lägg till Kontainer-fältet i ett block

Gå till Block Library i ert space, öppna det block där väljaren ska finnas och lägg till ett nytt fält. Ange typen Plugin och välj kontainer i listan.

4. Peka fältet mot ert Kontainer-konto

Med fältet markerat lägger ni till alternativet kontainerHost och anger er Kontainer-domän, till exempel yourcompany.kontainer.com (med eller utan https://).

Storyblok sparar pluginalternativ per fält, så upprepa detta för varje fält som använder väljaren. Storyblok för inte över värden mellan olika spaces, så varje space konfigureras för sig.

5. Välj filer

Öppna en story som använder blocket och klicka på Select from Kontainer i fältet. Första gången loggar ni in med ert vanliga användarnamn och lösenord för Kontainer. Bläddra, sök och filtrera i biblioteket som vanligt, använd vid behov en nedladdningsmall (beskärning, storlek, format) och välj filen.

Fältet visar sedan en förhandsvisning och filnamnet. Med Replace asset väljer ni en annan fil och med Remove asset tömmer ni fältet. Filer som inte är bilder, till exempel PDF:er och videor, visas som ett filkort med filtypen i stället för en förhandsvisning.

Fältalternativ

Alternativ Obligatoriskt Värde
kontainerHost Ja Er Kontainer-domän, t.ex. yourcompany.kontainer.com
mode Nej external (standard) länkar filen i Kontainer. import kopierar den till Storybloks filbibliotek.
storyblokRegion Bara vid import eu (standard), us, ca, ap eller cn
storyblokManagementToken Bara vid import En personlig åtkomsttoken för Storyblok med skrivrättighet till filer
maxImportMb Nej Största fil som importen accepterar, standard 50

Valfritt: importera filer till Storyblok

Vissa team kräver att alla filer lagras i Storyblok. Om ni anger mode till import kopieras filen till spacets eget filbibliotek i stället för att länkas. Filen blir då en vanlig Storyblok-fil, och Storybloks bildtjänst kan bearbeta den.

Två saker att tänka på innan ni byter ett fält till importläge:

  • Kopian uppdateras inte längre när filen ändras i Kontainer.
  • Management-token är ett fältalternativ, vilket betyder att den skickas till webbläsaren hos alla redaktörer som använder fältet. Skapa en avgränsad token för det: ge den i Storyblok bara behörigheten Assets, begränsad till det space som behöver den. Återanvänd inte en token som har åtkomst till hela ert konto.

Använd filen i er frontend

Fältet returnerar ett vanligt tillgångsobjekt från Storyblok, så det fungerar som alla andra filfält:

const { filename, alt, focus } = story.content.hero;

Hämta filen från filename – den levereras från Kontainers CDN.

Storybloks bildtjänst ändrar inte storlek på eller beskär externa URL:er, så använd Kontainers egna transformationsparametrar, eller en nedladdningsmall som väljs när filen väljs, för att styra storlek och format. Fokuspunkten finns både som Storybloks focus-värde och som pixelkoordinater i meta_data.

Support

Om ni behöver hjälp med att sätta upp eller konfigurera pluginet för Storyblok hjälper vår support gärna till.

Kontakta: support@kontainer.com