Introduction

The Event Builder Booking System allows visitors to reserve free or paid event tickets through a modern, user-friendly booking experience. It includes purchaser information, attendee management, coupon support, payment summaries, QR tickets, and an administrator dashboard for managing every booking.

The booking system is fully integrated with the Event Builder plugin and can be enabled individually for each event.

---

Booking Workflow

The complete booking process follows these steps:

1. Visitor opens an event.
2. Clicks Book Tickets.
3. Selects ticket quantity.
4. Completes purchaser information.
5. Adds attendee information.
6. Applies a coupon (optional).
7. Reviews the payment summary.
8. Submits the booking.
9. Booking is stored in WordPress.
10. Individual attendee records are created.
11. QR tickets are generated automatically.
12. Administrator manages bookings from the dashboard.

---

Enable Event Booking

Booking can be enabled or disabled for every event individually.

Enable Booking

When enabled:

• Book Tickets button appears.
• Booking popup is available.
• Visitors can purchase tickets.

Disable Booking

When disabled:

• Booking button is hidden.
• Visitors see a “Booking Not Available” message.
• Event remains viewable.

---

Booking Types

Event Builder supports two booking modes.

Free Booking

Visitors can register without payment.

Features include:

• Unlimited registrations
• Attendee tracking
• QR ticket generation
• Check-in management

---

Paid Booking

Visitors purchase tickets before completing registration.

Includes:

• Ticket pricing
• Quantity selection
• Payment summary
• Coupon support
• Booking confirmation

---

Ticket Quantity Selection

Visitors choose how many tickets they wish to purchase before proceeding to the booking form.

Features include:

• Plus / Minus controls
• Maximum ticket limits
• Live subtotal calculation
• Dynamic payment summary

---

Purchaser Information

The purchaser is the person completing the booking.

Required fields include:

• Full Name
• Email Address
• Phone Number
• Event Date

The purchaser receives the booking confirmation and payment information.

---

Attendee Information

Each ticket can belong to a different attendee.

For multiple tickets, an accordion interface keeps the booking form clean and organized.

Each attendee includes:

• Full Name
• Email Address
• Phone Number
• Gender
• Age

Each attendee receives:

• Unique attendee record
• Individual QR ticket
• Unique ticket number

---

Event Date Selection

For multi-day events, visitors can choose the desired event date.

Features include:

• Dropdown selection
• Automatically generated dates
• Required validation

---

Coupon System

Customers can apply promotional coupon codes during checkout.

Features include:

• Instant validation
• AJAX processing
• Live discount updates
• Invalid coupon messages
• Total recalculation

---

Payment Summary

A sticky payment summary keeps visitors informed while completing the booking.

The summary displays:

• Ticket Price
• Number of Tickets
• Subtotal
• Coupon Discount
• Total Payable

Values update automatically whenever coupons or ticket quantities change.

---

Form Validation

The booking form includes comprehensive client-side validation.

Purchaser Validation

Validates:

• Full Name
• Email Address
• Phone Number
• Event Date

---

Attendee Validation

Each attendee is validated individually.

Checks include:

• Name
• Email
• Phone Number
• Gender
• Age

Accordion sections automatically expand when validation errors are detected.

---

Phone Number Validation

Phone numbers use international validation.

Features:

• Country selector
• Automatic country detection
• Country dialing codes
• International formatting
• Real-time validation

---

Name Validation

The booking form validates names by ensuring:

• Required field
• Alphabetic characters only
• No numbers
• No invalid symbols
• Minimum character length
• Maximum character length

---

Email Validation

Email validation includes:

• Proper email format
• Required field
• Invalid email detection

Examples:

✓ john@example.com

✓ support@company.com

✗ john@

✗ example.com

---

Age Validation

Age validation ensures:

• Numbers only
• Required field
• Range between 1 and 120

---

Gender Validation

Gender selection is mandatory.

Available options:

• Male
• Female
• Other

---

QR Ticket Generation

After a successful booking, QR tickets are created automatically.

Each attendee receives:

• Unique QR Code
• Ticket Number
• Booking Reference
• Event Information

QR tickets are used during event check-in.

---

Ticket Numbers

Every attendee receives a unique ticket number.

Example:

TKT-1024-001

Ticket numbers simplify attendee verification and administration.

---

Booking Confirmation

After a successful booking:

• Booking is stored.
• Purchaser information is saved.
• Attendee records are created.
• QR tickets are generated.
• Payment information is recorded.
• Booking status is updated.

---

Booking Dashboard

Administrators can manage every booking directly from WordPress.

The booking details screen includes:

• Booking Number
• Customer Information
• Event Information
• Booking Date
• Event Date
• Ticket Quantity
• Total Paid
• Booking Status
• Payment Status

---

Attendee Management

Each booking contains one or more attendees.

Administrator can view:

• Name
• Email
• Phone
• Gender
• Age
• Ticket Number
• QR Status
• Check-in Status

---

Booking Status

Bookings can have different statuses.

Common statuses include:

• Pending
• Confirmed
• Cancelled
• Completed
• Checked In

---

Event Capacity

The booking system automatically tracks event capacity.

Features include:

• Available seats
• Booked seats
• Remaining tickets
• Sold Out detection

Bookings automatically stop when capacity is reached.

---

Sold Out Events

When no tickets remain:

• Book Tickets button is disabled.
• Sold Out message appears.
• Visitors cannot create new bookings.

---

Booking Security

The booking system uses WordPress security standards.

Security features include:

• Nonce verification
• Sanitized inputs
• Escaped outputs
• Secure booking tokens
• Protected QR validation
• Duplicate check-in prevention

---

Responsive Design

The booking interface is fully responsive.

Optimized for:

• Desktop
• Laptop
• Tablet
• Mobile devices

---

Booking Features Overview

✔ Free & Paid Events

✔ AJAX Booking

✔ Ticket Quantity Selector

✔ Multiple Attendees

✔ Purchaser Information

✔ Individual Attendee Details

✔ Gender & Age Collection

✔ Event Date Selection

✔ Coupon Support

✔ Sticky Payment Summary

✔ International Phone Validation

✔ QR Ticket Generation

✔ Ticket Numbers

✔ Booking Dashboard

✔ Attendee Management

✔ Event Capacity Tracking

✔ Sold Out Protection

✔ Responsive Design

---

Best Practices

For the best booking experience:

• Configure event capacity before publishing.
• Set ticket prices carefully.
• Test coupon codes before launch.
• Verify booking emails and QR ticket generation.
• Regularly monitor attendee check-ins.
• Keep booking statuses updated for accurate reporting.

---

Troubleshooting

Booking button is not visible

• Ensure Enable Booking is enabled for the event.
• Verify tickets are available.
• Confirm the booking form page exists.

---

Coupon code is not applied

• Verify the coupon is active.
• Check coupon expiration.
• Ensure minimum purchase requirements are met.

---

QR ticket not generated

• Confirm the booking completed successfully.
• Verify attendee records were created.
• Check file permissions in the uploads directory.

---

Phone validation fails

• Enter the complete phone number.
• Select the correct country.
• Include the national number without unnecessary characters.