🎪 Event Submission & Management System (MVP)

📋 Overview

This system enables vendors to submit, manage, and track event listings while providing admins with complete oversight and publication control.
The MVP focuses on clean submission workflows, duplicate prevention, and automated publication handling.

---

🚀 Features

1. Event Submission (Vendor Side)

Vendors can submit and manage their own event listings with the following fields:

Field	Description
Event URL	Direct link to the event’s page
Event Title	Auto-fetched from URL, editable (letters & spaces only — no numbers/punctuation)
Vendor Status	Applied / Waitlist / Confirmed
Start Date	Required
End Date	Optional
Country	US / Canada
State / Province	Based on selected country
Email	Auto-filled from vendor profile
Phone Number	Vendor contact number

Actions:

• Save & Exit
• Save & Add New

---

2. Duplicate Prevention

Duplicates are checked only against confirmed events.

Duplicate Key (exact match only for MVP): Normalized Title + Start Date (Month) + State/Province + URL + Country

Fuzzy matching and advanced duplicate detection may be introduced in future releases.

---

3. Event Lifecycle & Status Rules

• Applied / Waitlist → visible in vendor dashboard, not published.
• Confirmed → instantly published if no duplicate found.
• If a confirmed event is deleted, all Applied / Waitlist vendors are notified.
• Vendors can:
  • Change status (Confirmed → Applied / Waitlist) → auto-unpublish.
  • Delete events → permanently removed; admin notified.

---

4. Admin Oversight

Admins have access to a Recently Published Queue with advanced filters:

• Filter by date, vendor, or state.
• Can override status, unpublish, or delete events.
• All actions recorded in an audit log.

Notifications:

• Daily digest email of auto-published events.
• Vendor deletion notifications.

---

5. Vendor Dashboard (My Account → Events)

Vendors can view and manage all their submissions in one place.

Status	Visibility	Label
Applied / Waitlist	Not Published	“Not Published”
Confirmed	Published	“Published”

Notifications:

• On publish/unpublish
• On deletion
• On rebooking

---

6. Frontend Public Event List

The public event list displays confirmed (published) events.

Sidebar:

• Displays months with event counts.
• Clicking a month loads events for that month.
• Search/filter available within a month.

Listing Order:

1. State / Province
2. Event Title (alphabetically)

Each Event Displays:

• Event Title (clickable, opens in new tab)
• State / Province
• Country (only shown for Canadian events)

---

7. Notifications (Email Only)

Admin:

• Daily digest of auto-published events
• Notifications for vendor deletions

Vendor:

• Publish / Unpublish notices
• Rebooking notifications

---

8. Reminders & Renewals

Disabled for MVP

Future Enhancements:

• 90- and 30-day reminders before event start date
• Auto-unpublish if not reconfirmed

---

🧭 Future Roadmap

• Fuzzy duplicate detection
• Automated rebooking workflows
• Multi-language support
• Integration with calendar exports (Google, iCal)
• Advanced vendor analytics

---

🛠 Tech Notes

• Frontend: WordPress (Shortcodes / Templates)
• Backend: Custom Post Type (Events)
• User Roles: Vendor & Admin
• Email System: wp_mail() + HTML templates
• Database: Standard WP tables + meta for event fields

---

🧩 Version

MVP Release v1.0.0

---

📧 Contact

For technical support or enhancements, contact the project team or system administrator.

vendor-events

A WordPress plugin that allows vendors to submit and manage their events, with admin approval workflow and CSV import/export functionality.