Med Kontainers Storyblok-integration kan jeres redaktører vælge billeder, videoer og filer direkte fra jeres DAM uden at uploade filer til Storyblok. Storyblok gemmer kun en reference til filen. Selve filen bliver i Kontainer og leveres via CDN.

Gå til Kontainers integrationsside for at høre mere om anvendelser, fordele med mere.

Krav

  • Et Storyblok-space og administratorrettigheder til det – udvidelsen kan ikke installeres uden dem
  • En Kontainer-konto (https://yourcompany.kontainer.com)
  • Storyblok-integrationen slået til på jeres Kontainer-konto – bekræft med jeres kontaktperson, at den er med i jeres abonnement

Hvad gemmes hvor?

Jeres filer bliver i Kontainer. Der uploades intet til Storybloks mediebibliotek. Storyblok gemmer en almindelig filværdi, der peger på Kontainers CDN, med Kontainer-referencen gemt ved siden af:

  • filename – CDN-URL'en, inklusive den downloadskabelon, I valgte
  • alt, title – hentet fra filens beskrivelse i Kontainer
  • focus – det fokuspunkt, I angav i Kontainer, i Storybloks eget format
  • meta_data.kontainer_file_id, kontainer_folder_id, kontainer_url – identifikatorer til at hente filen
  • meta_data.kontainer_thumbnail_url, kontainer_extension, kontainer_type

Fordi alt-teksten og fokuspunktet følger med referencen, behøver redaktørerne ikke skrive metadata igen i Storyblok, og når en fil udskiftes i Kontainer, opdateres den overalt, hvor den bruges.

Kom i gang

1. Slå integrationen til i Kontainer

Bed jeres kontaktperson om at slå Storyblok-integrationen til for jeres Kontainer-konto. Det lader Storyblok indlejre Kontainers filvælger og er påkrævet, før vælgeren kan åbne.

2. Installér udvidelsen i Storyblok

Åbn installationslinket, vælg det space, I vil installere i, og bekræft:

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

I skal have administratorrettigheder til det space, I installerer i. Installér det én gang pr. space.

3. Tilføj Kontainer-feltet til en blok

I jeres space går I til Block Library, åbner den blok, I vil have vælgeren i, og tilføjer et nyt felt. Sæt dets type til Plugin, og vælg kontainer på listen.

4. Peg feltet på jeres Kontainer

Når feltet er valgt, tilføjer I muligheden kontainerHost og sætter den til jeres Kontainer-domæne, fx yourcompany.kontainer.com (med eller uden https://).

Storyblok gemmer pluginindstillinger pr. felt, så gentag det på hvert felt, der bruger vælgeren. Storyblok overfører ikke indstillingsværdier mellem spaces, så hvert space konfigureres for sig.

5. Vælg filer

Åbn en story, der bruger blokken, og klik på Select from Kontainer på feltet. Første gang logger I ind med jeres almindelige Kontainer-brugernavn og -adgangskode. Gennemse, søg og filtrér jeres bibliotek som sædvanligt, anvend eventuelt en downloadskabelon (beskæring, ændring af størrelse, format), og vælg filen.

Feltet viser så en forhåndsvisning og filnavnet. Replace asset vælger en anden fil, og Remove asset rydder feltet. Filer, der ikke er billeder, som PDF'er og video, viser et filkort med filtypen i stedet for et forhåndsvisningsbillede.

Feltindstillinger

Indstilling Påkrævet Værdi
kontainerHost Ja Jeres Kontainer-domæne, fx yourcompany.kontainer.com
mode Nej external (standard) linker til filen i Kontainer. import kopierer den ind i Storybloks mediebibliotek.
storyblokRegion Kun ved import eu (standard), us, ca, ap eller cn
storyblokManagementToken Kun ved import Et personligt adgangstoken fra Storyblok med skriveadgang til filer
maxImportMb Nej Den største fil, importen accepterer, standard 50

Valgfrit: importér filer til Storyblok

Nogle teams kræver, at alle filer hostes af Storyblok selv. Sætter I mode til import, kopieres filen ind i spacets eget mediebibliotek i stedet for at blive linket. Filen er så en almindelig Storyblok-fil, som Storyblok image service kan transformere.

To ting, I skal huske, før I sætter et felt til importtilstand:

  • Kopien opdateres ikke længere, når filen ændres i Kontainer.
  • Management-tokenet er en feltindstilling, hvilket betyder, at det leveres til browseren hos hver redaktør, der bruger det felt. Opret et afgrænset token til det: I Storyblok giver I det kun scopet Assets, begrænset til det ene space, der har brug for det. Genbrug ikke et token, der har adgang til hele jeres konto.

Brug filen i jeres frontend

Feltet returnerer et almindeligt Storyblok-filobjekt, så det opfører sig som ethvert andet filfelt:

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

Hent filen fra filename – den leveres fra Kontainers CDN.

Storyblok image service ændrer ikke størrelsen på eller beskærer en ekstern URL, så brug Kontainers egne transformationsparametre eller en downloadskabelon valgt ved udvælgelsen til at styre den leverede størrelse og det leverede format. Fokuspunktet er tilgængeligt både som Storyblok-værdien focus og som rå pixelkoordinater i meta_data.

Support

Har I brug for hjælp til at sætte Storyblok-pluginet op eller konfigurere det, hjælper vores supportteam gerne.

Kontakt: support@kontainer.com