Documentation / Getting started
Getting started
Bonjour la toile adds modules to your site: a form, a quiz, a row of reactions, a menu, a booking calendar. You create an account, register your site, prove that it belongs to you, then paste two lines of HTML on the page that should show the module.
The five steps
- Create your account on the Create my account page: a username, an email address and a password of at least twelve characters. Nothing else: the account opens right away, and you can add your site straight after. The address is used to let you know when your modules receive something, and to get you back in if you lose your password.
- Add your site from My account: a name (it is only for you) and its address, for example
example.com. You can paste the full address, we only keep the domain. - Prove that it belongs to you. You land directly on the site's "Ownership" screen. Three proofs to choose from: a file to upload, a line to paste into your page, or a DNS record. See Proving the site is yours.
- Add a module. Once the site is verified, the table on the "Modules" screen enables the "Add" buttons. Then open the module to build your form, your quiz or your palette; the code to paste is waiting in its "Embed" tab.
- Paste the code on the page of your site that should show the module. See Embedding a module and On your platform.
The getting-started checklist
Until your first module shows up on your site, My account opens on a "Your first steps" list that walks through these steps in order. You do not check anything yourself: each box checks itself when the step is really done. The last one, "Paste the code on your page", only checks once your module has been shown on a page of your site; opening that page once after pasting the code is enough.
The current step carries a button that leads straight to the screen where to act, and a link to the help page that explains it. With several sites, the list follows the one that is furthest along.
The list disappears on its own when everything is done. The "I know this, hide it" button puts it away earlier; "Review my first steps", at the bottom of My account, brings it back as long as the journey is not finished.
Every editor has a "Preview" button, at the top, that opens the module on its own in a new tab. It is the simplest way to check what your visitors will see before touching your site.
The vocabulary
| Word | What it means |
|---|---|
| Site | A domain you have registered, for example example.com. An account can hold five on the free plan, twenty-five on the paid one. |
| Module | What can be added to a site: Forms, Quiz, Booking, Events, Menu, Reviews, Hours, Reactions. |
| Add | Plug a module into a site. "Remove" unplugs it without deleting anything: your settings and what you received stay in place. |
| Public key | The site's identifier in the code to paste, in the form pk_ followed by 24 characters. It can stay visible in your page. |
| Reference | The short name of a form, a quiz or a palette. The code in the "Embed" tab already carries it: it shows that object, and no other. |
| Style | The look of your modules: colors, fonts, logo. See Styles. |
A site's screens
In My account, every site has three screens:
- Modules: a table, one row per module in the catalog. Add, remove, and open the one you want to set up.
- Ownership: the proof that the site is yours.
- Settings: the public key, the site's name, and the addresses where your modules are allowed to show.
The left column of your account also carries My inbox (the replies to your forms), My styles and Account settings.
A site's objects, and their tabs
An added module can hold several objects: several forms, several quizzes, several reaction palettes. The site's screen lists them all, across modules, with whether each one is live. Each module's button, in the table below, creates a new one.
Opening one gives up to four tabs:
- Edit: what your visitors will see. For reviews, this first tab is called Reviews: it is the queue of reviews received.
- Responses, Results, Appointments or Numbers, depending on the module: what came in. Hours, menus, events and reviews do not have this tab.
- Embed: the two lines to paste, with a "Copy the code" button, and the link to your styles.
- Settings: what you change least often.
The More menu, at the top of the object, puts it live or takes it offline, and deletes it.