內容簡介
ListingCore 提供獨立的 WordPress 分類廣告與列表引擎功能，讓使用者能夠輕鬆創建、管理和展示各類廣告列表，並支援多種自訂功能與短碼。
【主要功能】
• 自訂文章類型：完整的列表文章類型與管理支援
• 使用者角色：支援列表發佈者與管理者角色
• 短碼支援：多種短碼以便於展示與互動
• AJAX 處理：即時搜尋、自動完成與願望清單切換
• SEO 支援：結構化數據與標準 XML 網站地圖整合
• 到期通知：定期發送列表到期提醒郵件
外掛標籤
開發者團隊
原文外掛簡介
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.
