=== StickyQR – Online Ordering, Book a Table & Membership Pass ===
Contributors: stickyqr
Tags: restaurant, online ordering, food delivery, book a table, table reservations
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add pickup and delivery ordering, table reservations, and membership passes to your restaurant website with StickyQR.

== Description ==

Turn your WordPress site into a restaurant storefront: accept online food ordering for pickup and delivery, take table reservations, and offer membership passes with QR code redemption — powered by StickyQR.

StickyQR connects your WordPress site to the StickyQR restaurant platform. After you connect a StickyQR business, you can place three customer-facing products on your site with a block, shortcode, or widget.

= Products =

* **Online Ordering** - accept pickup and delivery orders from your website.
* **Book a Table** - let guests reserve a table from your website, menu, or public booking link.
* **Membership Pass** - offer recurring food and drink perks with seamless QR redemption.

Menus, prices, passes, members, bookings, and payments are managed in StickyQR Manager. This plugin controls how the products appear on WordPress and opens StickyQR-hosted pages for the actual ordering, booking, or subscription flow.

= Placement options =

* **Block** - add a dedicated Online Ordering, Book a Table, or Membership Pass block, or use the combined StickyQR block to show multiple products together.
* **Elementor** - use the native StickyQR Elementor widgets: StickyQR, Online Ordering, Book a Table, and Membership Pass.
* **Widget** - add one product or the combined StickyQR product group to a widget area.
* **Shortcode** - use `[stickyqr_ordering]`, `[stickyqr_booking]`, `[stickyqr_pass]`, or `[stickyqr product="ordering"]`. Attributes (all lowercase) override the saved settings per placement: `label`, `shape`, `icon`, `bg_color`, `text_color` (named color or hex); the pass list also takes `layout`, `columns`, and `pass_ids`, e.g. `[stickyqr_pass pass_ids="coffee,lunch" columns="2"]`.

= Site controls =

* Connect or create a StickyQR account inside WordPress.
* Turn each product on or off from the StickyQR admin screen.
* Configure labels, icons, colors, shape, and placement defaults.
* Use per-block or per-widget appearance overrides when one placement needs a different label or style.

== External services ==

This plugin connects to StickyQR services. These connections are required for the plugin to authenticate your business, read product status, save display settings, and open the hosted customer flows.

**StickyQR API**

* Service URL: `https://app.stickyqr.com` by default. A sandbox or custom API URL may be used when configured by a site owner or developer.
* When you connect a site, the plugin sends the phone number, password or one-time code entered in the onboarding form. If you create a new account, it also sends the business name, email, and address entered in the form.
* The plugin exchanges that sign-in for a long-lived connection token for the WordPress site. The token is stored encrypted on the server and is not sent to browsers.
* While connected, the plugin reads your business profile and product status, and it saves product display settings when an administrator changes them.
* API requests include the site URL where needed for the connection, the site's domain when connecting so StickyQR can configure payment domains, plus a platform identifier (`stickyqr-wordpress`) and plugin version for integration diagnostics.

**StickyQR hosted product pages**

* Hosted product pages are loaded from `https://stickyqr.com` by default and may be shown inside a WordPress page overlay.
* Visitors use these StickyQR-hosted pages to order, book, or subscribe. Orders, bookings, memberships, redemptions, and payments are processed by StickyQR.
* Membership Pass cards may request the published pass list from StickyQR so the plugin can display selectable pass cards on your site.
* No StickyQR content is loaded on your public site by default. Hosted pages and the pass list are only requested after a site administrator explicitly connects a StickyQR account, turns a product on, and places it with a block, shortcode, widget, or the floating button setting. The plugin never adds links, credits, or branding to your site on its own.
* Hosted page URLs include an embed context marker (`context=wp-embed`), the platform identifier (`platform=stickyqr-wordpress`), and the plugin version (`plugin_version`) so StickyQR can render the embedded layout and attribute traffic to the WordPress integration. The plugin adds no visitor-identifying data to these URLs.

**StickyQR Manager links**

* Admin screens may link to `https://manager.stickyqr.com` so store owners can manage menus, prices, booking rules, passes, members, and orders.
* Opening a StickyQR Manager link does not send additional data from the plugin; it opens the StickyQR Manager site in a new browser tab.

StickyQR privacy policy: https://stickyqr.com/privacy

== Installation ==

1. Upload the `stickyqr` folder to `/wp-content/plugins/`, or install it from the WordPress Plugins screen.
2. Activate the plugin.
3. Open **StickyQR** in the WordPress admin menu.
4. Connect an existing StickyQR account or create a new one.
5. Turn on the products you want to show and configure their appearance.
6. Add products to pages with blocks, shortcodes, or widgets.

== Frequently Asked Questions ==

= Do I need a StickyQR account? =

Yes. The plugin connects WordPress to a StickyQR business. You can connect an existing account or create one during onboarding.

= Which products does the plugin add? =

It adds Online Ordering, Book a Table, and Membership Pass placements for your WordPress site.

= Where do I edit menus, prices, booking rules, and passes? =

Use StickyQR Manager. WordPress controls placement and appearance; StickyQR Manager remains the source of truth for restaurant operations and product data.

= Does it work with the block editor and page builders? =

Yes. The WordPress block editor shows the StickyQR block variations. Elementor has native StickyQR widgets. Other page builders can use the shortcodes in a shortcode/text widget.

= Does WordPress store payment details? =

No. Customer ordering, booking, subscription, QR redemption, and payment flows happen on StickyQR-hosted pages.

= Can I customize one placement without changing the defaults? =

Yes. Blocks and widgets can use the saved product defaults or an appearance override for that specific placement, and shortcode attributes override the same settings inline.

= Does it work with my theme? =

Yes. The products render as standard blocks, shortcodes, widgets, or Elementor widgets, so they work with any properly coded WordPress theme — no template changes required.

= Will it slow down my website? =

No. The frontend script and stylesheet are small, self-hosted, and only load on pages that actually display a StickyQR product. The plugin makes no CDN or external font requests.

= How do customers pay? =

Customers order, book, and subscribe on secure StickyQR-hosted pages shown in an overlay. Your WordPress site never collects or stores payment details, and the overlay allows the browser's payment request features (such as Apple Pay) where StickyQR supports them.

= How much does StickyQR cost? =

The WordPress plugin is free. It connects to a StickyQR business account — see https://stickyqr.com for current StickyQR plans and pricing.

= Is the plugin translation-ready? =

Yes. All plugin strings use the `stickyqr` text domain, a POT template ships in `languages/`, and the admin app loads script translations.

== Screenshots ==

1. Onboarding with the StickyQR logo and the three restaurant products: Online Ordering, Book a Table, and Membership Pass.
2. Overview of connected products and recent activity for your restaurant website.
3. Online Ordering setup — pickup and delivery placement controls for your restaurant website.
4. Book a Table configuration with a table reservation call-to-action preview.
5. Membership Pass cards with recurring perks and QR code redemption messaging.

== Credits ==

* Inter and Inter Tight typefaces by Rasmus Andersson — SIL Open Font License 1.1, bundled locally via the Fontsource project (no external font requests).
* Remix Icon by the Remix Design team — Apache License 2.0, icon paths bundled inline (no external icon requests).

== Changelog ==

= 1.0.0 =
First release.
