Te przewodniki opisują Toimii po uruchomieniu. Panel i rozliczenia nie są jeszcze dostępne — Toimii ruszy w 2026 roku.

Najprostszy sposób na dodanie formularza kontaktowego do zwykłej strony HTML

Dwie linie gdziekolwiek w <body>. Bez budowania, bez zależności. Jeśli umiesz zapisać i wgrać plik, poradzisz sobie z tym.

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

Czy to naprawdę działa?

Tak — i to najprostszy przypadek. Zwykły HTML nie ma żadnego sandboxu pluginów, żadnego edytora usuwającego skrypty, żadnych poziomów planu. Obie linie działają wszędzie tam, gdzie możesz zapisać i wgrać plik .html.

Krok po kroku

Otwórz plik .html

Otwórz plik .html, do którego chcesz dodać formularz, w dowolnym edytorze tekstu — VS Code, Sublime, Notepad++, nawet TextEdit (w trybie zwykłego tekstu).

Wklej kod osadzania

Wklej dwie linie z panelu Toimii wewnątrz <body>, dokładnie w miejscu, gdzie ma pojawić się formularz.

Zapisz i wgraj

Zapisz plik i wgraj go na hosting — FTP, S3, Netlify drag & drop, cokolwiek używasz. Otwórz stronę w przeglądarce, żeby potwierdzić.

Częste pułapki

Nie wklejaj kodu wewnątrz <head>. Własny element to tag na poziomie body — musi być wewnątrz <body>.
Nie usuwaj atrybutu async ze znacznika script. Bez niego skrypt blokuje renderowanie reszty strony.
Jeśli kopiujesz z edytora rich-text, możesz otrzymać cudzysłowy typograficzne (" ") zamiast prostych ("). Używaj zwykłego edytora tekstu — VS Code, Sublime, Notepad, TextEdit w trybie zwykłego tekstu.
Jeśli Twoja strona ma już metatagi Content-Security-Policy, zezwól na cdn.toimii.io w script-src i connect-src. Większość zwykłych stron HTML nie ma żadnego CSP.

Często zadawane pytania

Czy potrzebuję backendu lub PHP?

Nie potrzebujesz backendu. Zgłoszenia trafiają bezpośrednio z formularza do API Toimii — strona HTML może być hostowana gdziekolwiek, nawet na darmowym hostingu statycznym.

Czy mogę otworzyć plik .html bezpośrednio przez file://?

To zależy od przeglądarki. Chrome i Safari otwierają pliki .html przez file:// bez problemu; Firefox blokuje skrypty cross-origin na adresach file://. Do testów uruchom lokalny serwer (npx serve, python -m http.server) i otwórz http://localhost.

Czy działa w CodePen, JSFiddle lub sandboxie?

Tak — wklej obie linie do panelu HTML. Skrypt się załaduje, a komponent wyrenderuje się w podglądzie iframe.

Czy działa offline?

Strona się ładuje, ale formularz potrzebuje połączenia z internetem, żeby wysłać wiadomość. Jeśli odwiedzający jest offline, strona wyrenderuje się normalnie — po prostu nie będzie mógł wysłać wiadomości, dopóki nie odzyska połączenia.

Osadzasz na innej platformie?

Te same dwie linie kodu, szczegółowo omówione dla każdej platformy.

WordPress

Blok Custom HTML, edytor blokowy lub klasyczny. Bez instalowania pluginu. Jeden haczyk — Twoja rola użytkownika musi mieć uprawnienie unfiltered_html.

Przeczytaj pełny poradnik

Squarespace

Wrzuć Blok Kodu na dowolną stronę. Wymaga planu Core (nowa nazwa Business od 2025) lub wyższego.

Przeczytaj pełny poradnik

Webflow

Element Code Embed mieści do 50 000 znaków. Własny kod wymaga planu Basic lub wyższego. Opublikuj, żeby zobaczyć efekt.

Przeczytaj pełny poradnik

Wix

Wix umieszcza widget Embed w sandboxowym iframe, więc używamy metody split — skrypt w Ustawienia → Własny kod, tag przez Embed a Widget. Uczciwy przewodnik.

Przeczytaj pełny poradnik

Shopify

Dodaj sekcję Custom Liquid do dowolnego motywu — bez instalowania aplikacji. Strony kasy wymagają Shopify Plus.

Przeczytaj pełny poradnik

Strony statyczne

Astro, Hugo, 11ty, Jekyll — te same dwie linie w szablonie layoutu. Budowanie pozostaje szybkie.

Przeczytaj pełny poradnik

React / Vue / Angular

Użyj własnego elementu bezpośrednio w JSX, szablonach Vue lub komponentach Angular. Żadnego komponentu opakowującego, żadnego dodatkowego pakietu.

Przeczytaj pełny poradnik

Gotowy, żeby spróbować?

30-dniowy bezpłatny okres próbny. Bez karty kredytowej. Gotowe w kilka minut.

Bez karty kredytowej. Konfiguracja w 2 minuty.