Ocoya Framer yra beta versijos. Jis sukurtas naudojant Framer Server API, kurį pati Framer vis dar vadina beta, todėl, Framer ką nors keičiant, gali keistis ir čia.
Framer kanalas yra viena CMS collection viename Framer projekte — jūsų Blog, Journal, Case Studies. Paskelbkite į ją, ir Ocoya prideda naują elementą: užpildo pavadinimą, suformatuotą turinį, viršelio paveikslėlį ir datą. Tada, nebent pasirinkote palikti kaip juodraštį, Ocoya paskelbia svetainę.
Framer taip pat gali pradėti darbo eigą (workflow): naują kolekcijos elementą galima pasidalyti į kitus jūsų kanalus. Žr. Framer darbo eigose toliau.
Prieš pradedant
Framer neturi prisijungimo programoms. Vietoje to Ocoya naudoja Framer Server API, kuris atidaromas su API key, sukurtu paties projekto nustatymuose. Raktas pasiekia tik tą vieną projektą — jei norite prijungti tris Framer svetaines, kiekvieną prijunkite su savo raktu.
Turite turėti galimybę atidaryti projekto Site Settings. Framer Server API yra beta versijos.
Prijunkite Framer
Sukurkite API raktą Framer
Atidarykite projektą Framer, tada Settings → General. Skiltyje API keys spustelėkite Add ir nukopijuokite raktą.
Nukopijuokite projekto adresą
Su atidarytu projektu nukopijuokite adresą iš naršyklės. Jis prasideda https://framer.com/projects/.
Pasirinkite Framer Ocoya
Kairėje šoninėje juostoje pasirinkite Channels, tada Connect channel ir skiltyje Blogging pasirinkite Framer.
Įklijuokite adresą ir raktą
Įklijuokite juos į Project address ir Framer API key, tada pasirinkite Connect Framer. Ocoya iškart atidaro projektą, kad patikrintų, ar raktas veikia.
Pasirinkite pridedamas kolekcijas
Išvardytos visos projekto kolekcijos, pavadintos Project name · Each post becomes an item. Pasirinkite tas, kurių norite kaip šio prekių ženklo (brand) kanalų. Jei kolekcija tik viena, ji pridedama nieko neklausiant.
Kolekcija, kurią sinchronizuoja Framer papildinys — pavyzdžiui, iš Google Sheets ar Notion — išvardyta, bet jos pasirinkti negalima: A plugin manages this collection, so posts cannot be added to it. Framer leidžia rašyti į ją tik tam papildiniui.
Norėdami pakeisti raktą, prijunkite Framer iš naujo su tuo pačiu projekto adresu ir nauju raktu. Jūsų kanalai toliau veikia.
Kaip įrašai atrodo
| Įrašo dalis | Kur patenka Framer |
|---|---|
| Pavadinimas | Laukas, pagal kurį kuriamas kolekcijos slug — dažniausiai Title — iki 256 simbolių. Be pavadinimo naudojama pirma teksto eilutė |
| Pavadinimas | Slug, mažosiomis raidėmis, skaičiais ir brūkšneliais. Kolekcijoje jau naudotas slug gauna -2, -3 ir t. t. |
| Tekstas | Formatted Text laukas, vadinamas Content, Body ar panašiai — kitu atveju pirmas Formatted Text laukas |
| Pirmas paveikslėlis | Image laukas, vadinamas Image, Cover, Thumbnail ar panašiai — kitu atveju pirmas Image laukas. Naudojamas tik pirmas paveikslėlis |
| Santrauka | Tekstinis laukas, vadinamas Summary, Excerpt arba Subtitle, gauna straipsnio ištrauką arba pirmus 160 teksto simbolių |
| Data | Date laukas, vadinamas Date, Published ar panašiai, nustatomas į paskelbimo momentą |
Jei pirma teksto eilutė kartoja pavadinimą, ji paliekama už turinio ribų. Prie įrašo pridėtos nuorodos, kurių dar nėra tekste, pridedamos pabaigoje. Markdown — antraštės, sąrašai, citatos, paryškinimas, nuorodos — atkeliauja kaip tikras formatuotas tekstas, o paveikslėlio alternatyvusis tekstas perduodamas Framer, kuri pasilaiko savo paveikslėlio kopiją.
Visi kiti laukai paliekami nepaliesti.
Ką daro paskelbimas gyvai
Įrašai iš įrašų rengyklės skelbiami gyvai: Ocoya prideda elementą, tada paskelbia projektą ir įdiegia jį jūsų pasirinktiniame domene.
Framer skelbia projektą kaip visumą. Visi kiti nepaskelbti projekto pakeitimai pasirodo gyvai kartu su straipsniu — pusiau baigtas puslapis, vykstantis dizaino atnaujinimas. Jei kas nors dirba prie svetainės, vietoje to naudokite darbo eigą su Keep as draft.
Jei Framer trumpam nepasiekiama, Ocoya kelis kartus bando iš naujo per kitą minutę. Jei vis tiek nepavyksta paskelbti, naujas elementas pašalinamas, o įrašas žymimas kaip nepavykęs, todėl nepavykęs įrašas niekada nepalieka atsitiktinio elemento jūsų kolekcijoje.
Darbo eigoje žingsnis Publish to Framer CMS leidžia pasirinkti skiltyje In Framer:
| Nustatymas | Kas nutinka |
|---|---|
| Publish live (numatytasis) | Elementas pridedamas ir svetainė paskelbiama |
| Keep as draft | Elementas pridedamas kaip juodraštis. Framer palieka juodraščius už kiekvieno paskelbimo ribų, kol kas nors jį pakeis |
Tai skiriasi nuo žingsnio jungiklio Save as draft, kuris palieka įrašą jūsų Ocoya planavimo kalendoriuje (planner), išvis nesiųsdamas jo į Framer.
Paskelbtas įrašas nurodo savo puslapį jūsų svetainėje, naudodamas kolekcijos CMS puslapio kelią Framer, pavyzdžiui, /blog/your-post. Jei jokiame puslapyje kolekcija nerodoma arba elementas yra juodraštis, nuoroda veda į elementą Framer.
Framer atidaryti nereikia. Ocoya tiesiogiai bendrauja su Framer serveriais.
Ką galite skelbti
| Įrašo tipas | Palaikoma |
|---|---|
| Tekstas | Taip |
| Paveikslėliai | Taip — pirmas tampa viršeliu. Framer kolekcijos kiekviename Image lauke laiko po vieną paveikslėlį |
| GIF | Taip, kaip paveikslėlis |
| Vaizdo įrašas | Ne |
Įraše turi būti tekstas arba paveikslėlis.
Framer apribojimai
| Apribojimas | |
|---|---|
| Įrašo tekstas | 100 000 simbolių |
| Pavadinimas | 256 simboliai |
| Paveikslėliai | 1 naudojamas viename įraše |
| Žymos (hashtags) | Apribojimo nėra. Framer rodo jas kaip paprastą tekstą |
Įrašo ištrynimas
Ištrynus paskelbtą įrašą Ocoya, elementas pašalinamas iš kolekcijos. Ištrinant Ocoya nepaskelbia svetainės, todėl niekieno nebaigtas darbas dėl to nepasirodo gyvai — elementas dingsta iš jūsų gyvos svetainės, kai projektas paskelbiamas kitą kartą. Jūsų komandos sukurti elementai niekada neliečiami.
Framer darbo eigose
Framer darbo eigoje (workflow) veikia abiejuose galuose.
Publish to Framer CMS yra veiksmas. Pasirinkite kolekciją, Title (iš jo sukuriamas slug), aprašą ir In Framer: Publish live arba Keep as draft.
New item in a Framer collection yra paleidiklis (trigger). Pasirinkite kolekcijos kanalą, ir darbo eiga bus paleista vieną kartą kiekvienam naujam elementui.
| Nustatymas | Ką daro |
|---|---|
| Collection | Stebima kolekcija. Ji pirmiausia turi būti prijungta kaip kanalas |
| Only when | Neprivaloma. Lauko pavadinimas ir reikšmė, pavyzdžiui, Category ir News. Tada darbo eiga paleidžiama, kai elementas pasiekia tą reikšmę — įskaitant juodraščius — o ne tada, kai jis pridedamas |
Kaip elgiasi paleidiklis:
- Ocoya tikrina kas 15 minučių. Framer apie pakeitimus programų neinformuoja, todėl naujo elemento paleidimas gali užtrukti iki 15 minučių.
- Juodraščiai praleidžiami. Be Only when elementas paleidžiamas, kai tik patenka į kolekciją ir nėra juodraštis.
- Nieko iki darbo eigos įjungimo neskaičiuojama. Kolekcijoje jau esantys elementai paliekami nepaliesti, o elementas skaičiuojamas nuo jo sukūrimo momento.
- Kiekvienas elementas paleidžiamas vieną kartą. Vėlesnis redagavimas jo neskelbia iš naujo.
- Per vieną patikrą paleidžiama iki 10 elementų, pradedant seniausiais.
Kiekvienas elemento laukas prieinamas paleidiklį sekantiems žingsniams, rašomas mažosiomis raidėmis su pabraukimo brūkšniais: laukas Cover Image tampa {{trigger.cover_image}}. Galite naudoti ir šias reikšmes:
| Reikšmė | Ką turi |
|---|---|
{{trigger.title}} | Pavadinimo laukas, kitu atveju slug |
{{trigger.url}} | Elemento puslapis jūsų svetainėje. Tuščia juodraščiui arba kai jokiame puslapyje kolekcija nerodoma |
{{trigger.text}} | Santraukos laukas, kitu atveju turinys paprastu tekstu, kitu atveju pavadinimas |
{{trigger.image}} | Pirmas paveikslėlis. {{trigger.images}} turi visus |
Formatuotas tekstas atkeliauja kaip paprastas tekstas, pasirinkimai — kaip jų pavadinimai, o nuorodos — kaip elementų ID. Jei paliksite sekančio Post to žingsnio aprašą ar media failus tuščius, bus naudojamas {{trigger.text}} ir elemento paveikslėliai.
Atjungimas
Atjungus Framer kanalą Ocoya, Ocoya nustoja skelbti ten. Jau pridėti elementai lieka jūsų kolekcijoje.
Norėdami visiškai nutraukti Ocoya prieigą, ištrinkite jos API raktą projekto Site Settings → General. Tada kiekvienas to projekto Framer kanalas kitą kartą skelbiant rodo Reconnect needed.
Dažnos problemos
“Framer no longer accepts this API key.” Raktas buvo ištrintas arba priklauso kitam projektui. Sukurkite naują raktą projekto Site Settings ir prijunkite Framer iš naujo su juo.
“Paste the project’s address from your browser…” Projekto adresas turi prasidėti https://framer.com/projects/. Nukopijuokite jį iš naršyklės adreso juostos su atidarytu projektu.
“Framer would not publish the site (…), so the item was not added.” Framer atsisakė skelbti net Ocoya bandant dar kartą. Kolekcijoje nieko nepalikta. Bandykite vėliau.
“A plugin manages the Framer collection …” Šią kolekciją sinchronizuoja papildinys. Skelbkite į kolekciją, kurią valdote patys.
“The Framer collection … has no formatted text field for the post.” Pridėkite Formatted Text lauką prie kolekcijos Framer.
“Framer is busy” / “Framer took too long to answer.” Framer serveriai lėtai atidarė projektą. Bandykite dar kartą po minutės.
“Too many sessions are open with this Framer API key.” Prie projekto vienu metu kreipėsi keli įrašai ar darbo eigos. Bandykite dar kartą po minutės.