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 customer portal widget:
[getsoapy_portal]
Show the combined widget:
[getsoapy_combined]
Show the documents widget:
[getsoapy_documents]
The documents widget will not be displayed if no documents have Show on website
enabled.
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
, andconsent
. - 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
top-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
andshadow-sm
add a shadow of different sizes.
- Background
bg-light
sets a light grey background andbg-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.