Speed Dating Add-on Documentation

Overview

The WP Dating Addon: Speed Dating plugin extends your WordPress dating site with a speed dating event management system. Admins can create/manage events and participants; users can book tickets and use like/pass matching to find mutual matches.

Key Features

1. Event Management — Create and manage events with full details
2. Event Booking — Free or paid booking
3. Multiple Payment Gateways — Stripe / PayPal / Authorize.Net
4. Match-Making System — Like/Pass to find matches
5. Mutual Matches — View mutual likes
6. Premium Features — “Liked Me” + premium benefits
7. Email Notifications — Booking confirmations and admin alerts
8. Participant Management — View/add participants
9. Search & Filters — Search, filter, sort events
10. Responsive Design — Mobile-friendly UI

Requirements

WordPress Environment

1. WordPress: 5.0+
2. PHP: 7.4+ (8.0+ recommended)
3. MySQL: 5.6+

Required Plugins

1. WP Dating Plugin — main platform (required)
2. Elementor — optional (widgets)

Payment Gateway Addons (for paid events)

1. Stripe addon plugin
2. PayPal addon plugin
3. Authorize.Net addon plugin

Installation

Step 1: Upload and Activate

1. WordPress Admin
   a. Plugins → Add New
   b. Upload Plugin
   c. Select wpdating-addon-speed-dating.zip
   d. Install Now
   e. Activate Plugin
2. FTP
   a. Upload folder to /wp-content/plugins/
   b. WordPress Admin → Plugins
   c. Activate “WP Dating Addon Speed Dating”

Step 2: Verify Installation

1. “Speed Dating” menu appears in admin sidebar
2. Tables are created on activation
3. No admin errors

Initial Setup

Step 1: Create Required Pages (exact slugs)

1. Events List Page
   a. Pages → Add New
   b. Title: Events (or Speed Dating Events)
   c. Slug: events (must be exactly events)
   d. Publish
2. Single Event Page
   a. Pages → Add New
   b. Title: Event (or Speed Dating Event)
   c. Slug: event (must be exactly event)
   d. Publish

Step 2: Verify

1. yoursite.com/events shows the events list
2. yoursite.com/event?id=1 shows a single event (after you create one)

Admin Features

Admin Menu

1. Speed Dating → All Events
2. Speed Dating → Create Event
3. Speed Dating → Email Notification

Create / Edit Events

1. Speed Dating → Create Event
2. Configure
   a. Basic Information
   1. Event Name
   2. Description
   3. Date & Time
   4. Location
   5. Price (0 = free)
   6. Maximum Participants (optional)
      b. Target Audience
   7. Gender (multi-select)
   8. Age Range (min/max)
      c. Visual
   9. Thumbnail Image (optional)
3. Save
   a. Create Event (new)
   b. Update Event (edit)

Manage Events

1. View events: Speed Dating → All Events
   a. Name/description
   b. Date/time/location
   c. Price
   d. Participants count
   e. Actions: Edit / Delete
2. Delete event
   a. Delete → Confirm
   b. Note: bookings for that event are removed too

Manage Participants

1. View participants
   a. Speed Dating → Participants (if available)
   b. Or via event page participant section
2. Add participant manually
   a. Use “Add Participant” on event
   b. Search user
   c. Add to event

User Features

Browse Events

1. URL: yoursite.com/events
2. Tools
   a. Search: name, location, description
   b. Filters: date, price, location, gender, age
   c. Sort: date, price, name

Tabs

1. Events (upcoming)
2. Past Events (attended)
3. My Matches (mutual)
4. Liked Me (premium only)

Booking

1. Open event → Join Event / Book Now
2. Free events
   a. Confirm → booked immediately
3. Paid events
   a. Select gateway: Stripe / PayPal / Authorize.Net
   b. Pay → booking confirmed on success

Matching

1. Timing: available after 24+ hours after event time
2. Flow
   a. Open event page (must be a participant)
   b. Find Your Match section
   c. Like or Pass
3. Swipe limits
   a. Standard: up to 60% of participants
   b. Premium: unlimited
4. Results
   a. My Matches: mutual likes
   b. Liked Me: premium only

Payment Integration

Gateways

1. Stripe
2. PayPal
3. Authorize.Net

Setup

1. Stripe
   a. Install Stripe addon
   b. Enter Publishable Key + Secret Key
   c. Set currency + test mode
   d. Save
2. PayPal
   a. Enter Client ID + Secret Key
   b. Set sandbox/live
   c. Save
