Ultimate Classified Listings – Classifieds, Directory & Marketplace

2.4

• Feature: Automatic listing expiry. Turn it on under Settings → Listing Expiry and listings expire a configurable number of days after they’re published. A daily cron job moves each expired listing to Draft (or Trash), so it drops out of every public listing, search and map view. Off by default and fully backward compatible: enabling it only affects listings published from that point on, and any listing without an expiry date is never touched.
• Feature: Per-listing expiry control. A “Listing Expiry” box on the edit screen lets you set an exact expiry date or mark a listing “Never expires”, and an “Expires” column in the Listings table shows each listing’s date at a glance.
• Feature: Seller renewals. Expired listings show a “Renew” button in the seller dashboard (when allowed) that gives the listing a fresh expiry period and puts it back online in one click.
• Feature: Expiry emails. Optionally email the listing owner when their listing expires, plus a reminder a configurable number of days beforehand. All subjects/bodies are filterable.
• Developer: new meta ucl_listing_expiry (Unix timestamp; absent = never), actions uclwp_listing_expired and uclwp_listing_renewed, and filters on every email string. The daily event is uclwp_expire_listings_event and is cleared on deactivation.

2.3

• Feature: In-dashboard documentation. A new “Docs” menu (under Ultimate Classified Listings, just before the Setup Wizard) lists every shortcode in plain language — what each one does, its attributes and defaults, copy-ready examples, and which page it belongs on — so anyone can understand how the plugin works without leaving wp-admin.
• Feature: Featured (promoted) listings. Mark any listing as featured and it gets a “Featured” badge on its card and single-listing page, and — by default — floats to the top of listing and search results while the visitor’s chosen sort still applies within the featured and non-featured groups.
• Feature: One-click star toggle in the wp-admin Listings table plus a “Promotion” checkbox on the listing edit screen, so admins can feature/un-feature without opening each listing. The AJAX toggle is nonce-verified and capability-checked (edit_post).
• Feature: [uclwp_listings featured="only"] renders a dedicated featured-listings section anywhere; featured="first" floats featured to the top of any [uclwp_listings] query.
• Feature: New Settings → Featured Listings panel — enable/disable the feature, toggle “show featured first”, and customise the badge text.
• Developer: featured state is stored as post meta ucl_featured = ‘1’ (deleted when un-featured). New action uclwp_listing_featured_changed; ordering helper UCLWP_Featured::apply_featured_first() is reusable and idempotent.
• Backward compatible: a listing with no featured flag behaves exactly as before; featured-first ordering never excludes any listing (it LEFT JOINs the flag), and the whole feature is off in one setting.

2.2

• Feature: SEO structured data. Every single-listing page now automatically outputs schema.org Product + Offer and BreadcrumbList structured data as JSON-LD, making listings eligible for Google rich results (price, image, availability, breadcrumbs). Price is read from the listing’s ucl_regular_price meta and currency from Settings; condition maps to schema itemCondition when set. Filterable via uclwp_seo_product_schema and uclwp_seo_breadcrumb_schema.
• Feature: Open Graph + Twitter Card meta on single listings, so a shared listing renders a rich preview (title, description, image, price) on Facebook, X, WhatsApp, Slack, etc. Suppressed automatically when a major SEO plugin (Yoast, Rank Math, SEOPress, All in One SEO, The SEO Framework, Slim SEO) is active and already emitting social tags — no duplicate tags. Filter: uclwp_seo_output_social.
• Feature: Social sharing row on single listings — Facebook, X, WhatsApp, LinkedIn and email buttons built entirely from plain links. No third-party scripts, pixels or tracking. Networks are filterable via uclwp_share_networks.
• Feature: Related listings. Each listing detail page can show up to N other published listings from the same category (rendered with your chosen card style), which keeps visitors browsing and strengthens internal linking for SEO. Configurable count and heading; query filterable via uclwp_related_listings_args.
• Feature: New Settings → SEO & Sharing panel to toggle structured data/social meta, social share buttons and related listings, and to set the related-listings count and heading. All three features default to enabled but are purely additive.
• Compatibility: “Tested up to” bumped to WordPress 7.1.
• All 2.2 features are backward compatible: existing installs simply gain <head> schema/meta and two new single-page blocks, each individually removable in Settings, with theme-overridable, filterable output.

2.1

