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

Jak osadzić formularz kontaktowy w Shopify za pomocą Custom Liquid

Sekcja Custom Liquid w dowolnym motywie. Bez instalowania aplikacji, bez znajomości Liquid — wystarczy wkleić dwie linie.

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

Czy to naprawdę działa?

Tak — w każdym motywie Shopify obsługującym Online Store 2.0 (Dawn i każdy nowoczesny motyw). Sekcja Custom Liquid jest wbudowana w Shopify; żadnej aplikacji, żadnej edycji kodu motywu na większości stron.

Krok po kroku

Otwórz edytor motywu

W panelu Shopify przejdź do Sklep online → Motywy → Dostosuj przy motywie, który chcesz edytować.

Dodaj sekcję Custom Liquid

Wybierz stronę, na której ma pojawić się formularz (strona, strona kontaktu lub dowolny szablon strony). Kliknij Dodaj sekcję i wybierz Custom Liquid.

Wklej kod osadzania

Wklej dwie linie z dashboardu Toimii w pole Liquid. Liquid przepuszcza surowy HTML bez zmian, więc znacznik script i własny element działają dokładnie tak jak napisano.

Zapisz motyw

Zapisz w edytorze motywu. Formularz jest od razu dostępny w sklepie.

Przetestuj w live sklepie

Otwórz stronę live (nie podgląd) i wyślij testową wiadomość, żeby potwierdzić działanie od końca do końca. Jeśli coś jest nie tak, sprawdź pułapki poniżej.

Częste pułapki

Bezpośrednie zmiany w theme.liquid są nadpisywane przy aktualizacji motywu. Używaj sekcji Custom Liquid w edytorze motywu (zapisywanej per strona) albo zduplikuj motyw przed edycją głównych plików.
Custom Liquid na stronach kasy wymaga Shopify Plus. W standardowych planach osadzaj na stronach kontaktu, FAQ lub produktu.
Niektóre motywy mają wbudowany CSP blokujący zewnętrzne skrypty. Jeśli formularz się nie renderuje, zezwól na cdn.toimii.io i api.toimii.io w script-src / connect-src.
Podgląd w edytorze motywu czasem ładuje sekcje w sposób, który psuje pierwsze renderowanie własnych elementów. Sprawdź na URL live sklepu (lub przyciskiem „Podgląd"), żeby potwierdzić — podgląd nie jest źródłem prawdy.
Jeśli owiniesz formularz w blok Liquid {% if %}, skrypt i tak ładuje się na każdej stronie. Żeby oszczędzić bajty, ochroń znacznik script tym samym warunkiem.

Często zadawane pytania

Czy potrzebuję aplikacji Shopify z App Store?

Nie. Custom Liquid to wbudowana sekcja motywu Shopify — każdy motyw od Dawn wzwyż ją obsługuje. W App Store jest mnóstwo aplikacji do formularzy kontaktowych; nie potrzebujesz żadnej z nich dla Toimii.

Czy mogę osadzić formularz na stronie kasy?

Nie w standardowych planach. Custom Liquid na stronach kasy wymaga Shopify Plus. W sklepach bez Plus osadź formularz na stronie kontaktu, FAQ lub stronie statusu zamówienia po zakupie.

Czy aktualizacje motywu nadpiszą mój kod osadzania?

Tak — bezpośrednie zmiany w plikach motywu (theme.liquid, sections/*.liquid) są nadpisywane przy aktualizacji lub przywracaniu motywu. Dwie bezpieczniejsze opcje: użyj sekcji motywu + bloku Custom Liquid (zapisanego per strona w edytorze motywu) albo zduplikuj motyw przed edycją.

Mój sklep ma Content-Security-Policy — czy to blokuje Toimii?

Kilka sklepów ma restrykcyjną Content-Security-Policy przez ustawienia motywu lub aplikacje. Jeśli formularz się nie renderuje, zezwól na te domeny w script-src: cdn.toimii.io i api.toimii.io.

Czy działa na niestandardowej stronie Storefront API (Hydrogen, Next.js)?

Tak. Użyj App Bridge do wyrenderowania kontenera HTML, a następnie wstrzyknij w niego znacznik script i własny element. To samo podejście: dwie linie kodu, resztą zajmuje się własny element.

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

Strony statyczne

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

Przeczytaj pełny poradnik

HTML / Własny

Wystarczy zwykła strona HTML. Otwórz w dowolnym edytorze tekstu, wklej, zapisz, wgraj. Trzy kroki i działa.

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.