3. Authorize.Net
   a. Install Authorize.Net addon
   b. Enter API Login ID + Transaction Key
   c. Set test mode
   d. Save

Payment Flow

1. Select gateway
2. Redirect/form shown
3. Complete payment
4. Booking confirmed
5. Emails sent (if enabled)

Email Notifications

Configure

1. Speed Dating → Email Notification
2. Enable
   a. Send Email to Admin
   b. Send Email to User
3. Templates
   a. Admin subject/body
   b. User subject/body
4. Save Settings

Placeholders

1. {EVENT_NAME}
2. {USER_NAME}
3. {USER_EMAIL}
4. {EVENT_DATETIME}
5. {EVENT_LOCATION}
6. {EVENT_PRICE}
7. {BOOKING_DATE}

Example Templates

1. Admin Subject: New Event Booking – {EVENT_NAME}
2. Admin Body
   a. Event: {EVENT_NAME}
   b. User: {USER_NAME} ({USER_EMAIL})
   c. Date/Time: {EVENT_DATETIME}
   d. Location: {EVENT_LOCATION}
   e. Price: {EVENT_PRICE}
   f. Booking Date: {BOOKING_DATE}
3. User Subject: Event Booking Confirmation – {EVENT_NAME}
4. User Body
   a. Hello {USER_NAME}
   b. Thanks for booking {EVENT_NAME}
   c. Date/Time: {EVENT_DATETIME}
   d. Location: {EVENT_LOCATION}
   e. Price: {EVENT_PRICE}
   f. See you there

Premium Features

Benefits

1. Unlimited swipes
2. View all participants (not limited list)
3. Liked Me tab access

Premium Check

1. Uses wpee_is_premium()
2. Premium tiers recognized
   a. Premium membership
   b. Gold membership

Troubleshooting

1. Events page not showing (404/blank)
   a. Confirm slug is exactly events
   b. Page is published
   c. Clear cache
   d. Settings → Permalinks → Save Changes
2. Payment not working
   a. Gateway addon installed + active
   b. Credentials correct
   c. Test mode correct
   d. Check debug.log
   e. SSL/HTTPS valid
3. Emails not sending
   a. Admin/user emails enabled
   b. Templates not empty
   c. Check spam
   d. Consider SMTP plugin
4. Swipe not working
   a. Logged in
   b. Booking exists
   c. 24+ hours passed
   d. Check browser console errors
5. Premium features missing
   a. Membership active
   b. wpee_is_premium() working
   c. Clear cache
6. Database errors
   a. Deactivate/reactivate plugin
   b. DB permissions OK
   c. DB connection OK
   d. Review debug.log

Elementor Widgets

Widgets

1. Event List
2. Single Event
3. Upcoming Events

Add to Page

1. Edit with Elementor
2. Search “Speed Dating”
3. Drag widget
4. Configure
5. Save/preview

Customization

CSS Files

1. Public: /public/css/wpdating-addon-speed-dating-public.css
2. Admin: /admin/css/wpdating-addon-speed-dating-admin.css

Override Templates

1. Create: /wp-content/themes/your-theme/wpdating-addon-speed-dating/
2. Copy from: /wp-content/plugins/wpdating-addon-speed-dating/templates/
3. Edit copied templates

Database Tables

1. wp_spd_events — events
2. wp_spd_events_book — bookings
3. wp_spd_events_swipes — swipes/likes
4. Note: prefix may differ per site

Security

1. Nonce verification for AJAX
2. Login required for booking/swiping
3. $wpdb->prepare() for queries
4. Escaping output to reduce XSS risk
5. Capability checks for admin actions

Best Practices

1. Event management
   a. Create events early
   b. Use clear titles
   c. Set realistic age ranges
   d. Add images
   e. Set capacity limits
2. Email
   a. Test templates
   b. Clear subjects
   c. Include date/time/location
3. UX
   a. Explain swipe limits
   b. Promote premium benefits
   c. Use consistent naming

Support

Debug Mode

1. Add to wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

2. Log path: /wp-content/debug.log

Contacts / Resources

1. Docs: https://www.wpdating.com/docs
2. WordPress Codex: https://codex.wordpress.org/
3. Website: https://www.wpdating.com
4. Email: wpdatingplugin@gmail.com

Updates

1. Automatic updates
   a. WordPress shows update notice
   b. Click Update Now
2. Manual updates
   a. Download the latest version
   b. Deactivate plugin
   c. Replace files
   d. Reactivate
3. Before updating
   a. Backup site
   b. Test on staging
   c. Review changelog