How do I configure the getSoapy Wordpress plugin?

Use the wordpress plugin to add getSoapy features to your wordpress website.

Installing the plugin

The getSoapy plugin is available in the wordpress plugin directory.

To install the plugin, log into your wordpress website and search the plugin directory for 'getSoapy', then click 'Install Now'.

When activated, the plugin will automatically try to configure your Business ID. If this doesn't work, you'll need to enter it manually in the plugin settings page.

Widgets

The plugin is block-enabled, allowing you to easily place the getSoapy widgets anywhere on your website.

Click the + icon in your wordpress editor and search for 'getSoapy' to add a new widget. You can also type "/getsoapy" to open the block menu and search for our widgets.

If your template does not support blocks you can use short codes to place the widgets.

Show the quote widget:
[getsoapy_quote]

Show the payment widget:
[getsoapy_pay]

Show the documents widget:
[getsoapy_documents]

The documents widget will not be displayed if no documents have Show on website enabled.

Show the customer portal widget:
[getsoapy_portal]

Settings

There are a number of customisation options available. You'll find these under the 'getSoapy' option in your plugins menu.

Business ID

This identifies your account in getSoapy. You can find this ID in the App in the "Domain & Pages" in the More section.

Hide fields

You may specify a comma separated list of field names to hide.
The following fields can be hidden: availability, frequency, building, bedrooms, and consent.

Override default styles

There are a number of styling options you can specify.\ If this is left blank, the default setting is used which is equivalent to: x-style="bg-light shadow rounded border p-3"

Padding: p-1 to p-5. Higher numbers add more padding.

Border: border adds a border to the widget.

Rounded: rounded rounds the corners of the widget.

Shadow: shadow-lg, shadow and shadow-sm add a shadow of different sizes.

Background: bg-light sets a light grey background and bg-white sets a white background.

Floating quote button

Toggle this on to show a "Request a quote" button in the bottom right hand corner on each page of your website.

Paginate quotes

To make the quote widget a better experience for your website visitors we now split it into pages by default. To show the entire form in a single page, toggle this off.

Advanced settings

You probably don't need to worry about these options, but they're available for more advanced implementations.

Disable stylesheets: If you'd prefer to take complete control over the widget styling you can disable loading any getSoapy stylesheets.
This option negates anything set in 'Override default styles'.
Plugin options: You can insert a JSON object with advanced options from the Javascript plugin.