Documentation

Pentangle Connect for Stora

Connect is the broker between your Stora account and the products your customers use: the website plugin or embed, and the tenant mobile app. Stora OAuth credentials are never stored in WordPress or on the device.

These products are provided by Pentangle and are not built, owned, or operated by Stora.

What this covers

• WordPress plugin - install, connect, embed, settings
• Website embed - Wix, Webflow, Duda and other hosts
• Tenant mobile app - branding, listing, what lives in Stora
• Custom work - bespoke flows and CRM

WordPress plugin

The plugin embeds a branded quote and booking widget on your site. It connects to Stora through the Pentangle Connect broker.

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

1. Install Pentangle Connect for Stora from the Stora app directory, or upload the plugin folder to /wp-content/plugins/.
2. Activate the plugin from Plugins in WordPress admin.
3. 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

1. Go to Settings → Pentangle Connect and open the Connection tab.
2. Click Connect to Stora. You are redirected to Stora to log in and approve access.
3. After approval, you return to WordPress with the connection saved. The connected Stora operator name is shown on the Connection tab.
4. Click Sync catalog to pull deal stages, locations, and unit types from Stora.
5. On the Booking tab, set Default deal stage ID (required for lead submissions). Stage IDs are listed after a catalog sync.
6. 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:

1. Location - choose a site (skipped when only one location is available or preselected).
2. Units - browse unit types, pricing, and availability.
3. Details - enter contact information and optional questionnaire answers.
4. Quote - review and submit. A Stora contact and deal are created.
5. 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.

Website embed (non-WordPress)

If the site is on Wix, Webflow, Duda, Squarespace or a custom stack, we do not install a WordPress plugin. We host the same booking flow and you paste an embed snippet on the page where quotes should appear.

• The snippet is a small script plus a placeholder element. Your agency can drop it in.
• The flow is served over HTTPS on a Connect host, styled to your brand, with live Stora catalog data.
• Checkout still uses Stora hosted payment when you enable it - same webhook behaviour as WordPress.
• We set connection, catalog filters and appearance with you. There is no WordPress admin screen on these hosts.

Need the widget on both WordPress and another site? That is two surfaces on the same Stora operator - talk to us about how we bill and connect them.

Tenant mobile app

Connect for Mobile is a branded template app. We apply your name, icon, splash, colours and feature flags, then list it on the App Store and Google Play under your account. It is not a unique custom-designed app unless you commission that work.

What tenants can do

• See units, move-in dates and site details from Stora
• Unlock (when you enable the access mode you use: demo, PIN or QR)
• View subscriptions and open invoices linked to Stora
• Photograph unit contents - inventory is stored in the app, not written back to Stora

What we set up

• Bundle ID, deep link scheme, App Store / Play listing assets
• Stora OAuth and magic-link sign-in through the same Connect broker
• TestFlight and Play internal testing before the public listing

Feature flags (inventory, unlock, unit map, add service, portal webview) are decided with you before we ship a build. Changing flags later is a new build, not a WordPress setting.

Product detail is on the mobile page. The tenant app is POA — ask us on pricing.

Custom booking flows and CRM

The plugin and embed cover the standard quote-to-deal path. If you need a different journey (multi-brand sites, unusual pricing, extra steps) or leads in Pipedrive, HubSpot or another CRM as well as Stora, that is scoped as custom work.

Get in touch with the CMS, Stora sites and any other systems involved.

Troubleshooting

• Widget empty or old prices - Sync catalog, then Clear cache. Confirm the deal stage ID is still valid.
• Connect button does nothing - pop-up blockers and mixed HTTP/HTTPS will stop OAuth. The WordPress site must be HTTPS in production.
• Checkout cancel URL rejected - Stora requires an HTTPS return URL.
• Leads missing in Stora - check Default deal stage ID, then Test connection. Questionnaire answers appear as a contact note, not as deal fields.
• App cannot sign in - confirm the operator is connected in Connect and that the bundle’s API base URL matches the environment you authorised.

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.