=== SSSVenuePass - Event Ticketing System ===
Contributors: sssvenuepass
Tags: tickets, events, ticketing, venue, qr code, stripe, booking
Requires at least: 5.8
Tested up to: 6.4
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A comprehensive multi-venue event ticketing system with seat selection, Stripe payments, QR code tickets, and mobile scanning.

== Description ==

SSSVenuePass is a complete ticketing solution for venues, event organizers, and entertainment businesses. Manage multiple venues, create events with various formats, sell tickets online, and validate entries with QR code scanning.

**Key Features:**

* **Multi-Venue Support** - Manage multiple venues with different spaces and layouts
* **Flexible Event Formats** - Reserved seating, general admission, hybrid, timed entry, multi-session
* **Interactive Seat Selection** - Visual seat maps for customers to choose their seats
* **Stripe Payment Integration** - Secure payment processing with automatic ticket generation
* **QR Code Tickets** - Digital tickets with QR codes for easy validation
* **Mobile Scanner** - Camera-based ticket scanning for staff at venue entrances
* **Add-ons & Extras** - Sell parking, food vouchers, merchandise with tickets
* **Custom Checkout Fields** - Collect attendee information with custom forms
* **Role-Based Access** - Super Admin, Venue Admin, Box Office, Event Staff, Scanner roles
* **Comprehensive Reporting** - Revenue, attendance, and sales analytics

**Customer Features:**

* Browse events by category, date, or venue
* Interactive seat selection with section view previews
* Secure checkout with Stripe
* Digital tickets delivered via email
* "My Tickets" page to view and manage purchases
* Mobile-friendly design throughout

**Admin Features:**

* Dashboard with key metrics and recent activity
* Venue management with spaces and layouts
* Visual layout builder for seat maps
* Event creation wizard with all format options
* Order management with refund capabilities
* Real-time scanning logs and attendance tracking
* Detailed revenue and sales reports

== Installation ==

1. Upload the `sss-venuepass` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to SSSVenuePass > Settings to configure Stripe keys
4. Create your first venue under SSSVenuePass > Venues
5. Create events and start selling tickets!

**Stripe Setup:**

1. Create a Stripe account at https://stripe.com
2. Get your API keys from the Stripe Dashboard
3. Enter your Publishable Key and Secret Key in plugin settings
4. For webhooks, add your site URL + `/wp-json/sssvp/v1/stripe-webhook`

== Frequently Asked Questions ==

= Do I need a Stripe account? =

Yes, Stripe is required for payment processing. You can sign up for free at stripe.com.

= Can I use this for free events? =

Yes! You can create events with $0 tickets for free admission while still using the QR code validation system.

= How do customers receive their tickets? =

Tickets are automatically emailed after successful payment. Customers can also view tickets in their "My Tickets" page.

= Can staff scan tickets on mobile devices? =

Yes! The scanner interface is fully mobile-optimized and works with any device camera.

= Does this work with my theme? =

SSSVenuePass uses shortcodes that work with any theme. The styling is designed to be compatible with most themes.

== Screenshots ==

1. Customer event listing page
2. Event detail with ticket selection
3. Checkout page
4. Digital ticket with QR code
5. Admin dashboard
6. Venue layout builder
7. Mobile scanner interface

== Changelog ==

= 1.0.0 =
* Initial release
* Multi-venue support
* Event management with multiple formats
* Stripe payment integration
* QR code ticket generation
* Mobile scanner interface
* Customer account pages
* Admin dashboard and reporting

== Upgrade Notice ==

= 1.0.0 =
Initial release of SSSVenuePass ticketing system.