Directory Spark - Business Directory & Listings
| 开发者 |
nickduncan
dylanauty codecabin_ |
|---|---|
| 更新时间 | 2026年8月13日 20:57 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Unlimited listings with no cap on how many you can create or accept
- Title, description (rich text), and featured image on every listing
- Standard fields on every listing: address, phone, email, website, and business hours
- Latitude and longitude fields for precise map positioning per listing
- Business hours: per-day open and close times with a day toggle for each day of the week
- Custom fields: add extra fields to every listing, with your choice of type
- Category system: a hierarchical category tree with browseable archive pages per category
- Featured listings: flag specific listings to highlight and filter them separately
- Text: single-line text input
- Textarea: multi-line text input for longer content
- URL: a URL field rendered as a clickable link on the listing page
- Number: numeric input with browser validation
- Email: email input rendered as a clickable mailto link
- Select: a dropdown with custom options defined in the field manager
- Checkbox: a simple yes/no field
- Logged-in visitors can submit listings from any page using
[directory_spark_submit] - Submissions land in a pending queue for admin review before going live
- Full submission form includes all standard fields, business hours, and any active custom fields
- Honeypot spam protection on every submission
- Submitters receive an immediate on-screen confirmation after submitting
- All submissions arrive as pending listings in a dedicated admin screen
- One-click approve and reject actions directly from the listing editor and list table
- Bulk approve, reject, or trash from the listings list view
- Rejection note field: write a message for the submitter explaining why their listing was declined
- Submitter receives an email on approval and on rejection, with the rejection note included
- Grid template: image-first card layout with title, address, phone, website, and category pill
- List template: horizontal layout with image on the left and listing details on the right
- Every card is fully clickable; phone and website links remain independently clickable within the card
- Single listing page: featured image hero, description, business hours, custom fields, contact details card, and contact form
- Contact form on every listing page, routed to the listing owner's email address
- All brand colours inherit from the button colour set in Settings, so the directory matches your site
[directory_spark_listings]shortcode: full listing archive with search bar and category filter[directory_spark_search]shortcode: standalone search bar for embedding anywhere on the site- Keyword search, category filter, and pagination in the free plugin
- Native CPT archive at your chosen URL slug, with individual archives per category
pre_get_postsintegration: no secondary queries; the main WP query does the work
- Works with the free WP Go Maps plugin
- Enable a map embed on every single listing page from Settings - Integrations
- Map centres automatically at the listing's lat/lng coordinates when set
- Map ID picker populated from your live WP Go Maps maps
[directory_spark_account]shortcode: logged-in users view all their submitted listings in one place- Status displayed per listing: pending, published, or rejected
- Rejection note shown to the submitter when a listing is declined
- Admin notified by email on every new listing submission, with a direct link to review it
- Submitter notified when their listing is approved
- Submitter notified when their listing is rejected, with the admin rejection note in the email
- All emails sent via
wp_mail()for full compatibility with any SMTP plugin - Toggle each notification type on or off from Settings - Notifications
- Setup wizard on first activation: choose directory mode, set a listing label, create pages automatically
- General: listings per page, listing label (singular and plural), current mode display
- Design: grid or list template, featured image size, contact field visibility toggles, brand colour, button text colour, and border radius
- Fields: add, remove, and reorder custom fields without writing code
- Pages: assign the archive, submit, and account pages
- Integrations: WP Go Maps toggle and map ID selector
- Inquiries: contact mode, and editable form labels, headings, and success/error messages
- Notifications: toggle per email type, set the admin notification email address
- Developer: template override documentation and shortcode reference
- Danger Zone: reset wizard, delete all listing data
- Charge for listing submissions via Stripe or PayPal
- Free, standard, and premium tiers with per-tier field access and featured status
- Listing expiry dates with automatic renewal reminders
- Visitors can claim ownership of an existing unclaimed listing
- Verified badge displayed on claimed and verified listings across cards and single pages
- Star rating system with admin moderation
- Aggregate rating displayed on listing cards and the single listing page
- Schema.org LocalBusiness markup for search engine rich results
- Radius search: find listings within a set distance of a location, powered by WP Go Maps Pro
- Map-synced filtering: the map and listing results update together as visitors adjust filters
- Run a business directory and a classifieds board from the same installation
- Per-type field schemas: different custom fields and templates per listing type
- Unlimited images per listing, displayed in a lightbox gallery on the single listing page
- CSV bulk import: populate a directory from a spreadsheet in minutes
- CSV export: export all listings, custom field values, and status to a CSV file
- Reliable email delivery via SendGrid or Amazon SES
- REST API with bearer token authentication
- Outbound webhooks for listing approved, rejected, and claimed events
安装:
- From your WordPress admin, go to Plugins - Add New Plugin
- Search for Directory Spark
- Click Install Now, then Activate
- The setup wizard launches automatically. Follow the steps to choose your directory mode, set a listing label, and create your archive, submit, and account pages
- Go to Listings - Categories and add your first categories
- Add your first listing at Listings - Add New Listing
- Download the plugin zip from WordPress.org
- Upload the
directory-sparkfolder to/wp-content/plugins/ - Activate through the WordPress Plugins screen
- The setup wizard will launch automatically on your first visit to the Listings admin
[directory_spark_listings] on any page for a full listing archive with search. Place [directory_spark_submit] on a page to accept submissions from logged-in visitors. Add [directory_spark_account] to a page so submitters can track the status of their listings.屏幕截图:
常见问题:
Is Directory Spark free?
Yes. The core plugin is free with no listing caps, no time limits, and no hidden fees. Directory Spark Pro adds paid listing packages, reviews and ratings, advanced search, photo galleries, CSV import and export, multiple listing types, and more.
What is the difference between the free plugin and Pro?
The free plugin covers everything needed to run a working public directory: submission, approval workflow, custom fields, search, email notifications, and a WP Go Maps integration. Directory Spark Pro adds monetisation with paid packages via Stripe or PayPal, reviews and ratings, radius search powered by WP Go Maps Pro, photo galleries, CSV import and export, and multiple listing types in the same installation.
Does Directory Spark work with my existing theme?
Yes. Directory Spark integrates with any properly coded WordPress theme. Single listing pages resolve through your theme's standard template hierarchy. The plugin injects listing content via WordPress's content filter, so your theme's header, footer, and sidebar are left untouched. Developers can override any template by placing files in a directory-spark/ folder inside the active theme.
Can visitors submit listings without an account?
The free plugin requires visitors to be logged in to submit a listing. This creates accountability for submissions and keeps the approval workflow clean.
How does the approval workflow work?
When a visitor submits a listing it is created with a pending status and does not appear publicly. The admin receives an email with a link to review it. From the listing editor the admin can approve (publish), reject with a note, or trash the submission. The submitter receives an email either way, and rejection emails include the admin's note.
Can I customise what fields appear on each listing?
Yes. The Custom Fields manager under Settings - Fields lets you add any number of fields to every listing. Field types available in the free plugin are: text, textarea, URL, number, email, select dropdown, and checkbox. Fields appear automatically on the submission form, the listing editor, and the single listing page.
Does Directory Spark work with WP Go Maps?
Yes. When the free WP Go Maps plugin is active, you can enable a map embed on every single listing page from Settings - Integrations. Select which of your maps to embed, enter a latitude and longitude on each listing, and the map centres automatically at that location. Radius search and map-synced filtering are available in Directory Spark Pro with WP Go Maps Pro.
Can I charge for listing submissions?
Paid listing packages with Stripe and PayPal are available in Directory Spark Pro.
Can businesses claim their listing?
Claim listing is available in Directory Spark Pro. It allows business owners to request ownership of an existing listing and take over management of the details.
Does Directory Spark include reviews and ratings?
Reviews and star ratings are available in Directory Spark Pro. The free plugin includes a contact form on every listing so visitors can reach the listing owner directly without the owner's email address being exposed.
Can I import listings from a CSV or migrate from another plugin?
CSV import and export are available in Directory Spark Pro. In the free plugin, listings are created individually through the admin or via the frontend submission form.
Will my data be deleted if I uninstall Directory Spark?
No. Your listings, categories, custom fields, and settings are preserved when you deactivate or delete the plugin. To permanently remove all Directory Spark data, use the Delete All Data option under Settings - Danger Zone.
How do I override a template?
Copy any file from the plugin's /templates/ folder into a directory-spark/ folder inside your active theme. Directory Spark checks for theme overrides before loading its own templates, so your version takes priority without modifying plugin files. The Developer tab in Settings shows the exact path to use.
How can I report a security vulnerability?
Please report security issues to security@codecabin.io with a description of the vulnerability and steps to reproduce. We review and respond to all security reports promptly.
更新日志:
- Initial release: build a business directory with frontend submissions, admin approval workflow, seven custom field types, business hours, email notifications, WP Go Maps integration, grid and list card templates, and a shortcode-based archive with keyword search and category filtering