Connettore Storyblok: configurazione e utilizzo
Collega THRON a Storyblok e consenti ai content editor di selezionare asset direttamente dai campi personalizzati del CMS headless, senza mai uscire dall'editor. I contenuti vengono distribuiti tramite le API di THRON Content Delivery e si aggiornano automaticamente ad ogni modifica in piattaforma.
Attenzione: la configurazione del connettore Storyblok richiede un passaggio tecnico di deploy. Contatta il supporto tecnico (support@thron.com)
Prerequisiti
Accesso amministratore all'account Storyblok della tua organization
Accesso alla THRON Admin Console per creare le app necessarie — richiede il supporto del team THRON
Storyblok CLI installata nell'ambiente di sviluppo
Personal Access Token Storyblok (generabile da My account → Personal access token)
Fase 1 — Crea la cartella e la Custom Application su THRON
In THRON, crea una nuova cartella che conterrà tutti gli asset da rendere disponibili in Drupal (es.
/channels/website).Collega la cartella a una THRON Custom Application (App SDK). Se non l’hai ancora creata puoi farlo seguendo questa guida.
-
Una volta generata l'app, salva il seguente valore:
pkey
## Articoli di approfondimento
- Guida alla creazione e configurazione di una Custom Application
Fase 2 — Installa il plugin nella tua organization Storyblok
Richiedi il pacchetto del plugin THRON per Storyblok al supporto THRON — include un file ZIP con il codice sorgente e un README.md con le istruzioni complete.
Segui il README per avviare il progetto in locale e verificare le variabili richieste.
-
Imposta la variabile d'ambiente obbligatoria:
STORYBLOK_PERSONAL_ACCESS_TOKEN— generala da My account → Personal access token in Storyblok
Esegui il deploy tramite la Storyblok CLI seguendo i passaggi indicati nel README.
Fase 3 — Configura il plugin nello spazio Storyblok
Una volta completato il deploy, accedi al tuo spazio Storyblok.
Il plugin THRON è ora disponibile come custom field plugin da associare ai componenti (es. Image, Media, Video).
Vai in Datasources, cerca il plug-in e configura il campo con la pKey, il Client ID e il Client Secret raccolti nelle fasi precedenti e da THRON, il client e lo username del tuo account di THRON.
Salva la configurazione del componente.
Configurazione Consigliata
Parametro |
Valore consigliato |
|---|---|
Cartella sorgente |
Cartella dedicata al canale web (es. |
Utente app esterna |
Utente dedicato con accesso solo alla cartella sorgente |
Ruolo minimo |
|
Tipi di contenuto abilitati |
Image, Video, Audio, Document — abilita solo quelli in uso per ridurre il rumore in ricerca |
Risultato finale
Una volta completata la configurazione, il plugin THRON appare come campo nativo all'interno dei componenti Storyblok. I content editor selezionano gli asset direttamente dalla cartella THRON, con ricerca testuale, filtro per locale e filtro per tipo di contenuto. L'asset selezionato restituisce un oggetto JSON con i dati necessari al frontend per generare le chiamate alle API di THRON Content Delivery e distribuire il contenuto sul sito.
Serve aiuto?
Per domande sull'attivazione o per problemi tecnici, scrivi a support@thron.com.