Frequently asked questions
Pentangle Connect for Stora · WordPress plugin
General
Is this an official Stora product?
No. Pentangle Connect for Stora is built and maintained by Pentangle. It integrates with the Stora Public API. Stora does not build, own, or operate this plugin.
What does the plugin do?
It embeds a branded quote and booking widget on your WordPress site. Customers browse your Stora locations and unit types, submit enquiries, and optionally complete payment through Stora hosted checkout. Leads are created as contacts and deals in your Stora account.
What are the system requirements?
WordPress 6.4+, PHP 8.2+ with OpenSSL, and a Stora operator account. Your site should use HTTPS if you enable hosted checkout.
Connection and security
Do I need to configure OAuth credentials in WordPress?
No. The plugin uses the Pentangle Connect broker at https://pentangle-connect.com. Stora OAuth credentials are stored on the broker, not in WordPress. Click Connect to Stora in Settings → Pentangle Connect and approve access in Stora BackOffice.
What OAuth scopes are required?
Scopes are requested and managed by the broker during partner onboarding — you do not configure them in WordPress. When you connect, Stora shows the permissions your integration needs (reading sites and units, creating contacts and deals, orders, webhooks, and related access). Approve the request to complete setup.
Where are tokens stored?
WordPress stores only an encrypted broker token. Stora access and refresh tokens live on https://pentangle-connect.com and are never written to your WordPress database. This follows Stora's recommended broker pattern for distributed plugins.
Do I need to edit wp-config.php?
Not for a standard install. Broker URL and registration credentials are bundled with the
plugin. Overrides in wp-config.php or the Advanced settings tab are only needed
for staging environments, key rotation, or agency-managed deployments.
How do I reconnect or switch Stora accounts?
Open Settings → Pentangle Connect → Connection and click Reconnect. Complete the Stora authorisation flow again. Use Disconnect to revoke access entirely.
Connection failed or shows "reconnect required"
This usually means the Stora grant was revoked in BackOffice, or the refresh token expired. Click Reconnect and authorise again. If problems persist, try Disconnect, then Connect to Stora, followed by Sync catalog and Test connection. Enable debug logging on the Advanced tab and check your PHP error log for details.
Configuration
How do I find deal stage IDs?
On the Connection tab, click Sync catalog. Deal stages
are listed on the Booking tab next to Default deal stage ID.
Copy the dstg_… ID for the stage where new web leads should land.
How do I preselect a location?
Use the shortcode attribute site_id on location pages:
[stora_booking site_id="site_xxxxxxxx"]You can also set a Default site ID on the Booking tab, or preselect a site in the Gutenberg block settings.
How do I limit which units or locations appear?
After syncing the catalog, open the Catalog tab. Hide entire locations with Hide from widget, or check specific unit types to limit what customers can book. Leave all unit types unchecked to show everything Stora marks as bookable.
Can I customise the form fields?
Yes. On the Form fields tab, set each field to hidden, optional, or required. You can also add a custom questionnaire — answers are saved as a note on the Stora contact.
How do I match the widget to my brand?
Use the Appearance tab to set colours, font family, and custom CSS. The widget inherits your theme font when font family is left blank.
Checkout and payments
How does hosted checkout work?
Enable Stora hosted checkout on the Booking tab (or pass
checkout="true" in the shortcode). After a deal is created, the customer is
redirected to Stora to pay. When payment completes, a webhook updates the deal — optionally
moving it to your configured Deal stage after checkout.
What URL should I use for checkout cancel?
Set a cancel page or HTTPS URL on the Booking tab. Stora requires HTTPS for checkout return URLs in production.
Quotes and emails
Can customers receive a quote by email?
Yes. On the Post-submit tab, enable Send quote email and
choose the page that contains your booking shortcode (used for the reserve link). You can
customise the subject, body, and logo. Placeholders such as {first_name},
{quote_details}, and {reserve_link} are supported.
What happens after a customer submits an enquiry?
A Stora contact and deal are created. By default the widget shows an inline thank-you message. You can redirect to a thank-you page instead, or send a quote confirmation email as described above.
Operations
How often should I sync the catalog?
Sync after connecting for the first time, whenever you add locations or unit types in Stora, or when deal stages change. Day-to-day availability is fetched live; the catalog sync is mainly for admin configuration (stage IDs, unit type lists, and visibility rules).
When should I clear the cache?
Use Clear cache on the Connection tab if you see stale pricing or availability during testing. For high-traffic sites, increase cache TTL on the Advanced tab.
Does the plugin work with multiple Stora sites?
Yes. When your Stora account has multiple locations, customers choose a site in the widget
unless you preselect one with site_id or hide locations on the Catalog tab.
Support
Where can I get help?
Full setup instructions are in the documentation. For support, contact Pentangle or email hello@pentangle.co.uk.