Toimii jest w fazie cichego startu, więc te poradniki opisują usługę, w której możesz się zarejestrować i z której możesz korzystać już dziś. Kilka elementów jest jeszcze w drodze — aplikacje na iOS i Androida pojawią się jeszcze 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-your-code></toimii-your-code>

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 zwykłym edytorze 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 tak, jak zwykle publikujesz. Potem otwórz opublikowaną stronę i wyślij sobie testową wiadomość.

Pułapki

Obie linie albo żadna: skrypt definiuje element, a tag umieszcza go na stronie. Wklej sam tag, a przeglądarka niczego nie narysuje i nie znajdziesz żadnego błędu.
Edytor tekstu z formatowaniem zamienia proste cudzysłowy na typograficzne. Przeglądarka czyta wtedy te znaki jako część adresu, więc skrypt w ogóle się nie ładuje. Używaj zwykłego edytora tekstu.
Jeśli ustawiasz Content-Security-Policy — jako nagłówek odpowiedzi HTTP albo tag <meta> — zezwól na cdn.toimii.io w script-src i api.toimii.io w connect-src. script-src odpowiada za załadowanie komponentu, connect-src za wysłanie formularza. Większość zwykłych stron HTML nie ma żadnego CSP.

Często zadawane pytania

Czy potrzebuję backendu lub PHP?

Nie potrzebujesz własnego serwera. 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://?

Wyrenderuje się, ale nic, co wyślesz, nie dotrze. Zgłoszenia są przyjmowane tylko z domeny wskazanej przez Ciebie w Toimii, a strona otwarta z dysku nie ma domeny, którą dałoby się dopasować — wysyłka kończy się ogólnym błędem. Układ sprawdzaj z dysku; wysyłanie testuj na wgranej stronie.

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ć Code Block na dowolną stronę. Wymaga planu, w którym bloki kodu mogą uruchamiać JavaScript.

Przeczytaj pełny poradnik

Webflow

Przeciągnij element Code Embed i wklej dwie linie. Własny kod to w Webflow funkcja płatna — to jedyny warunek.

Przeczytaj pełny poradnik

Wix

Użyj Custom Element od Wix: adres skryptu Twojego komponentu w polu Server URL, jego tag w polu Tag Name. Osadzanie HTML nie zadziała — to sandboxowy iframe.

Przeczytaj pełny poradnik

Shopify

Dodaj sekcję Custom Liquid w edytorze motywu Shopify — bez instalowania aplikacji, bez edycji kodu motywu. Strony kasy to jedyne miejsce, w którym jej nie umieścisz.

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.

Rozpocznij bezpłatny okres próbny

Bez karty kredytowej. Konfiguracja w 2 minuty.