=== MKM Digital Connector for passFLY.PRO ===
Contributors: dgmaximiliano
Tags: wallet, apple-wallet, google-wallet, tickets, events
Requires at least: 5.8
Tested up to: 7.1
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress forms to passFLY to generate Apple Wallet and Google Wallet digital passes, QR code check-in, and automated notifications.

== Description ==

**MKM Digital Connector for passFLY.PRO** connects your WordPress website with the **passFLY.PRO** digital pass and ticketing platform. 

It seamlessly integrates with popular WordPress form builders (Elementor Forms, WPForms, Contact Form 7, and Gravity Forms) to automatically generate digital tickets for **Apple Wallet** (.pkpass) and **Google Wallet**.

When an attendee registers through your website form, this plugin creates a branded digital pass complete with a unique QR code for real-time check-in. The attendee can instantly add the pass to their smartphone wallet, receive automated SMS/Email confirmations, or access a split-screen mobile pass landing page.

### Key Features

* **Apple Wallet & Google Wallet Passes:** Native digital passes with live push updates.
* **Instant Form Integration:** Native support for Elementor Pro Forms, WPForms, Contact Form 7, and Gravity Forms.
* **Real-time Mobile Scanner:** Staff check-in scanner accessible via magic link with camera QR reader.
* **Split-Screen Landing Pages:** Responsive landing page displaying pass download links and QR codes.
* **Automated Reminders:** Scheduled email/SMS reminders before the event starts.
* **Offline Resilient Queue:** Background retry queue ensuring zero lost registrations even during temporary connectivity drops.
* **Clean Database Hygiene:** Opt-in total data cleanup upon uninstallation.

---

### Important: Reliance on Third-Party Service

This plugin is a connector to the **passFLY.PRO SaaS platform** (`https://passfly.pro`). 

In order to securely sign Apple Wallet (.pkpass) and Google Wallet passes, encrypt pass certificates, send transactional SMS/Email notifications, and synchronize check-in scanner data, the plugin transmits attendee information to the passFLY external API.

* **Data Transmitted:** Attendee Name, Surname, Email address, Phone number, and Event registration details.
* **Third-Party Service:** [passFLY.PRO](https://passfly.pro)
* **Terms of Service:** [https://passfly.pro/terms/](https://passfly.pro/terms/)
* **Privacy Policy:** [https://passfly.pro/dichiarazione-sulla-privacy-ue/](https://passfly.pro/dichiarazione-sulla-privacy-ue/)
* **Cookie Policy:** [https://passfly.pro/cookie-policy-ue/](https://passfly.pro/cookie-policy-ue/)

A free passFLY account is required. When registering directly from the plugin settings page, you receive **10 free tickets/SMS** to test all features. Additional ticket packs can be purchased through your passFLY account.

== Installation ==

1. Upload the `mkm-digital-connector-for-passfly` folder to the `/wp-content/plugins/` directory, or install it via the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to **passFLY > Licenza & Ricariche** in your WordPress admin menu.
4. Register your profile (B2B Agency or B2C Individual) to receive 10 free test credits, or enter your existing API Key.
5. Create your event under **passFLY > Nuovo Evento** and map your form fields.

== Frequently Asked Questions ==

= Do I need a passFLY account? =
Yes. You can register for a free account directly within the plugin admin page under **Licenza & Ricariche** and receive 10 free credits to test the service.

= Which form plugins are supported? =
passFLY supports Elementor Pro Forms, WPForms, Contact Form 7, and Gravity Forms out of the box.

= How do staff members scan tickets at the door? =
Under the **Licenza & Ricariche** settings or inside each event, you will find a **Magic Link SCANNER**. Share this link with your staff to turn any smartphone browser into a camera QR code scanner with zero app installation needed.

= Does this plugin leave orphan data in the database when deleted? =
No. passFLY adheres to clean database standards. You can enable the "Elimina tutti i dati" option in settings to ensure complete removal of options and queues upon uninstallation.

== Screenshots ==

1. Account & Licenza - Registrazione profilo, gestione crediti e Magic Link per lo scanner all'ingresso.
2. Anteprima Pass - Personalizzazione grafica e anteprima su Google Wallet.
3. Anteprima Pass - Personalizzazione grafica e anteprima su Apple Wallet.
4. Integrazioni Form - Selezione del plugin form (Elementor, WPForms, CF7, Gravity Forms).
5. Modalità Consegna - Scelta tra visualizzazione Landing Page del pass o invio immediato via SMS.
6. Mappatura Campi - Configurazione e mappatura automatica dei campi anagrafici dal form.
7. Comunicazione SMS - Personalizzazione del testo del messaggio e test gratuito dell'anteprima.
8. Email & Automazioni - Configurazione promemoria automatici via email pre-evento.
9. Gestione Iscritti - Elenco partecipanti, statistiche di check-in, esportazione CSV e aggiornamento presenze in tempo reale.

== Changelog ==

= 1.0.0 =
* Initial official release on WordPress.org.
* Full compatibility with WordPress 7.1.
* Native Apple Wallet and Google Wallet generation.
* Support for Elementor Forms, WPForms, Contact Form 7, and Gravity Forms.
* Local asset bundling for full GDPR compliance.
