=== NexDirectory ===
Contributors: alexplayer
Tags: directory, listing, events
Donate link: https://alexplayer.com
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires at least: 6.0
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 1.0.0

Build powerful directory, listing, and event platforms with moderation, maps, submissions, and analytics.

== Description ==

NexDirectory is a powerful, modular directory and listing plugin for WordPress that allows you to create event platforms, business directories, job boards, marketplaces, and community-driven listing websites.

Built with performance, moderation workflows, and scalability in mind, NexDirectory combines custom post types, frontend submissions, map discovery, analytics, and user dashboards into one structured system.

Whether you're building:

- An events platform
- A local business directory
- A job board
- A classified marketplace
- A community listings hub

NexDirectory provides the core infrastructure.

= Key Features =

- Custom Post Type-based directory system
- Frontend listing submission with moderation
- User dashboard (edit, delete, manage listings)
- Admin moderation queue (approve/reject with notes)
- Interactive map view (Leaflet + dynamic REST loading)
- Distance and filter-based discovery
- Calendar view (for event-based directories)
- RSVP & capacity management (optional for events)
- Claim listing workflow
- Organizer / profile directory
- Role & capability controls
- Import tool (CSV & JSON with preview mapping)
- Auto-save submission drafts
- Image & gallery support
- Email verification option
- Spam protection (honeypot + rate limit)
- REST API endpoints for frontend filtering
- Elementor widget integration
- Mobile responsive UI components
- Toast notifications (no intrusive alerts)

= Flexible Use Cases =

NexDirectory is not limited to events. You can configure it as:

- Events directory
- Business directory
- Professional directory
- Job board
- Classified listings
- Marketplace
- Event or industry hub
- Community-driven submissions platform

= Modern Architecture =

- Modular trait-based architecture
- Custom RSVP database table for concurrency safety
- REST-driven map and filter loading
- Geocoding via backend proxy
- Scheduled reminder emails
- Clean uninstall routine with optional data purge
- Capability-based access control

= Elementor Integration =

All shortcodes are available as individual Elementor widgets with styling controls, allowing you to visually build directory pages.

= Chrome Extension Connector (Optional) =

Supports secure REST imports via signed App Pass handshake, enabling AI-assisted remote listing imports.

= Built for Performance =

- Dynamic map marker loading by viewport bounds
- Query optimization for filters
- Leaflet marker clustering
- Static CSS bundle (no runtime CDN dependencies)

NexDirectory is built for developers, agencies, and entrepreneurs who want full control without SaaS lock-in.

== Installation ==

1. Upload the `nexdirectory` folder to `/wp-content/plugins/`
2. Activate the plugin through the WordPress Plugins menu
3. Create pages and insert shortcodes (see below)
4. Configure settings under **WP Admin -> NexDirectory**
5. Create taxonomy terms (types, modes, tags, price ranges)
6. Add the pages to your site navigation

Recommended pages:

- Listings Archive
- Map View
- Calendar View (optional)
- Submit Listing
- My Listings
- Account
- Login / Sign Up
- Moderation Queue (admin only)
- Organizers Directory
- Claim Listing

== Frequently Asked Questions ==

= Is NexDirectory only for events? =

No. While it supports event-specific features like calendars and RSVPs, it can be configured for general directories, job boards, or classified listings.

= Can users submit listings from the frontend? =

Yes. Users can submit listings, edit their own listings, and track submissions from a dashboard.

= Is moderation supported? =

Yes. All user submissions can be set to Pending for admin review before publishing.

= Does it support maps? =

Yes. NexDirectory includes an interactive map view with filter sidebar and dynamic marker loading.

= Can I import listings in bulk? =

Yes. The plugin includes a CSV/JSON import tool with preview and column mapping.

= Is Elementor supported? =

Yes. All shortcodes are available as Elementor widgets.

= Does it include spam protection? =

Yes. Honeypot, rate limiting, and optional email verification are supported.

= Can I uninstall and remove all data? =

Yes. An uninstall cleanup routine can optionally purge plugin data.

== Upgrade Notice ==

= 1.0.0 =
Initial public release of NexDirectory. Includes directory core, frontend submissions, moderation, maps, import tool, and Elementor integration.

