Framer está en beta en Ocoya. Se basa en la Server API de Framer, que la propia Framer sigue llamando beta, así que las cosas pueden cambiar a medida que Framer la cambie.
Un canal de Framer es una colección del CMS de un proyecto de Framer: tu Blog, un Journal, Case Studies. Publica en ella y Ocoya añade un elemento nuevo con el título, el contenido con formato, la imagen de portada y la fecha ya rellenados. Después, a menos que hayas elegido dejarlo como borrador, Ocoya publica el sitio.
Framer también puede iniciar un workflow: un elemento nuevo de una colección se puede compartir en tus otros canales. Consulta Framer en workflows más abajo.
Antes de empezar
Framer no tiene inicio de sesión para aplicaciones. En su lugar, Ocoya usa la Server API de Framer, que se abre con una clave de API creada en los ajustes del propio proyecto. Una clave solo da acceso a ese proyecto: para conectar tres sitios de Framer, conecta cada uno con su propia clave.
Necesitas poder abrir los Site Settings del proyecto. La Server API de Framer está en beta.
Conectar Framer
Crea una clave de API en Framer
Abre el proyecto en Framer y ve a Settings → General. En API keys, haz clic en Add y copia la clave.
Copia la dirección del proyecto
Con el proyecto abierto, copia la dirección de tu navegador. Empieza por https://framer.com/projects/.
Elige Framer en Ocoya
Selecciona Channels en la barra lateral izquierda, luego Connect channel, y elige Framer en Blogging.
Pega la dirección y la clave
Pégalas en Project address y Framer API key, y selecciona Connect Framer. Ocoya abre el proyecto enseguida para comprobar que la clave funciona.
Selecciona las colecciones que quieres añadir
Se muestran todas las colecciones del proyecto, con el nombre Project name · Each post becomes an item. Elige las que quieras como canales para esta marca. Si solo hay una, se añade sin preguntar.
Una colección que un plugin de Framer mantiene sincronizada, por ejemplo desde Google Sheets o Notion, aparece en la lista pero no se puede elegir: A plugin manages this collection, so posts cannot be added to it. Framer solo permite que ese plugin escriba en ella.
Para cambiar la clave, vuelve a conectar Framer con la misma dirección de proyecto y la clave nueva. Tus canales siguen funcionando.
Cómo aparecen las publicaciones
| Parte de tu publicación | Dónde va en Framer |
|---|---|
| Título | El campo en el que se basa el slug de la colección, normalmente Title, hasta 256 caracteres. Si no hay título, se usa la primera línea de tu texto |
| Título | El Slug, en minúsculas, números y guiones. Si un slug ya se usa en la colección, recibe -2, -3, etc. |
| Texto | Un campo Formatted Text llamado Content, Body o similar; si no, el primer campo Formatted Text |
| Primera imagen | Un campo Image llamado Image, Cover, Thumbnail o similar; si no, el primer campo Image. Solo se usa la primera imagen |
| Resumen | Un campo de texto llamado Summary, Excerpt o Subtitle recibe el extracto del artículo o los primeros 160 caracteres del texto |
| Fecha | Un campo Date llamado Date, Published o similar se rellena con el momento de la publicación |
Si la primera línea del texto repite el título, se omite del cuerpo. Los enlaces que añadiste a la publicación y que no están ya en el texto van al final. El Markdown (encabezados, listas, citas, negrita, enlaces) llega como texto con formato real, y el texto alternativo de las imágenes se pasa a Framer, que conserva su propia copia de la imagen.
Cualquier otro campo se deja como está.
Qué hace la publicación en vivo
Las publicaciones del editor de publicaciones se publican en vivo: Ocoya añade el elemento, publica el proyecto y lo despliega en tu dominio personalizado.
Framer publica un proyecto como un todo. Cualquier otro cambio sin publicar del proyecto sale en vivo junto con el artículo: una página a medias, un rediseño en curso. Si alguien está trabajando en el sitio, usa un workflow con Keep as draft.
Si Framer no está disponible durante un momento, Ocoya lo reintenta varias veces durante el minuto siguiente. Si sigue sin poder publicar, el elemento nuevo se retira y la publicación falla, así que una publicación fallida nunca deja un elemento suelto en tu colección.
En un workflow, el paso Publish to Framer CMS te permite elegir en In Framer:
| Ajuste | Qué ocurre |
|---|---|
| Publish live (predeterminado) | Se añade el elemento y se publica el sitio |
| Keep as draft | El elemento se añade como borrador. Framer deja los borradores fuera de cada publicación hasta que alguien lo cambie |
Esto es independiente del interruptor Save as draft del paso, que mantiene la publicación en tu planner de Ocoya sin enviarla a Framer.
Una publicación publicada enlaza a su página en tu sitio, usando la ruta de la página CMS de la colección en Framer, como /blog/your-post. Si ninguna página muestra la colección, o el elemento es un borrador, enlaza al elemento en Framer.
No necesitas tener Framer abierto para nada de esto. Ocoya habla directamente con los servidores de Framer.
Qué puedes publicar
| Tipo de publicación | Compatible |
|---|---|
| Texto | Sí |
| Imágenes | Sí: la primera se convierte en la portada. Las colecciones de Framer admiten una imagen por campo Image |
| GIF | Sí, como imagen |
| Vídeo | No |
Una publicación necesita texto o una imagen.
Límites de Framer
| Límite | |
|---|---|
| Texto de la publicación | 100.000 caracteres |
| Título | 256 caracteres |
| Imágenes | 1 usada por publicación |
| Hashtags | Sin límite. Framer los muestra como texto normal |
Eliminar una publicación
Eliminar en Ocoya una publicación ya publicada quita el elemento de la colección. Ocoya no publica el sitio cuando eliminas, así que el trabajo sin terminar de nadie no sale en vivo por eso: el elemento desaparece de tu sitio en vivo la próxima vez que se publique el proyecto. Los elementos creados por tu equipo nunca se tocan.
Framer en workflows
Framer funciona en ambos extremos de un workflow.
Publish to Framer CMS es una acción. Elige la colección, un Title (el slug se genera a partir de él), el texto y In Framer: Publish live o Keep as draft.
New item in a Framer collection es un disparador. Elige un canal de colección y el workflow se ejecuta una vez por cada elemento nuevo.
| Ajuste | Qué hace |
|---|---|
| Collection | La colección que se vigila. Tiene que estar conectada antes como canal |
| Only when | Opcional. Un nombre de campo y un valor, como Category y News. Entonces el workflow se ejecuta cuando un elemento alcanza ese valor (incluidos los borradores) en lugar de cuando se añade |
Cómo se comporta el disparador:
- Ocoya comprueba cada 15 minutos. Framer no avisa a las aplicaciones de los cambios, así que un elemento nuevo puede tardar hasta 15 minutos en iniciar su ejecución.
- Los borradores se omiten. Sin Only when, un elemento se ejecuta en cuanto está en la colección y no es un borrador.
- No cuenta nada anterior a activar el workflow. Los elementos que ya están en la colección se dejan como están, y un elemento cuenta desde que se creó.
- Cada elemento se ejecuta una vez. Editarlo más tarde no lo vuelve a publicar.
- Se ejecutan hasta 10 elementos por comprobación, empezando por los más antiguos.
Todos los campos del elemento están disponibles para los pasos posteriores al disparador, escritos en minúsculas y con guiones bajos: un campo llamado Cover Image se convierte en {{trigger.cover_image}}. También puedes usar:
| Valor | Qué contiene |
|---|---|
{{trigger.title}} | El campo de título; si no, el slug |
{{trigger.url}} | La página del elemento en tu sitio. Vacío si es un borrador o si ninguna página muestra la colección |
{{trigger.text}} | El campo de resumen; si no, el contenido como texto sin formato; si no, el título |
{{trigger.image}} | La primera imagen. {{trigger.images}} las contiene todas |
El texto con formato llega como texto sin formato, las opciones como sus nombres y las referencias como ID de elemento. Si dejas vacío el texto o el contenido multimedia de un paso Post to posterior, usa {{trigger.text}} y las imágenes del elemento.
Desconectar
Desconectar un canal de Framer en Ocoya hace que Ocoya deje de publicar allí. Los elementos que ya añadió se quedan en tu colección.
Para cortar por completo el acceso de Ocoya, elimina su clave de API en Site Settings → General del proyecto. Entonces todos los canales de Framer de ese proyecto mostrarán Reconnect needed la próxima vez que publiquen.
Problemas habituales
“Framer no longer accepts this API key.” La clave se eliminó o pertenece a otro proyecto. Crea una clave nueva en los Site Settings del proyecto y vuelve a conectar Framer con ella.
“Paste the project’s address from your browser…” La dirección del proyecto debe empezar por https://framer.com/projects/. Cópiala de la barra de direcciones del navegador con el proyecto abierto.
“Framer would not publish the site (…), so the item was not added.” Framer se negó a publicar incluso después de que Ocoya lo reintentara. No quedó nada en la colección. Inténtalo de nuevo más tarde.
“A plugin manages the Framer collection …” Esa colección la sincroniza un plugin. Publica en una colección que gestiones tú.
“The Framer collection … has no formatted text field for the post.” Añade un campo Formatted Text a la colección en Framer.
“Framer is busy” / “Framer took too long to answer.” Los servidores de Framer tardaron en abrir el proyecto. Inténtalo de nuevo en un minuto.
“Too many sessions are open with this Framer API key.” Varias publicaciones o workflows llegaron al proyecto a la vez. Inténtalo de nuevo en un minuto.