Framer jest w Ocoya w wersji beta. Opiera się na Server API Framera, które sam Framer nadal nazywa betą, więc rzeczy mogą się zmieniać wraz ze zmianami po stronie Framera.
Kanał Framer to jedna kolekcja CMS w jednym projekcie Framer — Twój Blog, Journal, Case Studies. Opublikuj w niej, a Ocoya doda nowy element: z wypełnionym tytułem, sformatowaną treścią, obrazem okładki i datą. Potem, chyba że zdecydujesz się zachować go jako wersję roboczą, Ocoya opublikuje stronę.
Framer może też uruchamiać workflow: nowy element w kolekcji może zostać udostępniony w Twoich pozostałych kanałach. Zobacz Framer w workflowach poniżej.
Zanim zaczniesz
Framer nie ma logowania dla aplikacji. Zamiast tego Ocoya korzysta z Server API Framera, które otwiera się za pomocą klucza API tworzonego w ustawieniach projektu. Klucz daje dostęp tylko do tego jednego projektu — aby połączyć trzy strony we Framerze, połącz każdą z własnym kluczem.
Musisz mieć możliwość otwarcia Site Settings projektu. Server API Framera jest w wersji beta.
Połącz Framer
Utwórz klucz API we Framerze
Otwórz projekt we Framerze, a potem Settings → General. W sekcji API keys kliknij Add i skopiuj klucz.
Skopiuj adres projektu
Przy otwartym projekcie skopiuj adres z przeglądarki. Zaczyna się od https://framer.com/projects/.
Wybierz Framer w Ocoya
Wybierz Channels na lewym pasku bocznym, a potem Connect channel i wybierz Framer w kategorii Blogging.
Wklej adres i klucz
Wklej je w pola Project address i Framer API key, a potem wybierz Connect Framer. Ocoya od razu otwiera projekt, żeby sprawdzić, czy klucz działa.
Wybierz kolekcje do dodania
Wyświetlana jest każda kolekcja z projektu, nazwana Project name · Each post becomes an item. Wybierz te, które chcesz mieć jako kanały dla tej marki. Jeśli jest tylko jedna, zostanie dodana bez pytania.
Kolekcja synchronizowana przez wtyczkę Framera — na przykład z Google Sheets lub Notion — jest wyświetlana, ale nie można jej wybrać: A plugin manages this collection, so posts cannot be added to it. Framer pozwala tylko tej wtyczce zapisywać w niej dane.
Aby wymienić klucz, połącz Framer ponownie z tym samym adresem projektu i nowym kluczem. Twoje kanały nadal działają.
Jak posty pojawiają się we Framerze
| Część posta | Gdzie trafia we Framerze |
|---|---|
| Tytuł | Pole, na którym opiera się slug kolekcji — zwykle Title — do 256 znaków. Bez tytułu używana jest pierwsza linijka tekstu |
| Tytuł | Slug, zapisany małymi literami, cyframi i myślnikami. Slug już użyty w kolekcji dostaje -2, -3 i tak dalej |
| Tekst | Pole Formatted Text o nazwie Content, Body lub podobnej — w przeciwnym razie pierwsze pole Formatted Text |
| Pierwszy obraz | Pole Image o nazwie Image, Cover, Thumbnail lub podobnej — w przeciwnym razie pierwsze pole Image. Używany jest tylko pierwszy obraz |
| Podsumowanie | Pole tekstowe o nazwie Summary, Excerpt lub Subtitle dostaje zajawkę artykułu albo pierwsze 160 znaków tekstu |
| Data | Pole Date o nazwie Date, Published lub podobnej jest ustawiane na moment publikacji posta |
Jeśli pierwsza linijka tekstu powtarza tytuł, zostaje pominięta w treści. Linki dodane do posta, których nie ma jeszcze w tekście, trafiają na koniec. Markdown — nagłówki, listy, cytaty, pogrubienia, linki — dociera jako prawdziwie sformatowany tekst, a tekst alternatywny obrazów jest przekazywany do Framera, który przechowuje własną kopię obrazu.
Wszystkie pozostałe pola zostają nietknięte.
Co robi publikowanie na żywo
Posty z edytora postów są publikowane na żywo: Ocoya dodaje element, a potem publikuje projekt i wdraża go na Twojej własnej domenie.
Framer publikuje projekt w całości. Wszystkie inne niepublikowane zmiany w projekcie trafiają na żywo razem z artykułem — niedokończona strona, trwający redesign. Jeśli ktoś pracuje nad stroną, użyj workflow z opcją Keep as draft.
Jeśli Framer jest chwilowo niedostępny, Ocoya ponawia próbę kilka razy w ciągu następnej minuty. Jeśli nadal nie może opublikować, nowy element jest ponownie usuwany, a post kończy się błędem, więc nieudany post nigdy nie zostawia zbłąkanego elementu w Twojej kolekcji.
W workflow krok Publish to Framer CMS pozwala wybrać w In Framer:
| Ustawienie | Co się dzieje |
|---|---|
| Publish live (domyślnie) | Element jest dodawany, a strona publikowana |
| Keep as draft | Element jest dodawany jako wersja robocza. Framer pomija wersje robocze w każdej publikacji, dopóki ktoś ich nie zmieni |
To coś innego niż przełącznik Save as draft w kroku, który zachowuje post w planerze Ocoya, w ogóle nie wysyłając go do Framera.
Opublikowany post linkuje do swojej strony w Twojej witrynie, używając ścieżki strony CMS kolekcji we Framerze, np. /blog/your-post. Jeśli żadna strona nie pokazuje kolekcji albo element jest wersją roboczą, linkuje do elementu we Framerze.
Nie musisz mieć otwartego Framera, żeby to wszystko działało. Ocoya komunikuje się bezpośrednio z serwerami Framera.
Co możesz publikować
| Typ posta | Obsługiwany |
|---|---|
| Tekst | Tak |
| Obrazy | Tak — pierwszy staje się okładką. Kolekcje Framera przechowują jeden obraz na pole Image |
| GIF | Tak, jako obraz |
| Wideo | Nie |
Post musi zawierać tekst lub obraz.
Limity Framera
| Limit | |
|---|---|
| Tekst posta | 100 000 znaków |
| Tytuł | 256 znaków |
| Obrazy | 1 używany na post |
| Hashtagi | Bez limitu. Framer pokazuje je jako zwykły tekst |
Usuwanie posta
Usunięcie opublikowanego posta w Ocoya usuwa element z kolekcji. Ocoya nie publikuje strony przy usuwaniu, więc niczyja niedokończona praca nie trafi przez to na żywo — element zniknie z Twojej działającej strony przy następnej publikacji projektu. Elementów utworzonych przez Twój zespół nigdy nie ruszamy.
Framer w workflowach
Framer działa na obu końcach workflow.
Publish to Framer CMS to akcja. Wybierz kolekcję, Title (z niego powstaje slug), opis oraz In Framer: Publish live lub Keep as draft.
New item in a Framer collection to wyzwalacz. Wybierz kanał kolekcji, a workflow uruchomi się raz dla każdego nowego elementu.
| Ustawienie | Co robi |
|---|---|
| Collection | Kolekcja do obserwowania. Musi być wcześniej połączona jako kanał |
| Only when | Opcjonalne. Nazwa pola i wartość, np. Category i News. Workflow uruchamia się wtedy, gdy element osiągnie tę wartość — łącznie z wersjami roboczymi — zamiast w chwili dodania |
Jak zachowuje się wyzwalacz:
- Ocoya sprawdza co 15 minut. Framer nie powiadamia aplikacji o zmianach, więc uruchomienie dla nowego elementu może potrwać do 15 minut.
- Wersje robocze są pomijane. Bez Only when element uruchamia workflow, gdy jest w kolekcji i nie jest wersją roboczą.
- Nic sprzed włączenia workflow się nie liczy. Elementy już obecne w kolekcji są pomijane, a element liczy się od chwili utworzenia.
- Każdy element uruchamia się raz. Późniejsza edycja nie opublikuje go ponownie.
- Do 10 elementów na jedno sprawdzenie, od najstarszego.
Każde pole elementu jest dostępne dla kroków po wyzwalaczu, zapisane małymi literami z podkreśleniami: pole o nazwie Cover Image staje się {{trigger.cover_image}}. Możesz też użyć:
| Wartość | Co zawiera |
|---|---|
{{trigger.title}} | Pole tytułu, w przeciwnym razie slug |
{{trigger.url}} | Strona elementu w Twojej witrynie. Pusta dla wersji roboczej albo gdy żadna strona nie pokazuje kolekcji |
{{trigger.text}} | Pole podsumowania, w przeciwnym razie treść jako zwykły tekst, w przeciwnym razie tytuł |
{{trigger.image}} | Pierwszy obraz. {{trigger.images}} zawiera wszystkie |
Sformatowany tekst dociera jako zwykły tekst, opcje jako ich nazwy, a odwołania jako identyfikatory elementów. Jeśli zostawisz puste pole opisu lub mediów w następnym kroku Post to, użyje on {{trigger.text}} i obrazów elementu.
Odłączanie
Odłączenie kanału Framer w Ocoya powoduje, że Ocoya przestaje tam publikować. Elementy, które już dodała, zostają w Twojej kolekcji.
Aby całkowicie odciąć dostęp Ocoya, usuń jej klucz API w Site Settings → General projektu. Każdy kanał Framer z tego projektu pokaże wtedy Reconnect needed przy następnej publikacji.
Częste problemy
“Framer no longer accepts this API key.” Klucz został usunięty albo należy do innego projektu. Utwórz nowy klucz w Site Settings projektu i połącz Framer ponownie z jego użyciem.
“Paste the project’s address from your browser…” Adres projektu musi zaczynać się od https://framer.com/projects/. Skopiuj go z paska adresu przeglądarki przy otwartym projekcie.
“Framer would not publish the site (…), so the item was not added.” Framer odmówił publikacji, nawet po ponownej próbie Ocoya. W kolekcji nic nie zostało. Spróbuj ponownie później.
“A plugin manages the Framer collection …” Ta kolekcja jest synchronizowana przez wtyczkę. Publikuj w kolekcji, którą zarządzasz sam.
“The Framer collection … has no formatted text field for the post.” Dodaj pole Formatted Text do kolekcji we Framerze.
“Framer is busy” / “Framer took too long to answer.” Serwery Framera wolno otwierały projekt. Spróbuj ponownie za minutę.
“Too many sessions are open with this Framer API key.” Kilka postów lub workflowów dotarło do projektu jednocześnie. Spróbuj ponownie za minutę.