Toimii tyliai startavo, todėl šiuose vadovuose aprašoma paslauga, prie kurios gali užsiregistruoti ir kurią gali naudoti jau šiandien. Kelios dalys dar kelyje — iOS ir Android programėlės pasirodys vėliau 2026 m.

Pridėk kontaktų formą į savo statinę svetainę: Astro, Hugo, 11ty, Jekyll

Vienas fragmentas tavo išdėstymo šablone. Veikia Astro, Hugo, 11ty, Jekyll ir kiekviename kitame statinės svetainės generatoriuje.

<script src="https://cdn.toimii.io/components/your-code.js" async></script>
<toimii-your-code></toimii-your-code>

Ar tai tikrai veikia?

Taip — ir statinės svetainės yra švariausias atvejis. Jokios papildinio smėlio dėžės, jokių redaktorių, naikinančių scenarijus, jokio plano lygio. Dvi eilutės patenka į tavo išdėstymo šabloną tokiu pačiu būdu, kaip ir į bet kurį HTML failą.

Žingsnis po žingsnio

Atidaryti išdėstymo šabloną

Atidaryti šabloną, apgaubiantį kiekvieną puslapį — tą, kuriame jau yra tavo <body> žymė.

Įklijuoti įterpimo kodą

Įklijuoti dvi eilutes iš savo komponento puslapio Toimii į <body>. Jei nori rodyti formą tik kai kuriuose puslapiuose, abi eilutes apgaubk savo generatoriaus sąlyga — scenarijus ir žymė eina kartu.

Sugeneruoti ir paskelbti

Sugeneruoti ir paskelbti kaip įprastai. Tada atidaryti paskelbtą puslapį ir išsiųsti sau bandomąją žinutę.

Klaidos

Žymę dėk į šabloną, o ne į Markdown turinio failą. Ar neapdorotas HTML išliks perėjęs per Markdown, priklauso nuo kiekvieno generatoriaus nustatymo — Hugo tam reikia markup.goldmark.renderer.unsafe — o šablonas per Markdown iš viso nepraleidžiamas.
Astro supakuoja tas scenarijaus žymes, kurių vienintelis atributas yra src. Mūsiškėje yra ir async, o bet koks papildomas atributas šalia src priverčia Astro žymės neliesti — tad ji veikia tokia, kokia parašyta. Jei kada nors ją apkarpysi iki vieno src, pridėk is:inline.
Statiniai serveriai Content-Security-Policy pagal nutylėjimą neprideda. Jei nustatai ją pats — kaip HTTP atsako antraštę ar <meta> žymę — leisk cdn.toimii.io script-src srityje ir api.toimii.io connect-src srityje.

Dažnai klausiama

Kaip jį pridėti Astro, Hugo, 11ty ar Jekyll?

Niekuo nesiskiria — aukščiau aprašyti žingsniai ir yra visa procedūra visuose keturiuose. Šablono failo kelio sąmoningai nenurodome: kiekvienas generatorius tą failą vadina savaip, o pavadinimai keitėsi ir tarp versijų, tad pasitikrink savo generatoriaus dokumentacijoje.

Ar veiks GitHub Pages, Netlify, Vercel ar Cloudflare Pages?

Taip, ir bet kurioje kitoje paslaugoje, kuri tiekia statinius failus — tavo pusėje niekas nesisuka. Svarbi ne pati paslauga, o adresas: pateikimai priimami tik iš to domeno, kurį nurodei Toimii, tad peržiūros versija paslaugos pačios subdomene formą atvaizduoja, bet žinutės nepriima.

Ar tai sulėtins mano kūrimą?

Ne. Scenarijus įkraunamas vykdymo metu, ne kūrimo metu — tavo kūrimas išsiunčia scenarijaus žymę ir naršyklė gauna tikrąjį komponentą, kai lankytojas pasiekia puslapį. Astro, Hugo, 11ty, Jekyll: visi neveikiami.

Įterpiama kitoje platformoje?

Tos pačios dvi kodo eilutės, išskaidytos kiekvienai platformai.

WordPress

Pasirinktinis HTML blokas, Blokų redaktorius arba Klasikinis. Jokio papildinių diegimo. Vienas niuansas — tavo naudotojo vaidmuo turi turėti unfiltered_html galimybę.

Skaityti visą vadovą

Squarespace

Įklijuok kodo bloką bet kuriame puslapyje. Reikia plano, kurio kodo blokams leidžiama vykdyti JavaScript.

Skaityti visą vadovą

Webflow

Įvilk Kodo įterpimo elementą ir įklijuok dvi eilutes. Webflow pasirinktinis kodas yra mokama galimybė — tai vienintelė sąlyga.

Skaityti visą vadovą

Wix

Naudok Wix Custom Element: savo komponento scenarijaus URL į Server URL, jo žymę į Tag Name. HTML įterpimas neveiks — tai smėlio dėžės iframe.

Skaityti visą vadovą

Shopify

Pridėk Pasirinktinę Liquid sekciją Shopify temos redaktoriuje — jokio programų diegimo, jokio temos kodo redagavimo. Atsiskaitymo puslapiai — vienintelė vieta, kur jos įdėti negalima.

Skaityti visą vadovą

HTML / Pasirinktinis

Pakanka paprasto HTML puslapio. Atidaryk bet kuriame teksto redaktoriuje, įklijuok, išsaugok, įkelk. Trys žingsniai ir forma jau veikia.

Skaityti visą vadovą

React / Vue / Angular

Naudok pasirinktinį elementą tiesiogiai JSX, Vue šablonuose ar Angular komponentuose. Jokio apgaubiančio komponento, jokio papildomo paketo.

Skaityti visą vadovą

Pasiruošęs išbandyti?

30 dienų nemokamas bandymas. Kredito kortelės nereikia. Pasiruoši per kelias minutes.

Pradėti nemokamą bandymą

Kredito kortelės nereikia. Pasiruoši per 2 minutes.