=== Soupy Experiences ===
Contributors: soupy
Requires at least: 6.5
Requires PHP: 8.0
Stable tag: 1.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your Soupy workspace and choose its public experiences in WordPress.

== Installation ==
1. Upload soupy.zip using Plugins > Add New > Upload Plugin, then activate it.
2. Open Soupy in the WordPress sidebar (or Settings > Soupy) and click Connect Soupy. Your WordPress home URL must use HTTPS.
3. Open Soupy, sign in, match the website and verification code, choose a workspace and approve.
4. Return to WordPress and click Refresh experiences.
5. Add a Soupy Experience block and select an experience. Other page builders can use the Copy shortcode button in Soupy.

Requires the corresponding Soupy WordPress connection service to be deployed. This source package does not deploy that service.
PHP OpenSSL encrypts the server credential using the site's WordPress authentication salt. Changing that salt requires reconnection.

== Supported experiences ==
Active organisation-owned Ticketing embeds (Event, Series and business), published Booking widgets, published Inbox forms and the active Lost Property form. Current Soupy source permissions and module access apply. Group-owned embeds and legacy access-mode workspaces are not supported in this version. Lists are bounded to at most the most recent 200 records per type and a read budget; incomplete results, including oversized publications, are explicitly identified.

Shortcode example (replace with the real ID from your connected list):
[soupy type="tickets" id="emb_ABCDEFGHIJKLMNOPQRSTUVWXYZ12"]

== Privacy and external service ==
This plugin connects to https://soupy.ai. Connecting sends your WordPress HTTPS home address and a random credential hash to Soupy. Approval occurs in Soupy using your existing account. WordPress stores an encrypted, read-only server credential (not in public HTML or the block editor) and selected public experience IDs. Connections expire after 180 days; reconnect to renew.

Selecting or refreshing fetches public embed IDs, internal experience names, types, scopes and saved Ticketing layout hints. Only WordPress administrators connect/disconnect; page/post editors can choose experiences authorised by the connection owner. No customer, order, payment, staff record or Soupy password is returned through the plugin API.

Visitors load Soupy's widget script and isolated iframe only on pages containing an embed. Visitor interactions and any payment are handled by Soupy, subject to the experience's own privacy and consent settings. Public embeds are public: disconnecting removes catalogue access but does not unpublish existing blocks or shortcodes. Remove them in WordPress or disable the experience in Soupy.

Disconnect in Settings > Soupy to revoke the grant. The approving user can also revoke it at https://soupy.ai/wordpress/connect. Disconnect reports any failed remote revocation so you can retry. Uninstall removes local credentials; disconnect before uninstalling. WordPress multisite installations connect independently per site.

Service information and privacy: https://soupy.ai/privacy

== Integration notes ==
A restrictive Content Security Policy must permit script-src and frame-src from https://soupy.ai, and payment in the widget iframe where needed. The plugin does not modify the host site's security headers. Page/theme containers can limit width. Soupy owns responsive sizing and saved appearance. The library uses layout illustrations, visible type categories with counts, search and Ticketing scope filters with 12 entries per page. Preview opens one noninteractive public iframe on demand, with desktop/mobile widths. It closes on removal of the experience or connection and never polls. Actual artwork and source publication rules apply in the public preview. Open live experience opens a separate interactive public page.

== Changelog ==
= 1.1.0 =
Visual experience library in settings and the block editor; scope and saved layout labels, search, filters, pagination, on-demand previews and Copy shortcode. Soupy brand icon in the sidebar and block picker. Existing Settings links and blocks remain compatible.
= 1.0.0 =
Initial account pairing, live experience selector, dynamic block and shortcode.
