Connecting a WordPress site

The DoRoutes Booking plugin puts the whole booking form on a page of your WordPress site: the price, sign-in, accepting and signing a quote, and paying. You run everything else in DoRoutes as usual. The plugin needs WordPress 6.5 or later and PHP 8.1 or later.

On a site that isn't WordPress, paste a snippet instead: see Book on any website.

1. Make an API key in DoRoutes

The plugin connects with an API key that can do one thing: connect a website.

1. In DoRoutes, open Settings → API keys. Only the Owner sees it.
2. Create a key named after your site, and tick only Connect a website.
3. Copy the key. You only see it once.

2. Fill in the plugin

Install and activate the DoRoutes Booking plugin, then open Settings → DoRoutes in WordPress:

• Slug: your firm's short name in DoRoutes, the part after admin.doroutes.com/ when you're signed in.
• API key: the key you copied. After saving, the field shows only the key's last four characters. Enter a new key to replace it.
• Website addresses: each address your site is reached on, one per line, such as https://www.yourfirm.co.uk. Your site's own address is filled in for you.
• Booking page: the page that will hold the form.
• Colour, Corner radius (0 to 24) and Font set the form's look. Tick Use the site's font to use your theme's font instead. Custom CSS styles the form further: see styling with your own CSS.

Save. The plugin connects to DoRoutes and shows Connected, or Waiting for proof.

3. Prove you own the domain

The first time, DoRoutes needs to know the domain is yours. The plugin shows a table with each Domain, its TXT record and Value. Add each record where your domain's DNS is managed, then wait for its Status to change to Found, or choose Check now. DoRoutes also checks by itself every 15 minutes for 7 days. Prove you own your website explains the record in full.

Once every domain is found, the plugin shows Connected.

4. Add the form to the page

Edit your booking page and add the shortcode where the form should appear:

[doroutes_booking]

In the block editor, use a Shortcode block. The form uses your WordPress privacy policy page for its privacy link.

reCAPTCHA

If you ask for reCAPTCHA on sign-in (Settings → Sign-in in DoRoutes), add your website's domain to your reCAPTCHA key in Google's reCAPTCHA admin console, so customers can sign in from the form on your site.

Changing or removing the connection

Save the plugin's settings again to change the addresses or the page. A new domain needs its own record before the change goes live; the current connection keeps working meanwhile.

Deactivating the plugin disconnects your site, and activating it again reconnects it. Deleting the plugin disconnects it and removes its settings. Revoking the API key in DoRoutes ends the connection too. You can also disconnect from Settings → Website → Address in DoRoutes.

While connected, customers' links from DoRoutes go to your booking page: see what connecting changes.