Framer ist in Ocoya in der Beta. Die Anbindung basiert auf der Server API von Framer, die Framer selbst noch als Beta bezeichnet. Dinge können sich also ändern, wenn Framer sie ändert.
Ein Framer-Channel ist eine CMS collection in einem Framer-Projekt – dein Blog, ein Journal, Case Studies. Wenn du dorthin postest, legt Ocoya einen neuen Eintrag an: mit Titel, formatiertem Inhalt, Titelbild und Datum. Danach veröffentlicht Ocoya die Website, es sei denn, du hast dich für einen Entwurf entschieden.
Framer kann auch einen Workflow starten: Ein neuer Eintrag in einer Collection kann auf deinen anderen Channels geteilt werden. Siehe Framer in Workflows weiter unten.
Bevor du loslegst
Framer hat keine Anmeldung für Apps. Stattdessen nutzt Ocoya die Server API von Framer, die mit einem API key geöffnet wird, den du in den Einstellungen des Projekts erstellst. Ein Key gilt nur für dieses eine Projekt – um drei Framer-Websites zu verbinden, verbindest du jede mit ihrem eigenen Key.
Du musst die Site Settings des Projekts öffnen können. Die Server API von Framer ist in der Beta.
Framer verbinden
API-Key in Framer erstellen
Öffne das Projekt in Framer und dann Settings → General. Klicke unter API keys auf Add und kopiere den Key.
Adresse des Projekts kopieren
Kopiere bei geöffnetem Projekt die Adresse aus deinem Browser. Sie beginnt mit https://framer.com/projects/.
Framer in Ocoya auswählen
Wähle in der linken Seitenleiste Channels, dann Connect channel und wähle unter Blogging Framer.
Adresse und Key einfügen
Füge sie in Project address und Framer API key ein und wähle dann Connect Framer. Ocoya öffnet das Projekt sofort, um zu prüfen, ob der Key funktioniert.
Collections zum Hinzufügen auswählen
Jede Collection im Projekt wird aufgelistet, benannt als Project name · Each post becomes an item. Wähle die aus, die du als Channels für diese Marke haben möchtest. Gibt es nur eine, wird sie ohne Rückfrage hinzugefügt.
Eine Collection, die ein Framer-Plugin synchron hält – etwa aus Google Sheets oder Notion –, wird aufgelistet, lässt sich aber nicht auswählen: A plugin manages this collection, so posts cannot be added to it. Framer erlaubt nur diesem Plugin, darauf zu schreiben.
Um den Key zu ersetzen, verbinde Framer erneut mit derselben Projektadresse und dem neuen Key. Deine Channels funktionieren weiter.
So erscheinen Posts
| Teil deines Posts | Wohin er in Framer kommt |
|---|---|
| Titel | Das Feld, auf dem der Slug der Collection basiert – meist Title – bis zu 256 Zeichen. Ohne Titel wird die erste Textzeile verwendet |
| Titel | Der Slug, in Kleinbuchstaben, Ziffern und Bindestrichen. Ein Slug, der in der Collection schon vergeben ist, bekommt -2, -3 und so weiter |
| Text | Ein Formatted Text-Feld mit dem Namen Content, Body o. Ä. – sonst das erste Formatted-Text-Feld |
| Erstes Bild | Ein Image-Feld mit dem Namen Image, Cover, Thumbnail o. Ä. – sonst das erste Image-Feld. Es wird nur das erste Bild verwendet |
| Zusammenfassung | Ein Textfeld mit dem Namen Summary, Excerpt oder Subtitle erhält den Auszug des Artikels oder die ersten 160 Zeichen des Texts |
| Datum | Ein Date-Feld mit dem Namen Date, Published o. Ä. wird auf den Zeitpunkt des Postens gesetzt |
Wenn die erste Zeile des Texts den Titel wiederholt, wird sie im Textkörper weggelassen. Links, die du dem Post hinzugefügt hast und die nicht bereits im Text stehen, kommen ans Ende. Markdown – Überschriften, Listen, Zitate, Fett, Links – kommt als echter formatierter Text an, und der Alt-Text von Bildern wird an Framer übergeben, das eine eigene Kopie des Bilds behält.
Alle anderen Felder bleiben unberührt.
Was Live-Veröffentlichen bewirkt
Posts aus dem Post-Editor werden live veröffentlicht: Ocoya legt den Eintrag an, veröffentlicht dann das Projekt und stellt es auf deiner eigenen Domain bereit.
Framer veröffentlicht ein Projekt als Ganzes. Alle anderen unveröffentlichten Änderungen im Projekt gehen zusammen mit dem Artikel live – eine halbfertige Seite, ein Redesign in Arbeit. Wenn gerade jemand an der Website arbeitet, nutze stattdessen einen Workflow mit Keep as draft.
Wenn Framer kurzzeitig nicht erreichbar ist, versucht Ocoya es in der nächsten Minute noch einige Male. Gelingt das Veröffentlichen trotzdem nicht, wird der neue Eintrag wieder entfernt und der Post schlägt fehl, sodass ein fehlgeschlagener Post nie einen verwaisten Eintrag in deiner Collection hinterlässt.
In einem Workflow kannst du im Schritt Publish to Framer CMS unter In Framer auswählen:
| Einstellung | Was passiert |
|---|---|
| Publish live (Standard) | Der Eintrag wird angelegt und die Website veröffentlicht |
| Keep as draft | Der Eintrag wird als Entwurf angelegt. Framer lässt Entwürfe bei jeder Veröffentlichung weg, bis jemand das ändert |
Das ist getrennt vom Schalter Save as draft des Schritts, der den Post in deinem Ocoya-Planner behält, ohne ihn überhaupt an Framer zu senden.
Ein veröffentlichter Post verlinkt auf seine Seite auf deiner Website, und zwar über den Pfad der CMS-Seite der Collection in Framer, etwa /blog/your-post. Zeigt keine Seite die Collection oder ist der Eintrag ein Entwurf, verlinkt er stattdessen auf den Eintrag in Framer.
Du musst Framer dafür nicht geöffnet haben. Ocoya spricht direkt mit den Servern von Framer.
Was du posten kannst
| Post-Typ | Unterstützt |
|---|---|
| Text | Ja |
| Bilder | Ja – das erste wird zum Titelbild. Framer-Collections enthalten ein Bild pro Image-Feld |
| GIF | Ja, als Bild |
| Video | Nein |
Ein Post braucht Text oder ein Bild.
Die Limits von Framer
| Limit | |
|---|---|
| Posttext | 100.000 Zeichen |
| Titel | 256 Zeichen |
| Bilder | 1 pro Post verwendet |
| Hashtags | Kein Limit. Framer zeigt sie als einfachen Text |
Einen Post löschen
Wenn du einen veröffentlichten Post in Ocoya löschst, wird der Eintrag aus der Collection entfernt. Ocoya veröffentlicht die Website beim Löschen nicht, damit dadurch keine unfertige Arbeit anderer live geht – der Eintrag verschwindet von deiner Live-Website, sobald das Projekt das nächste Mal veröffentlicht wird. Einträge, die dein Team angelegt hat, werden nie angetastet.
Framer in Workflows
Framer funktioniert an beiden Enden eines Workflows.
Publish to Framer CMS ist eine Aktion. Wähle die Collection, einen Title (daraus wird der Slug gebildet), die Beschreibung und In Framer: Publish live oder Keep as draft.
New item in a Framer collection ist ein Trigger. Wähle einen Collection-Channel, und der Workflow läuft einmal für jeden neuen Eintrag.
| Einstellung | Was sie bewirkt |
|---|---|
| Collection | Die zu überwachende Collection. Sie muss zuerst als Channel verbunden sein |
| Only when | Optional. Ein Feldname und ein Wert, etwa Category und News. Der Workflow läuft dann, wenn ein Eintrag diesen Wert erreicht – Entwürfe eingeschlossen –, statt wenn er hinzugefügt wird |
So verhält sich der Trigger:
- Ocoya prüft alle 15 Minuten. Framer benachrichtigt Apps nicht über Änderungen, deshalb kann es bis zu 15 Minuten dauern, bis ein neuer Eintrag seinen Lauf startet.
- Entwürfe werden übersprungen. Ohne Only when läuft ein Eintrag, sobald er in der Collection ist und kein Entwurf mehr ist.
- Nichts aus der Zeit vor dem Einschalten des Workflows zählt. Einträge, die bereits in der Collection sind, bleiben unberührt, und ein Eintrag zählt ab dem Zeitpunkt seiner Erstellung.
- Jeder Eintrag läuft einmal. Wenn du ihn später bearbeitest, wird er nicht erneut gepostet.
- Pro Prüfung laufen bis zu 10 Einträge, die ältesten zuerst.
Jedes Feld des Eintrags steht den Schritten nach dem Trigger zur Verfügung, in Kleinbuchstaben und mit Unterstrichen geschrieben: Ein Feld namens Cover Image wird zu {{trigger.cover_image}}. Außerdem kannst du Folgendes verwenden:
| Wert | Was er enthält |
|---|---|
{{trigger.title}} | Das Titelfeld, sonst den Slug |
{{trigger.url}} | Die Seite des Eintrags auf deiner Website. Leer bei einem Entwurf oder wenn keine Seite die Collection zeigt |
{{trigger.text}} | Das Zusammenfassungsfeld, sonst den Inhalt als reinen Text, sonst den Titel |
{{trigger.image}} | Das erste Bild. {{trigger.images}} enthält alle |
Formatierter Text kommt als reiner Text an, Optionen mit ihren Namen und Referenzen als Eintrags-IDs. Lässt du die Beschreibung oder die Medien eines folgenden Post to-Schritts leer, verwendet er {{trigger.text}} und die Bilder des Eintrags.
Trennen
Wenn du einen Framer-Channel in Ocoya trennst, postet Ocoya dort nicht mehr. Einträge, die Ocoya bereits angelegt hat, bleiben in deiner Collection.
Um den Zugriff von Ocoya vollständig zu beenden, lösche seinen API-Key in den Site Settings → General des Projekts. Jeder Framer-Channel aus diesem Projekt zeigt dann beim nächsten Posten Reconnect needed an.
Häufige Probleme
“Framer no longer accepts this API key.” Der Key wurde gelöscht oder gehört zu einem anderen Projekt. Erstelle in den Site Settings des Projekts einen neuen Key und verbinde Framer erneut damit.
“Paste the project’s address from your browser…” Die Projektadresse muss mit https://framer.com/projects/ beginnen. Kopiere sie bei geöffnetem Projekt aus der Adressleiste des Browsers.
“Framer would not publish the site (…), so the item was not added.” Framer hat das Veröffentlichen verweigert, auch nachdem Ocoya es erneut versucht hat. In der Collection wurde nichts zurückgelassen. Versuche es später noch einmal.
“A plugin manages the Framer collection …” Diese Collection wird von einem Plugin synchronisiert. Poste in eine Collection, die du selbst verwaltest.
“The Framer collection … has no formatted text field for the post.” Füge der Collection in Framer ein Formatted-Text-Feld hinzu.
“Framer is busy” / “Framer took too long to answer.” Die Server von Framer haben das Projekt nur langsam geöffnet. Versuche es in einer Minute erneut.
“Too many sessions are open with this Framer API key.” Mehrere Posts oder Workflows haben das Projekt gleichzeitig erreicht. Versuche es in einer Minute erneut.