• Feature: One-click demo importer. The setup wizard now offers a “Load sample listings” option that seeds a small set of realistic, published listings for the chosen site type (classifieds, real estate, jobs, local services or automotive). Each sample carries a category, price, custom fields and real map coordinates deliberately clustered across several metros so the new map view has something to show immediately. Every imported post is flagged with _ucl_sample and tracked in the uclwp_sample_ids option; a “Remove sample listings” button on the wizard’s final screen deletes the whole set in one click. No external images are fetched, so the importer works on sites with no outbound network.
• Feature: Map-based search results with clustering. New [uclwp_search_map] shortcode renders the listings matching the current search on an interactive Leaflet map, using the bundled leaflet.markercluster library to group nearby pins. Each pin opens a popup with the listing thumbnail, title, city, price and a “View listing” link. The map reads the same query args as [uclwp_search_results], so it honours the active filters. Also available inline via a new map="enable" attribute on [uclwp_search_results] (with map_height). The auto-created Search page now includes the map between the form and the results.
• Feature: “Near me” / radius search. The map’s optional toolbar adds a geolocation button and a radius selector (km). Choosing a radius reloads with ucl_lat / ucl_lng / ucl_radius query args, and the search query now restricts results to a bounding box around that point (coordinates cast as DECIMAL so fractional degrees aren’t truncated). Radius presets are filterable via uclwp_search_map_radius_presets, the value via uclwp_search_radius_km, and the marker cap via uclwp_search_map_max_markers.
• Both features are backward compatible: existing installs see no change until they enable the map shortcode/attribute or run the importer, and the map template is theme-overridable at /your-theme/ucl/shortcodes/search/map.php.

2.0 – 14 June 2026

• Bug fix: When the archive/search-results top bar was rendered (via [uclwp_search_results top_bar="enable"] or anywhere the uclwp_archive_topbar action fires) and a visitor changed the sort dropdown, the resulting URL kept only sort_by and layout and dropped every other active query arg — keywords, price range, custom-field filters, etc. The top bar now re-emits every other $_GET value as a hidden input inside the form (using PHP bracket notation for nested sub-arrays like regular_price[min]), so the sort round-trip preserves the active filter set. The grid/list switcher anchors already used add_query_arg() and were unaffected.
• Added: New helper uclwp_flatten_query_args() that flattens nested arrays into name[sub][sub] / value pairs suitable for hidden form inputs. Reusable from any template that needs to pass current GET state through a <form method="GET">.

1.16.0

• Feature: Two new single-listing styles. Pick one in Settings → Templates Settings → Single Listing Style. Style 1 (Classic, default) is the existing look. Style 2 (Card Stack) renders each section as a raised card with a coloured left rail and a chip-style heading — e-commerce / property-listing feel. Style 3 (Minimal) drops the card chrome entirely and separates sections with thin top dividers. Implemented as a body class (ucl-listing-style-1/2/3) added on single-listing pages; templates are unchanged so all theme overrides keep working.
• Feature: Price quick-pick chips are now editable from the admin. New “Price Quick-Pick Presets” textarea in Settings → Search Settings (right after Total Listings) — one numeric preset per line; each becomes a “Up to {price}” chip under the price range control in search styles 2 and 3. Leave blank to hide the chips entirely. Still filterable in code via uclwp_search_price_chips.
• Feature: [uclwp_search_results] now supports a top_bar="enable" attribute (default disable) that adds the same sort + grid/list switcher the [uclwp_listings] shortcode renders.
• Feature: Per-listing map zoom level is now saved. The admin metabox map writes the user-chosen zoom into a hidden ucl_listing_zoom input (Leaflet zoomend and Google zoom_changed events both wired up); both the admin metabox save path and the frontend create/edit handler persist it; the single-listing template reads it back and the map opens at exactly that zoom on the frontend.
• Improvement: Search style 2 polish — reduced cell min-height from 46px to 38px, button is now a properly sized pill (not a tall circle), inputs no longer have huge top/bottom padding. New columns shortcode attribute (1–6, default 4) controls how many secondary-field cells appear per row via CSS grid. Mobile collapses to 2 columns at ≤768px and 1 column at ≤480px.
• Bug fix: Card image aspect ratio (Settings → Listings → Card Image Aspect Ratio) was not being applied. The CSS selector keyed off [style*="--ucl-card-image-ratio"], which never matched because the variable is emitted via an inline <style> tag, not the element’s style attribute. The aspect-ratio rule now applies directly to .uclwp-grid-box-wrap .uclwp-image and .uclwp-list-box-wrap .uclwp-image, so all four card styles honour the chosen ratio.