Documentation

Pentangle Connect for Stora · WordPress plugin

Pentangle Connect for Stora is a WordPress plugin that embeds a branded quote and booking widget on your site. It connects to your Stora account through the Pentangle Connect broker — Stora OAuth credentials are never stored in WordPress.

This plugin is provided by Pentangle and is not built, owned, or operated by Stora.

Requirements

WordPress 6.4 or later
PHP 8.2 or later with OpenSSL enabled
A Stora operator account with permission to authorise third-party integrations
HTTPS on your WordPress site (required for hosted checkout)

Installation

Install Pentangle Connect for Stora from the Stora app directory, or upload the plugin folder to /wp-content/plugins/.
Activate the plugin from Plugins in WordPress admin.
Open Settings → Pentangle Connect.

Broker URL and registration credentials are bundled with the plugin. Most operators do not need to edit wp-config.php.

Connect to Stora

Go to Settings → Pentangle Connect and open the Connection tab.
Click Connect to Stora. You are redirected to Stora to log in and approve access.
After approval, you return to WordPress with the connection saved. The connected Stora operator name is shown on the Connection tab.
Click Sync catalog to pull deal stages, locations, and unit types from Stora.
On the Booking tab, set Default deal stage ID (required for lead submissions). Stage IDs are listed after a catalog sync.
Click Test connection to confirm everything is working.

Authentication uses the broker pattern recommended by Stora: your site holds only a broker token. Stora access and refresh tokens are stored securely on https://pentangle-connect.com and refreshed automatically.

Embed the booking widget

Add the widget to any page or post using either method below.

Shortcode

[stora_booking]

Preselect a location on location-specific pages:

[stora_booking site_id="site_xxxxxxxx"]

Override the checkout setting for a single page:

[stora_booking checkout="true"]

Gutenberg block

In the block editor, add the Pentangle Connect Booking block. Configure site preselection and checkout in the block sidebar.

Booking flow

Customers move through a multi-step wizard:

Location — choose a site (skipped when only one location is available or preselected).
Units — browse unit types, pricing, and availability.
Details — enter contact information and optional questionnaire answers.
Quote — review and submit. A Stora contact and deal are created.
Checkout — optional, when hosted checkout is enabled. The customer is redirected to Stora to pay.

Questionnaire answers are saved as a note on the Stora contact so your team can read them in BackOffice.

Settings reference

All configuration is under Settings → Pentangle Connect.

Connection

Connect / Reconnect / Disconnect — authorise, re-authorise, or revoke the Stora connection.
Test connection — verify the broker link and operator details.
Sync catalog — refresh deal stages, sites, and unit types from Stora.
Clear cache — flush locally cached Stora API responses.

Booking

Partner name — shown to customers (defaults to your site name).
Default site ID — used when the shortcode does not specify a site.
Default deal stage ID — required. New leads are created in this stage.
Deal stage after checkout — optional. Moves the deal when Stora confirms payment.
Default billing period — weekly, monthly, and other Stora billing options.
Move-in date window — minimum and maximum days from today that customers can select.
Progress steps — customise step labels and icons in the widget header.
Stora hosted checkout — redirect customers to Stora payment after deal creation.
Cancel redirect — page or URL when a customer cancels checkout.

Catalog

Hidden sites — exclude locations from the widget (useful when Stora still returns hidden sites).
Availability display — show an availability badge, or hide unavailable unit types.
Visible unit types — limit which unit types appear. Leave all unchecked to show everything bookable.
Unit selection cards — choose which details appear on unit cards (price, promotion, dimensions, and so on).

Form fields

Set each field to hidden, optional, or required: full name, phone, address line 1, city, postal code, and country.

Questionnaire — add optional custom questions on the details step. Answers are stored as a Stora contact note.

Appearance

Primary, secondary, and button colours
Font family (inherits from your theme when blank)
Custom CSS scoped to .pentangle-connect-widget

Post-submit

After lead submission — show an inline thank-you message or redirect to a page.
Quote confirmation email — optionally email customers when they request a quote, with a link back to the Reserve step.

Advanced

Broker URL / registration key — only if Pentangle provides updated broker credentials (staging, key rotation, or agency-managed installs).
Cache TTL — how long Stora API responses are cached locally (minimum 60 seconds).
Debug logging — writes connection errors to the PHP error log.
GA4 events — optional Google Analytics 4 step tracking.

Optional `wp-config.php` overrides

For staging brokers, key rotation, or agency-managed installs, add these constants to wp-config.php. They take precedence over the Advanced tab:

define('PENTANGLE_CONNECT_BROKER_BASE', 'https://pentangle-connect.com');
define('PENTANGLE_CONNECT_BROKER_PLUGIN_KEY', 'your-registration-key');

Contact hello@pentangle.co.uk if you need custom broker credentials.

Disconnect and reconnect

Disconnect — revokes tokens at Stora and removes the connection from WordPress and the broker.
Reconnect — run the OAuth flow again. Use this to switch Stora accounts or re-grant scopes after a feature update.
Uninstall — the plugin disconnects automatically when removed.

Live demo

See the plugin running on a live WordPress site: demo.pentangle-connect.com

Support

Questions about setup or configuration? Contact Pentangle or email hello@pentangle.co.uk.

For Stora API reference, see the Stora Public API documentation. Common questions are answered on our FAQ page.