In Ocoya, Framer è in beta. È basato sulla Server API di Framer, che Framer stesso definisce ancora beta, quindi le cose potrebbero cambiare quando cambia Framer.
Un canale Framer è una collezione CMS di un progetto Framer: il tuo Blog, un Journal, i Case Studies. Pubblica al suo interno e Ocoya aggiunge un nuovo elemento, con titolo, contenuto formattato, immagine di copertina e data già compilati. Poi, a meno che tu non abbia scelto di tenerlo come bozza, Ocoya pubblica il sito.
Framer può anche avviare un workflow: un nuovo elemento in una collezione può essere condiviso sui tuoi altri canali. Vedi Framer nei workflow più sotto.
Prima di iniziare
Framer non ha un accesso per le app. Ocoya usa invece la Server API di Framer, che si apre con una API key creata nelle impostazioni del progetto. Una chiave dà accesso a quel solo progetto: per collegare tre siti Framer, collega ciascuno con la propria chiave.
Devi poter aprire le Site Settings del progetto. La Server API di Framer è in beta.
Collega Framer
Crea una API key in Framer
Apri il progetto in Framer, poi Settings → General. Sotto API keys clicca Add e copia la chiave.
Copia l'indirizzo del progetto
Con il progetto aperto, copia l’indirizzo dal browser. Inizia con https://framer.com/projects/.
Scegli Framer in Ocoya
Seleziona Channels nella barra laterale sinistra, poi Connect channel, e scegli Framer sotto Blogging.
Incolla l'indirizzo e la chiave
Incollali in Project address e Framer API key, poi seleziona Connect Framer. Ocoya apre subito il progetto per verificare che la chiave funzioni.
Seleziona le collezioni da aggiungere
Vengono elencate tutte le collezioni del progetto, con il nome Project name · Each post becomes an item. Scegli quelle che vuoi come canali per questo brand. Se ce n’è una sola, viene aggiunta senza chiedere.
Una collezione che un plugin di Framer mantiene sincronizzata (per esempio da Google Sheets o Notion) viene elencata ma non può essere scelta: A plugin manages this collection, so posts cannot be added to it. Framer permette di scriverci solo a quel plugin.
Per sostituire la chiave, collega di nuovo Framer con lo stesso indirizzo del progetto e la nuova chiave. I tuoi canali continuano a funzionare.
Come appaiono i post
| Parte del tuo post | Dove va in Framer |
|---|---|
| Titolo | Il campo su cui si basa lo slug della collezione, di solito Title, fino a 256 caratteri. Senza titolo, viene usata la prima riga del testo |
| Titolo | Lo Slug, in lettere minuscole, numeri e trattini. Se uno slug è già usato nella collezione, ottiene -2, -3 e così via |
| Testo | Un campo Formatted Text chiamato Content, Body o simile; altrimenti il primo campo Formatted Text |
| Prima immagine | Un campo Image chiamato Image, Cover, Thumbnail o simile; altrimenti il primo campo Image. Viene usata solo la prima immagine |
| Riepilogo | Un campo di testo chiamato Summary, Excerpt o Subtitle riceve l’estratto dell’articolo, oppure i primi 160 caratteri del testo |
| Data | Un campo Date chiamato Date, Published o simile viene impostato sul momento in cui è stato pubblicato il post |
Se la prima riga del testo ripete il titolo, viene tolta dal corpo. I link che hai aggiunto al post e che non sono già nel testo vanno in fondo. Il Markdown (titoli, elenchi, citazioni, grassetto, link) arriva come vero testo formattato, e il testo alternativo delle immagini viene passato a Framer, che conserva una propria copia dell’immagine.
Tutti gli altri campi vengono lasciati intatti.
Cosa fa la pubblicazione live
I post dall’editor dei post vengono pubblicati live: Ocoya aggiunge l’elemento, poi pubblica il progetto e lo distribuisce sul tuo dominio personalizzato.
Framer pubblica un progetto nel suo insieme. Qualsiasi altra modifica non pubblicata nel progetto va online insieme all’articolo: una pagina a metà, un restyling in corso. Se qualcuno sta lavorando al sito, usa invece un workflow con Keep as draft.
Se Framer è brevemente non disponibile, Ocoya riprova alcune volte nel minuto successivo. Se ancora non riesce a pubblicare, il nuovo elemento viene rimosso e il post fallisce, così un post fallito non lascia mai un elemento orfano nella tua collezione.
In un workflow, il passaggio Publish to Framer CMS ti permette di scegliere sotto In Framer:
| Impostazione | Cosa succede |
|---|---|
| Publish live (predefinito) | L’elemento viene aggiunto e il sito viene pubblicato |
| Keep as draft | L’elemento viene aggiunto come bozza. Framer esclude le bozze da ogni pubblicazione finché qualcuno non le modifica |
Questo è diverso dall’interruttore Save as draft del passaggio, che tiene il post nel planner di Ocoya senza inviarlo affatto a Framer.
Un post pubblicato rimanda alla sua pagina sul tuo sito, usando il percorso della pagina CMS della collezione in Framer, come /blog/your-post. Se nessuna pagina mostra la collezione, o l’elemento è una bozza, rimanda invece all’elemento in Framer.
Non serve avere Framer aperto per niente di tutto questo. Ocoya comunica direttamente con i server di Framer.
Cosa puoi pubblicare
| Tipo di post | Supportato |
|---|---|
| Testo | Sì |
| Immagini | Sì: la prima diventa la copertina. Le collezioni Framer contengono una sola immagine per campo Image |
| GIF | Sì, come immagine |
| Video | No |
Un post ha bisogno di testo o di un’immagine.
I limiti di Framer
| Limite | |
|---|---|
| Testo del post | 100.000 caratteri |
| Titolo | 256 caratteri |
| Immagini | 1 usata per post |
| Hashtag | Nessun limite. Framer li mostra come testo semplice |
Eliminare un post
Eliminare in Ocoya un post pubblicato rimuove l’elemento dalla collezione. Ocoya non pubblica il sito quando elimini, così il lavoro non finito di qualcuno non va online per questo motivo: l’elemento sparisce dal tuo sito live alla prossima pubblicazione del progetto. Gli elementi creati dal tuo team non vengono mai toccati.
Framer nei workflow
Framer funziona a entrambe le estremità di un workflow.
Publish to Framer CMS è un’azione. Scegli la collezione, un Title (da cui si ricava lo slug), la didascalia e In Framer: Publish live o Keep as draft.
New item in a Framer collection è un trigger. Scegli un canale di tipo collezione e il workflow parte una volta per ogni nuovo elemento.
| Impostazione | Cosa fa |
|---|---|
| Collection | La collezione da monitorare. Deve essere già collegata come canale |
| Only when | Facoltativo. Un nome di campo e un valore, per esempio Category e News. Il workflow parte allora quando un elemento raggiunge quel valore (bozze incluse), invece che quando viene aggiunto |
Come si comporta il trigger:
- Ocoya controlla ogni 15 minuti. Framer non avvisa le app dei cambiamenti, quindi un nuovo elemento può impiegare fino a 15 minuti per avviare la sua esecuzione.
- Le bozze vengono saltate. Senza Only when, un elemento viene eseguito una volta che è nella collezione e non è una bozza.
- Non conta nulla di precedente all’attivazione del workflow. Gli elementi già presenti nella collezione vengono lasciati stare, e un elemento conta dal momento in cui è stato creato.
- Ogni elemento viene eseguito una sola volta. Modificarlo in seguito non lo pubblica di nuovo.
- Al massimo 10 elementi per controllo, dal più vecchio.
Ogni campo dell’elemento è disponibile per i passaggi successivi al trigger, scritto in minuscolo con i trattini bassi: un campo chiamato Cover Image diventa {{trigger.cover_image}}. Puoi usare anche:
| Valore | Cosa contiene |
|---|---|
{{trigger.title}} | Il campo titolo, altrimenti lo slug |
{{trigger.url}} | La pagina dell’elemento sul tuo sito. Vuoto per una bozza, o quando nessuna pagina mostra la collezione |
{{trigger.text}} | Il campo riepilogo, altrimenti il contenuto come testo semplice, altrimenti il titolo |
{{trigger.image}} | La prima immagine. {{trigger.images}} le contiene tutte |
Il testo formattato arriva come testo semplice, le opzioni con i loro nomi e i riferimenti come ID degli elementi. Se lasci vuoti la didascalia o i contenuti multimediali di un passaggio Post to successivo, userà {{trigger.text}} e le immagini dell’elemento.
Scollegare
Scollegare un canale Framer in Ocoya impedisce a Ocoya di pubblicarvi. Gli elementi già aggiunti restano nella tua collezione.
Per tagliare del tutto l’accesso di Ocoya, elimina la sua API key nelle Site Settings → General del progetto. Ogni canale Framer di quel progetto mostrerà allora Reconnect needed alla successiva pubblicazione.
Problemi comuni
“Framer no longer accepts this API key.” La chiave è stata eliminata, oppure appartiene a un altro progetto. Crea una nuova chiave nelle Site Settings del progetto e collega di nuovo Framer con quella.
“Paste the project’s address from your browser…” L’indirizzo del progetto deve iniziare con https://framer.com/projects/. Copialo dalla barra degli indirizzi del browser con il progetto aperto.
“Framer would not publish the site (…), so the item was not added.” Framer ha rifiutato di pubblicare anche dopo che Ocoya ha riprovato. Nella collezione non è rimasto nulla. Riprova più tardi.
“A plugin manages the Framer collection …” Quella collezione è sincronizzata da un plugin. Pubblica in una collezione che gestisci tu.
“The Framer collection … has no formatted text field for the post.” Aggiungi un campo Formatted Text alla collezione in Framer.
“Framer is busy” / “Framer took too long to answer.” I server di Framer sono stati lenti ad aprire il progetto. Riprova tra un minuto.
“Too many sessions are open with this Framer API key.” Più post o workflow hanno raggiunto il progetto contemporaneamente. Riprova tra un minuto.