=== ID Vendor Event Reviews ===
Contributors: insightdezign
Tags: events, reviews, ratings, vendors, vendor reviews
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A flexible event review platform for vendors. Supports overall + subcategory ratings, numerical data collection, and a pending moderation queue.

== Description ==

ID Vendor Event Reviews lets vendors rate and review events they have participated in. Each review includes an overall star rating, optional per-category ratings, free-text feedback, and anonymous numerical data that is aggregated into useful analytics for future vendors.

**Free Features:**

* Overall 1–5 star rating with optional subcategory breakdowns (Organization, Staff, Table Cost Value, Foot Traffic, Venue Quality)
* Anonymous numerical data collection (estimated attendance, table cost, sales, gross revenue) aggregated into averages
* Guest reviews — no login required
* One-review-per-user-per-event rate limiting
* Honeypot spam protection
* Pending moderation queue — reviews must be approved before they appear
* Custom single event and archive templates with theme override support
* Event Type taxonomy for organizing and filtering events
* Responsive CSS — works on mobile and desktop out of the box

**Pro Features (license required):**

* **Require Login** — optionally restrict reviews to logged-in users
* **Custom Rating Subcategories** — add, remove, and reorder star-rating categories via admin repeater UI
* **Custom Numerical Data Fields** — add, remove, and reorder data collection fields via admin repeater UI
* **Review Display Layouts** — choose between list (default), compact, or grid view
* **Helpful Voting** — visitors can upvote reviews as "helpful" via AJAX (one vote per user/IP)
* **Frontend Sorting & Filtering** — sort reviews by date, rating, or helpful count; filter by star rating
* **Schema.org JSON-LD** — AggregateRating + Review structured data on single event pages
* **Email Notifications** — admin on submit, reviewer on approve, organizer on approve; customizable subjects, bodies, and merge tags
* **Analytics Dashboard** — Chart.js charts (reviews over time, rating distribution, top events, subcategory radar), stat cards, per-event drill-down
* **CSV & PDF Export** — export review data with event and date filters
* **Tabbed Settings Page** — License, General, Rating Fields, Email Notifications, and Export tabs

**Shortcodes:**

`[idver_submit_review event_id="123"]` — Displays the review submission form for a specific event. Works for both logged-in users and guests (unless Require Login is enabled in Pro settings).

`[idver_reviews event_id="123"]` — Displays the review summary (average rating, category bars, data averages) and individual review cards for an event.

`[idver_event_list posts_per_page="12"]` — Displays a responsive grid of event cards with thumbnails, type badges, location, date, and star ratings.

**Templates:**

The plugin provides custom single and archive templates that automatically load for Vendor Event pages. Themes can override them by placing files in a `id-vendor-event-reviews/` directory inside the theme:

* `id-vendor-event-reviews/single-event.php` — Single event page
* `id-vendor-event-reviews/archive-event.php` — Event archive and taxonomy archive pages

== Installation ==

1. Upload the `id-vendor-event-reviews` folder to `/wp-content/plugins/`.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Navigate to Vendor Events in the admin sidebar to create your first event.
4. Assign Event Types via the Event Types taxonomy.
5. Use the shortcodes above, or visit the event's permalink to see the built-in templates.
6. To activate Pro features, go to Vendor Events → Settings → License and enter your license key.

== Frequently Asked Questions ==

= Do reviewers need to be logged in? =
By default, no. Guests can submit reviews by providing a name and email address. Pro users can enable the Require Login setting to restrict reviews to logged-in users.

= How are reviews moderated? =
All submitted reviews are saved with a "Pending" status. An admin must approve them from the Event Reviews screen before they appear publicly.

= Can I customize the templates? =
Yes. Copy the template file from `wp-content/plugins/id-vendor-event-reviews/templates/` into your theme at `your-theme/id-vendor-event-reviews/` and modify it there. Theme overrides take priority.

= What numerical data is collected? =
Reviewers can optionally report estimated attendance, table cost paid, number of sales, and gross revenue. These values are aggregated anonymously into averages displayed in the review summary. Pro users can customize these fields.

= How do I activate Pro features? =
Go to Vendor Events → Settings → License and enter your license key. All Pro features will be unlocked immediately.

== Screenshots ==

1. Single event page with hero image, meta bar, reviews, and review form.
2. Event archive page with filter buttons and event card grid.
3. Review submission form with star ratings and numerical fields.
4. Admin review moderation screen.
5. Settings page — License tab.
6. Settings page — General tab with Pro features.
7. Analytics dashboard with charts and stat cards.

== Changelog ==

= 2.0.0 =
* Added Freemius SDK for Pro licensing.
* Added tabbed Settings page (License, General, Rating Fields, Email Notifications, Export).
* Added custom rating subcategories via admin repeater UI (Pro).
* Added custom numerical data fields via admin repeater UI (Pro).
* Added require login toggle (Pro).
* Added review display layout options: list, compact, grid (Pro).
* Added helpful/upvote voting with AJAX (Pro).
* Added frontend sorting and star-filter controls (Pro).
* Added Schema.org JSON-LD output on single event pages (Pro).
* Added email notifications: admin on submit, reviewer on approve, organizer on approve (Pro).
* Added analytics dashboard with Chart.js charts and stat cards (Pro).
* Added CSV and PDF export with event and date filters (Pro).
* Added organizer email field to event details meta box.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 2.0.0 =
Major update adding Pro features: custom fields, analytics, email notifications, helpful voting, sorting/filtering, schema markup, and export. Free features are unchanged and fully functional without a license.

= 1.0.0 =
Initial release.
