=== Front of House — Collect for Stripe (Card-Present) ===
Contributors: mmulligan
Tags: event espresso, front of house, stripe, card present
Requires at least: 6.4
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 0.1.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a card-present payment method to Front of House for Event Espresso, charging cards on a Stripe reader via the Collect for Stripe app.

== Description ==

A payment-method provider for **Front of House for Event Espresso**. It registers a "Credit Card" method that takes a card-present charge at the point of sale: the station deep-links the sale out to the Collect for Stripe terminal app, the card is charged on the reader, control returns to the station, and the payment is recorded against the Event Espresso transaction.

Key points:

* **Card-present, not online checkout.** Charges happen on a physical Stripe reader at the counter, not through a web payment form.
* **Deep-link launch and return.** The method emits a redirect descriptor that opens Collect for Stripe with the sale amount and description, and reads the charge result (status, charge ID, final amount) back from the return.
* **Availability aware.** When it can determine that the Stripe Onsite payment method is not active in Event Espresso, the method advertises itself as unavailable so the station disables the button rather than launching a charge that cannot be recorded.
* **Off by default.** The card method stays hidden until you enable it in the Front of House settings, so installing the plugin never changes an existing station without an explicit opt-in.

This plugin extends Front of House for Event Espresso and does nothing on its own — it adds one method to that app's payment picker. It does not bundle or replace any Stripe integration; recording the charge relies on the Stripe Onsite payment method provided by Event Espresso's Stripe add-on.

== Installation ==

1. Install and activate Event Espresso, its Stripe add-on (with the Stripe Onsite payment method active), and Front of House for Event Espresso.
2. Pair a Stripe M2 reader or a Tap-to-Pay capable device with the Collect for Stripe app.
3. Upload this plugin to `wp-content/plugins/` and activate it.
4. In the Front of House settings, enable **Collect (card-present)**.

== Frequently Asked Questions ==

= What hardware do I need? =

A Stripe M2 reader or a Tap-to-Pay capable device running the Collect for Stripe app, plus the Stripe Onsite payment method active in Event Espresso.

= Does it work without Front of House for Event Espresso? =

No. This plugin only adds a method to that app's station payment picker. It requires both Event Espresso and Front of House for Event Espresso.

= Why is the card button disabled at the station? =

The method marks itself unavailable when the Stripe Onsite payment method is not active in Event Espresso. Activate Stripe Onsite and the button enables.

== Changelog ==

= 0.1.1 =
* Update channel + repository URLs moved to the ee-extensions org. No functional change.

= 0.1.0 =
* Initial release: card-present "Credit Card" payment method that deep-links to the Collect for Stripe app and records the result against the Event Espresso transaction.
* Off-by-default settings toggle in Front of House settings.
* Availability check that disables the method when Stripe Onsite is not active.
