Šiuose vadovuose aprašoma, kaip Toimii veiks po paleidimo. Valdymo skydelis ir atsiskaitymas dar neprieinami — Toimii pradės veikti 2026 m.

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

Vienas fragmentas jūsų išdėstymo šablone. Veikia Astro, Hugo, 11ty, Jekyll, Gatsby, Bridgetown ir kiekviename kitame statinės svetainės generatoriuje.

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

Ar tai tikrai veikia?

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

Žingsnis po žingsnio

Atidaryti išdėstymo šabloną

Atidaryti išdėstymo šabloną, apgaubiantį kiekvieną puslapį — _layouts/default.html Jekyll, src/layouts/Base.astro Astro, layouts/partials/footer.html Hugo, _includes/layout.njk 11ty.

Įklijuoti įterpimo kodą

Įklijuoti dvi eilutes iš Toimii valdymo skydelio <body>. Norėdami rodyti formą tik tam tikruose puslapiuose, apgaukite pasirinktinį elementą savo generatoriaus šablono kalba (frontmatter vėliava, puslapio slug patikrinimas ir kt.); scenarijaus žymė gali likti išdėstyme.

Paleisti kūrimo serverį

Paleisti kūrimo serverį (npm run dev / hugo server / jekyll serve). Forma atvaizduojama iš karto — jokios papildomos konfigūracijos, jokio papildinių, jokio @types.

Kurti ir diegti

Kurti ir diegti kaip įprastai (Netlify, Vercel, GitHub Pages, S3 + CloudFront, kur talpinate). Forma veikia toliau — Toimii CDN atlieka likusį darbą.

Dažnos klaidos

Dauguma statinės svetainės Markdown atvaizdavimo priemonių pagal nutylėjimą naikina neapdorotą HTML. Jekyll / 11ty / Hugo atveju įgalinkite neapdorotą HTML arba įklijuokite įterpimą į išdėstymo failą, o ne turinio failą.
Karštas perkrovimas kartais pakartotinai įkelia scenarijų kelis kartus kūrimo metu. Tai tik kūrimo ypatybė; gamybos kūrimai išsiunčia žymę vieną kartą puslapyje.
Kai kurie serveriai prideda agresyvius Content-Security-Policy antraštus (Netlify ir Vercel leidžia tinkinti). Leiskite cdn.toimii.io ir api.toimii.io script-src ir connect-src srityse.
Neįklijuokite fragmento į <head>. Pasirinktinis elementas yra kūno lygio žymė — scenarijų galite palikti <head> (su async), bet žymė turi būti <body>.

Dažnai klausiama

Kaip pridėti Astro?

Įmeskite scenarijų žymę į pagrindinį Layout komponentą (pvz. src/layouts/Base.astro) ir naudokite pasirinktinį elementą bet kuriame .astro faile. Astro atvaizduoja nežinomus elementus kaip paprastą HTML — žymei pačiai kliento direktyvos nereikia.

Kaip pridėti Hugo?

Pridėkite fragmentą į layouts/partials/footer.html (arba kur įkeliate pasirinktinius scenarijus) ir naudokite pasirinktinį elementą turinio failuose, išdėstymo šablonuose ar shortcodes.

Kaip pridėti 11ty (Eleventy)?

Pridėkite fragmentą į savo pagrindinį išdėstymą (_includes/layout.njk Eleventy numatytuose). Jis taikomas kiekvienam puslapiui, kuris pratęsia išdėstymą. Nustatykite karšto perkrovimo įjungimą; forma bus matoma iš karto, kai kūrimo serveris atsinaujins.

Kaip pridėti Jekyll / GitHub Pages?

Pridėkite fragmentą į _layouts/default.html (arba pasirinktą išdėstymą). Naudokite pasirinktinį elementą bet kuriame Markdown įraše įgalinę html Markdown atvaizdavimo priemonėje.

Ar tai sulėtins mano kūrimą?

Ne. Scenarijus įkraunamas vykdymo metu, ne kūrimo metu — jūsų 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 — jūsų naudotojo vaidmuo turi turėti unfiltered_html galimybę.

Skaityti visą vadovą

Squarespace

Įkijuokite kodo bloką bet kuriame puslapyje. Reikalauja Core plano (2025 m. Business perkūrimas) arba aukštesnio.

Skaityti visą vadovą

Webflow

Kodo įterpimo elementas talpina iki 50 000 simbolių. Pasirinktinis kodas reikalauja pagrindinio plano arba aukštesnio. Publikuokite, kad pamatytumėte.

Skaityti visą vadovą

Wix

Wix apsaugo įterpimo valdiklį smėlio dėžėje, todėl naudojame išskaidytą metodą — scenarijus nustatymuose → Pasirinktinis kodas, žymė per Įterpti valdiklį. Sąžiningas vadovas.

Skaityti visą vadovą

Shopify

Pridėkite pasirinktinę Liquid sekciją bet kuriai temai — programų diegimo nereikia. Praleiskite atsiskaitymo puslapius, nebent esate Shopify Plus.

Skaityti visą vadovą

HTML / Pasirinktinis

Pakanka paprastos HTML puslapio. Atidaryk bet kuriame teksto redaktoriuje, įklijuok, išsaugok, įkelk. Trys žingsniai ir esi aktyvus.

Skaityti visą vadovą

React / Vue / Angular

Naudokite 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.

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