O Framer está em beta no Ocoya. Baseia-se na Server API do Framer, que o próprio Framer ainda considera beta, pelo que as coisas podem mudar à medida que o Framer a alterar.
Um canal do Framer é uma coleção do CMS num projeto do Framer — o seu Blog, um Journal, Case Studies. Publique nela e o Ocoya adiciona um novo item: com o título, o conteúdo formatado, a imagem de capa e a data preenchidos. Depois, a menos que tenha escolhido mantê-lo como rascunho, o Ocoya publica o site.
O Framer também pode iniciar um workflow: um item novo numa coleção pode ser partilhado nos seus outros canais. Consulte Framer em workflows mais abaixo.
Antes de começar
O Framer não tem início de sessão para aplicações. Em vez disso, o Ocoya usa a Server API do Framer, que se abre com uma API key criada nas definições do próprio projeto. Uma chave dá acesso a esse projeto apenas — para ligar três sites do Framer, ligue cada um com a sua própria chave.
Precisa de conseguir abrir as Site Settings do projeto. A Server API do Framer está em beta.
Ligar o Framer
Crie uma API key no Framer
Abra o projeto no Framer e depois Settings → General. Em API keys, clique em Add e copie a chave.
Copie o endereço do projeto
Com o projeto aberto, copie o endereço do seu navegador. Começa por https://framer.com/projects/.
Escolha o Framer no Ocoya
Selecione Channels na barra lateral esquerda e depois Connect channel, e escolha Framer em Blogging.
Cole o endereço e a chave
Cole-os em Project address e Framer API key e selecione Connect Framer. O Ocoya abre o projeto de imediato para verificar se a chave funciona.
Selecione as coleções a adicionar
Todas as coleções do projeto são listadas, com o nome Project name · Each post becomes an item. Escolha as que quer como canais para esta marca. Se houver só uma, é adicionada sem perguntar.
Uma coleção que um plugin do Framer mantém sincronizada — a partir do Google Sheets ou do Notion, por exemplo — é listada, mas não pode ser escolhida: A plugin manages this collection, so posts cannot be added to it. O Framer só permite que esse plugin escreva nela.
Para substituir a chave, volte a ligar o Framer com o mesmo endereço de projeto e a nova chave. Os seus canais continuam a funcionar.
Como as publicações aparecem
| Parte da sua publicação | Onde fica no Framer |
|---|---|
| Título | O campo em que o slug da coleção se baseia — normalmente Title — até 256 carateres. Sem título, é usada a primeira linha do texto |
| Título | O Slug, em letras minúsculas, números e hífenes. Um slug já usado na coleção recebe -2, -3 e assim por diante |
| Texto | Um campo Formatted Text chamado Content, Body ou semelhante — caso contrário, o primeiro campo Formatted Text |
| Primeira imagem | Um campo Image chamado Image, Cover, Thumbnail ou semelhante — caso contrário, o primeiro campo Image. Só é usada a primeira imagem |
| Resumo | Um campo de texto chamado Summary, Excerpt ou Subtitle recebe o excerto do artigo, ou os primeiros 160 carateres do texto |
| Data | Um campo Date chamado Date, Published ou semelhante é definido para o momento em que foi publicado |
Se a primeira linha do texto repetir o título, é deixada de fora do corpo. As ligações que adicionou à publicação e que ainda não estão no texto vão para o fim. O Markdown — títulos, listas, citações, negrito, ligações — chega como texto formatado a sério, e o texto alternativo das imagens é passado ao Framer, que mantém a sua própria cópia da imagem.
Todos os outros campos ficam como estão.
O que a publicação em direto faz
As publicações feitas a partir do editor de publicações são publicadas em direto: o Ocoya adiciona o item, depois publica o projeto e implementa-o no seu domínio personalizado.
O Framer publica um projeto como um todo. Quaisquer outras alterações por publicar no projeto entram em direto com o artigo — uma página a meio, um redesenho em curso. Se alguém estiver a trabalhar no site, use antes um workflow com Keep as draft.
Se o Framer estiver brevemente indisponível, o Ocoya tenta novamente algumas vezes ao longo do minuto seguinte. Se continuar a não conseguir publicar, o novo item é removido e a publicação falha, para que uma publicação falhada nunca deixe um item perdido na sua coleção.
Num workflow, o passo Publish to Framer CMS permite escolher, em In Framer:
| Definição | O que acontece |
|---|---|
| Publish live (predefinição) | O item é adicionado e o site é publicado |
| Keep as draft | O item é adicionado como rascunho. O Framer deixa os rascunhos fora de todas as publicações até alguém o alterar |
Isto é independente do interruptor Save as draft do passo, que mantém a publicação no seu planner do Ocoya sem a enviar de todo para o Framer.
Uma publicação publicada liga à sua página no seu site, usando o caminho da página de CMS da coleção no Framer, como /blog/your-post. Se nenhuma página mostrar a coleção, ou se o item for um rascunho, liga antes ao item no Framer.
Não precisa de ter o Framer aberto para nada disto. O Ocoya comunica diretamente com os servidores do Framer.
O que pode publicar
| Tipo de publicação | Suportado |
|---|---|
| Texto | Sim |
| Imagens | Sim — a primeira torna-se a capa. As coleções do Framer guardam uma imagem por campo Image |
| GIF | Sim, como imagem |
| Vídeo | Não |
Uma publicação precisa de texto ou de uma imagem.
Limites do Framer
| Limite | |
|---|---|
| Texto da publicação | 100 000 carateres |
| Título | 256 carateres |
| Imagens | 1 usada por publicação |
| Hashtags | Sem limite. O Framer mostra-as como texto simples |
Eliminar uma publicação
Eliminar uma publicação publicada no Ocoya remove o item da coleção. O Ocoya não publica o site quando elimina, para que o trabalho inacabado de ninguém entre em direto por causa disso — o item sai do seu site em direto na próxima vez que o projeto for publicado. Os itens criados pela sua equipa nunca são tocados.
Framer em workflows
O Framer funciona nas duas pontas de um workflow.
Publish to Framer CMS é uma ação. Escolha a coleção, um Title (o slug é feito a partir dele), a legenda e In Framer: Publish live ou Keep as draft.
New item in a Framer collection é um acionador. Escolha um canal de coleção e o workflow é executado uma vez por cada item novo.
| Definição | O que faz |
|---|---|
| Collection | A coleção a vigiar. Tem de estar ligada como canal primeiro |
| Only when | Opcional. Um nome de campo e um valor, como Category e News. O workflow é então executado quando um item atinge esse valor — rascunhos incluídos — em vez de quando é adicionado |
Como se comporta o acionador:
- O Ocoya verifica de 15 em 15 minutos. O Framer não notifica as aplicações das alterações, por isso um item novo pode demorar até 15 minutos a iniciar a sua execução.
- Os rascunhos são ignorados. Sem Only when, um item é executado assim que está na coleção e não é um rascunho.
- Nada anterior ao momento em que ativa o workflow conta. Os itens que já estão na coleção são deixados em paz, e um item conta a partir do momento em que foi criado.
- Cada item é executado uma vez. Editá-lo mais tarde não o publica de novo.
- São executados até 10 itens por verificação, do mais antigo para o mais recente.
Todos os campos do item ficam disponíveis para os passos depois do acionador, escritos em minúsculas e com sublinhados: um campo chamado Cover Image passa a {{trigger.cover_image}}. Pode também usar:
| Valor | O que contém |
|---|---|
{{trigger.title}} | O campo de título, caso contrário o slug |
{{trigger.url}} | A página do item no seu site. Vazio para um rascunho, ou quando nenhuma página mostra a coleção |
{{trigger.text}} | O campo de resumo, caso contrário o conteúdo como texto simples, caso contrário o título |
{{trigger.image}} | A primeira imagem. {{trigger.images}} contém todas |
O texto formatado chega como texto simples, as opções com os seus nomes e as referências como IDs de itens. Deixe vazia a legenda ou a multimédia de um passo Post to seguinte e este usa {{trigger.text}} e as imagens do item.
Desligar
Desligar um canal do Framer no Ocoya faz o Ocoya parar de publicar lá. Os itens que já adicionou ficam na sua coleção.
Para cortar totalmente o acesso do Ocoya, elimine a respetiva API key nas Site Settings → General do projeto. Todos os canais do Framer desse projeto mostram então Reconnect needed da próxima vez que publicarem.
Problemas comuns
“Framer no longer accepts this API key.” A chave foi eliminada ou pertence a outro projeto. Crie uma nova chave nas Site Settings do projeto e volte a ligar o Framer com ela.
“Paste the project’s address from your browser…” O endereço do projeto tem de começar por https://framer.com/projects/. Copie-o da barra de endereço do navegador com o projeto aberto.
“Framer would not publish the site (…), so the item was not added.” O Framer recusou publicar mesmo depois de o Ocoya tentar novamente. Nada ficou na coleção. Tente novamente mais tarde.
“A plugin manages the Framer collection …” Essa coleção é sincronizada por um plugin. Publique numa coleção que gere você mesmo.
“The Framer collection … has no formatted text field for the post.” Adicione um campo Formatted Text à coleção no Framer.
“Framer is busy” / “Framer took too long to answer.” Os servidores do Framer demoraram a abrir o projeto. Tente novamente dentro de um minuto.
“Too many sessions are open with this Framer API key.” Várias publicações ou workflows chegaram ao projeto ao mesmo tempo. Tente novamente dentro de um minuto.