About this plugin
ListingCore provides the classified ads functionality for a standalone WordPress classifieds and listing engine. Install this plugin to enable:
- Custom Post Type — A listing post type with full admin support, REST API, and rich meta fields (price, condition, brand, model, location, contact info, expiry date, and more).
- Taxonomies — Listing Category (hierarchical) and Listing Tag.
- User Roles — listing_poster (submits and manages their own listings) and listing_moderator (manages other users’ listings and listing categories).
- Shortcodes — [listingcore_listings], [listingcore_categories], [listingcore_search_form], [listingcore_post_listing_button], [listingcore_user_dashboard], [listingcore_listing_form], [listingcore_contact_form], [listingcore_wishlist].
- AJAX Handlers — Wishlist toggle, contact seller form submission, live search autocomplete, and load-more listings.
- Admin Columns — Price, location, status badges, view count, and expiry date columns in the listings list table.
- Expiry Cron — Daily cron job that emails authors when listings are about to expire (3-day warning) or have expired.
- REST API — Selected listing fields exposed via the WP REST API (sensitive contact/location fields are capability and privacy gated), plus custom endpoints /wp-json/listingcore/v1/listings and /wp-json/listingcore/v1/listings/{id}/similar.
- SEO — Product + Offer JSON-LD structured data on published singular listings, and listing inclusion in WordPress’s standard XML sitemap.
- Single Listing — A plugin-owned fallback single-listing detail template (overridable by your theme), so listings render correctly with any theme.
Shortcode Reference
[listingcore_listings]
Display a grid of listings.
[listingcore_listings cat=”electronics” count=”8″ view=”grid” featured=”1″]
Parameters:
* cat — Category slug or ID (optional)
* count — Number of listings (default: 8)
* view — grid or list (default: grid)
* featured — Set to 1 to show featured listings only
* location — Exact city name (default: none)
* sort — date, price_asc, price_desc, views (default: date)
* order — ASC or DESC (default: DESC). Ignored by price_asc / price_desc, which encode their own direction.
[listingcore_categories]
Display a category grid.
[listingcore_categories count=”8″ columns=”4″ show_count=”yes”]
Parameters:
* count — Number of categories (default: 8)
* columns — Grid columns (default: 4)
* show_count — Show listing count per category: yes or no (default: yes)
* hide_empty — Hide categories with no listings: yes or no (default: no)
* parent — Parent category ID (default: 0, top-level categories only)
[listingcore_search_form]
Display a search form for listings.
[listingcore_search_form placeholder=”Search…” show_cats=”yes” show_loc=”yes”]
[listingcore_post_listing_button]
Display a “Post Ad” button.
[listingcore_post_listing_button text=”Post Free Ad” url=”/submit”]
Parameters:
* text — Button label (default: “Post Free Ad”)
* url — Destination URL (default: the configured submit page)
* class — Additional CSS classes (default: cp-btn cp-btn-accent cp-btn-lg )
[listingcore_user_dashboard]
Embed the user dashboard: the current user’s listings with status, created date, expiry, edit, delete, and renew (for eligible paid listings).
[listingcore_listing_form]
Embed the submit listing form inline on any page.
[listingcore_contact_form]
Embed the contact-seller form for a listing.
[listingcore_contact_form listing_id=”123″]
- listing_id — Listing ID to contact (optional; defaults to the current listing when placed on a single listing page). Only published listings render the form.
[listingcore_wishlist]
Display the current user’s saved listings.
[listingcore_wishlist]
Requires login. Shows the current user’s saved published listings in saved order, using the standard listing-card presentation.
REST API Endpoints
Selected listing fields are exposed via the REST API; sensitive contact and location fields are capability and privacy gated.
- GET /wp-json/listingcore/v1/listings — Paginated listing results with filtering by category, location, price range, and featured status.
- cat — Category slug or ID.
- location — Exact city match.
- min_price / max_price — Decimal price range (unpriced listings are excluded from price-range queries).
- featured — Show featured listings only.
- GET /wp-json/listingcore/v1/listings/{id}/similar — Similar listings based on category.
Requirements
- WordPress 6.0 or higher
- PHP 8.0 or higher
Privacy
ListingCore stores the listing data entered by the listing author (title, description, price, location, condition, and contact details such as phone and email) and each listing’s view count, and stores each user’s saved (wishlist) listings. Listing contact details are not publicly exposed. The contact-seller form emails the visitor’s name, email, phone, and message to the listing author.
Paid-listing and expiry events send transactional emails to the listing author. ListingCore does not transmit data to third-party services; if enabled, payment processing is handled by WooCommerce.