Which version is for me? Step by step (this page) is for anyone — even if you've never opened a terminal; it walks you through it and includes a builder that writes the command for you. The Quick reference is for developers who just want the parameters and the HTTP API.

Přidání formuláře krok za krokem

Nemusíte vědět, jak to celé funguje. Níže popište formulář, který chcete, zkopírujte řádek, který pro vás sestavíme, vložte ho do terminálu svého počítače a formulář je aktivní. To je celý postup.

You'll need one thing: your access token, a long secret string Flowsmith gives you. It's what proves the request is really you. Keep it private. Don't have one yet? Ask Flowsmith.

Nothing to install. This guide uses curl, which is already built into macOS and Windows. New to all this and want to double-check your computer's tools? See Set up your computer.

Krok 1Popište svůj formulář

Vyplňte tyto údaje. Vše níže se průběžně aktualizuje — během psaní se nikam nic neodesílá.

Your site name (a short nickname)

What's this form for?

Where should the messages arrive? (your email) Your website address (where the form lives) Fields visitors fill in

① Copy this line for your terminal

② Then paste this on your web page

Krok 2Spusťte řádek v terminálu

„Terminál“ je jednoduché textové okno zabudované ve vašem počítači. Otevřete ho takto:

Mac — stiskněte ⌘ + Mezerník, napište Terminal a stiskněte Enter.
Windows — stiskněte klávesu Start, napište PowerShell a stiskněte Enter.

V tomto okně nahraďte YOUR_TOKEN tokenem, který jste dostali od Flowsmithu, vložte řádek z boxu ① a stiskněte Enter. Pokud vše proběhlo správně, uvidíte něco jako:

{ "ok": true, "created": true, "site": "photorobot", "form": "contact" }

Your form is now live the instant that line runs — there's nothing to publish or wait for.

Krok 3Přidejte formulář na stránku

Vložte HTML z boxu ② do své webové stránky na místo, kde se má formulář zobrazit. Pokud váš nástroj pro tvorbu webu nabízí blok „embed“ nebo „custom HTML“, je to správné místo. Dva řádky <script> nahoře stačí mít na stránce jen jednou.

A je hotovo. Odeslání dorazí do vaší schránky a bezpečně se uloží — filtrování spamu, kontrola „Nejsem robot“ i vše ostatní už je zařízené za vás.

Dvě běžné situace

Stejný formulář na více stránkách

Chcete jeden kontaktní formulář na domovské stránce, stránce O nás i v patičce — a všechno má chodit na stejné místo? Definujte ho jednou (jedním průchodem kroků 1–2) a stejný snippet z boxu ② vložte na každou stránku. Všechna odeslání budou chodit do stejné schránky a v administraci se zobrazí pohromadě. Jen se ujistěte, že každá webová adresa, na které tyto stránky běží, je uvedená v poli „Adresa vašeho webu“.

Jiný formulář pro jednu sekci

Řekněme, že sekce Akademie potřebuje jiný formulář — jiná pole, možná jinou schránku. Vytvořte druhý formulář s vlastním názvem v poli „K čemu formulář slouží?“ (např. academy), vlastními poli a e-mailem, a tento snippet vložte na stránky Akademie. Jeden web může mít libovolný počet formulářů; každý je samostatný.

Prefer the terse version, or want the raw HTTP API? See the quick reference.