Fergus Booking Forms

Put the Fergus booking form on your website

4 min read Fergus booking form

The Embed tab holds everything that puts the form on a page of your website: two lines of code, a shortcode for the Formpiece WordPress plugin, the form's ID, and settings for Wix. Paste once. After that every change you save reaches the page without touching the code again.

Before you start

  • The form has to be Ready. Until the services and staff steps are done, the tab says "Finish setting up before you put this on your website" and lists what is left. See Use the setup checklist.
  • You need to be able to edit the page's HTML, or install a WordPress plugin, or edit a Wix page.
  • An archived form has no Embed tab.

Step by step

With embed code

  1. Open your form from Forms and click the Embed tab.
  2. Under Embed Code, click Copy code beside Default embed code. If your customers are UK based, copy UK embed code - if your customers are UK based. instead.
  3. Paste it into the page's HTML where the form should appear.
  4. Publish the page and open it to check the form loads.

The code is a <script> line that loads the form and a <div id="FPForm"> carrying your form's ID in data-id. The UK code adds data-region="uk" to the div.

With the WordPress plugin

  1. Under WordPress Plugin, click Download WordPress Plugin and install it in WordPress. It needs version 1.4.0 or later for Fergus booking forms.
  2. Paste the shortcode into the page or post where the form belongs. It looks like [fp_fergusbookingform form_id="..."], and the UK shortcode adds region="uk".

You can also copy the Form ID from the tab and choose Fergus Service Booking Form under Settings, Formpiece in WordPress.

With Wix

Under Wix, follow the numbered steps. They need a Wix Premium plan with a connected domain. The form only appears on the published site, and the editor preview shows "The Formpiece form could not be loaded." The steps use a Custom Element with the server URL on the page, the tag name formpiece-form, and two attributes: form-type set to fergus-booking and form-id set to your form's ID. Add region set to uk for UK customers.

Copying the code counts as putting it live

Copying the embed code, the shortcode or the Form ID with its Copy button ticks the Put it on your website step of the checklist. Formpiece can't see your website, so it records the copy and nothing more. A form that has taken a booking counts as published either way.

Show the code anyway on the held-back screen is for a developer building the page ahead of time. The code then shows with a notice that customers will see only the services that have staff, or no services, until the missing steps are done.

Testing the form

The Preview button at the side of each page shows the form as customers see it. The panel warns "Bookings made here are real. A booking creates a job in Fergus and emails your recipients. Use a name and email of your own."

Saving publishes

Saving on any page of the form publishes it. There is no separate step, and customers see the change the next time they load the page. See Create, archive and publish forms.

When it goes wrong

Nothing appears where I pasted the code

  • The form is archived. Archiving takes it off your website straight away. Unarchiving publishes it again.
  • The page editor removed the <script> line. The form can't load without it.
  • A UK account is using the default code. Use the UK embed code, or the UK shortcode.

The form loads but offers nothing to book

It has no services, or no service has anyone to take it. Open the form's checklist.

The WordPress shortcode shows as text

The plugin isn't installed or active, or is older than version 1.4.0.

Wix says "The Formpiece form could not be loaded."

You are looking at the editor preview. Publish the site and open the live page.

The form shows an old version of a setting

The form is out of date until it is published again. Click Publish again on the form.

FAQ

Does embedding need a subscription?

No. The Embed tab is the same on every plan.