Adds ratings & reviews for listings, with the aggregate rating fed into Product structured data so listings can show star ratings in Google. Reviews are moderated WordPress comments. Opt-out and backward compatible.<\/p>","2.4":"
Adds optional automatic listing expiry \u2014 expire after N days, email sellers before\/after, and one-click renew from the dashboard. Off by default; existing listings are never changed. Backward compatible.<\/p>","2.3":"
Adds Featured (promoted) listings \u2014 a badge, one-click admin star toggle, "show featured first" ordering, and a [uclwp_listings featured="only"] section. All free and toggleable. Backward compatible.<\/p>","2.2":"
Adds automatic SEO structured data (Product\/Offer\/Breadcrumb JSON-LD), Open Graph & Twitter cards, social share buttons and related listings \u2014 all free and toggleable. Tested up to WordPress 7.1. Backward compatible.<\/p>","2.1":"
Adds a clustered map view for search results with a "Near me" radius filter, plus a one-click demo-listings importer in the setup wizard. Backward compatible.<\/p>","2.0":"
Fixes the archive top bar wiping active search filters when the sort dropdown changes. Strongly recommended for anyone using [uclwp_search_results top_bar="enable"].<\/p>","1.16.0":"
Adds two new single-listing styles, admin-editable price chips, a top bar option on [uclwp_search_results], per-listing map zoom persistence, a columns attribute on search style 2, and a fix for the card image aspect-ratio setting that wasn't applying.<\/p>","1.15.0":"
Adds two new search-form styles (Bar + Hero) with a modern price-range control. Fixes equal-height grid cards, the empty category icon, and overflowing seller emails in the sidebar.<\/p>","1.14.2":"
Fixes the "Invalid LatLng object" Leaflet error when creating a new listing in wp-admin, introduced by the 1.14.1 metabox-assets fix. Strongly recommended for anyone on 1.14.1.<\/p>","1.14.1":"
Bug fix: restores Bootstrap CSS, icons, media uploader and map on the wp-admin Listing Information metabox. No behaviour change anywhere else.<\/p>","1.14.0":"
Release-candidate compliance pass \u2014 clears all Plugin Check errors for WordPress.org submission (escape on dynamic CSS, paginate_links output, translator comments, Tested up to 7.0, plugin name rules). No behaviour change.<\/p>","1.13.0":"
Second WordPress.org Plugin Check compliance pass. Adds ABSPATH guards everywhere, wp_send_json\/wp_json_encode adoption, wp_remote timeout, rel="noopener noreferrer" on target=_blank links, removes deprecated load_plugin_textdomain, prefixes orphan filters. No behaviour change.<\/p>","1.12.0":"
Full sanitization and escaping audit for WordPress.org plugin review compliance. Fixes one display bug in the compare-listings table; removes a second hardcoded reCAPTCHA fallback key; no breaking changes.<\/p>","1.11.0":"
Field display redesigned on single pages and cards (icon + label + value cards, definition lists, or inline pills). Adds Favorites and Dark Mode. Visually backward-compatible \u2014 the new "cards" display becomes the default on single-listing pages.<\/p>","1.10.0":"
Adds three new listing card styles (Minimal, Bold Overlay, Compact), a 14-colour palette wired through CSS variables, card radius and image aspect-ratio settings. Visually backward-compatible.<\/p>","1.9.0":"
Adds a setup wizard, auto-page creation, and a polite review prompt. Builds on the 1.8.0 security hardening.<\/p>","1.8.0":"
Major security hardening release. Adds CSRF protection to every AJAX endpoint, removes plaintext password storage, fixes email header injection, and rate-limits authentication. All sites should update.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":2},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3571494,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3571494,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3571494,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3571494,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1","1.2","1.3","1.4","1.5","1.6","1.7","2.0","2.1","2.3","2.4","2.5"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2764251,"resolution":"1","location":"assets","locale":"","width":1592,"height":2538},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2764251,"resolution":"2","location":"assets","locale":"","width":1686,"height":687},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2764251,"resolution":"3","location":"assets","locale":"","width":1692,"height":1132},"screenshot-4.png":{"filename":"screenshot-4.png","revision":2764251,"resolution":"4","location":"assets","locale":"","width":1565,"height":3260}},"screenshots":{"1":"A modern, responsive classified-listings grid \u2014 the front page your visitors land on.","2":"Powerful AJAX search with price range, custom-field filters and instant results.","3":"Single-listing page with image gallery, details, seller contact and social sharing.","4":"Frontend submission form \u2014 sellers post listings without touching wp-admin.","5":"Seller dashboard for managing, editing and tracking listings.","6":"Map search with clustered pins and a \"Near me\" radius filter.","7":"Drag-and-drop Fields Builder for unlimited custom fields and sections.","8":"Setup wizard with one-click page creation and demo-content importer."}},"plugin_section":[],"plugin_tags":[4531,4527,2466,4528,8379],"plugin_category":[35,39],"plugin_contributors":[187022],"plugin_business_model":[],"class_list":["post-160100","plugin","type-plugin","status-publish","hentry","plugin_tags-classified-ads","plugin_tags-classifieds","plugin_tags-directory","plugin_tags-listings","plugin_tags-marketplace","plugin_category-advertising","plugin_category-business","plugin_contributors-webcodingplace","plugin_committers-webcodingplace"],"banners":{"banner":"https:\/\/ps.w.org\/ultimate-classified-listings\/assets\/banner-772x250.jpg?rev=3571494","banner_2x":"https:\/\/ps.w.org\/ultimate-classified-listings\/assets\/banner-1544x500.jpg?rev=3571494","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ultimate-classified-listings\/assets\/icon-128x128.png?rev=3571494","icon_2x":"https:\/\/ps.w.org\/ultimate-classified-listings\/assets\/icon-256x256.png?rev=3571494","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/ultimate-classified-listings\/assets\/screenshot-1.png?rev=2764251","caption":"A modern, responsive classified-listings grid \u2014 the front page your visitors land on."},{"src":"https:\/\/ps.w.org\/ultimate-classified-listings\/assets\/screenshot-2.png?rev=2764251","caption":"Powerful AJAX search with price range, custom-field filters and instant results."},{"src":"https:\/\/ps.w.org\/ultimate-classified-listings\/assets\/screenshot-3.png?rev=2764251","caption":"Single-listing page with image gallery, details, seller contact and social sharing."},{"src":"https:\/\/ps.w.org\/ultimate-classified-listings\/assets\/screenshot-4.png?rev=2764251","caption":"Frontend submission form \u2014 sellers post listings without touching wp-admin."}],"raw_content":"\n
Ultimate Classified Listings turns any WordPress site into a classifieds, directory or marketplace website \u2014 without the bloat, and without paying for the basics.<\/strong> Frontend listing submission, AJAX search with filters, maps with a \"near me\" radius, unlimited custom fields and a seller dashboard are all included in the free core. A 60-second setup wizard creates every page for you and can even load sample listings so you have something to look at from minute one.<\/p>\n\n It stays deliberately lightweight<\/strong>. There is no page-builder dependency and no heavy framework loaded on every page \u2014 assets load only where a listing, search or dashboard is actually rendered. That keeps front-end pages fast and makes the plugin easy to drop onto an existing theme.<\/p>\n\n Whether you're building a Craigslist-style classifieds board, a local business directory, a real-estate site, a jobs board, an automotive marketplace or a community \"buy & sell\" section, you get a complete, secure, mobile-friendly listing workflow out of the box \u2014 and everything advertised here works in the free version.<\/p>\n\n Yes. Everything described on this page \u2014 maps, AJAX search, frontend submission, custom fields, favorites, comparison, SEO schema, social sharing and related listings \u2014 is in the free core. There is no paywall on the core workflow.<\/p><\/dd>\n Yes. As of 2.2 each listing automatically outputs schema.org Product<\/strong>, Offer<\/strong> and BreadcrumbList<\/strong> structured data (JSON-LD) plus Open Graph<\/strong> and Twitter Card<\/strong> meta tags. That makes listings eligible for Google rich results (price, image, breadcrumbs) and gives them a rich preview when shared on social media. If you run a dedicated SEO plugin (Yoast, Rank Math, SEOPress, All in One SEO), the social meta is skipped automatically to avoid duplicates, while the classified-specific Product schema is still added. You can turn any of it off under Settings \u2192 SEO & Sharing<\/strong>.<\/p><\/dd>\n Yes. The plugin is shortcode-based, so its listing, search, categories and dashboard blocks drop into Gutenberg, Elementor, Divi or any other builder. Every template can also be overridden from your theme.<\/p><\/dd>\n No. Maps and \"near me\" radius search run on OpenStreetMap (Leaflet) with no key required. If you prefer Google Maps, add your API key in Settings and switch.<\/p><\/dd>\n Yes \u2014 that's a core design goal. There's no page-builder dependency and assets load only on pages that actually render a listing, search or dashboard, so the rest of your site stays untouched.<\/p><\/dd>\n Yes. As of 2.3 you can mark any listing as featured<\/strong> \u2014 from the Promotion box on its edit screen, or with the one-click star toggle in the Listings admin table. Featured listings get a badge on their card and detail page and, by default, float to the top of listing and search results (the visitor's chosen sort still applies within each group). You can build a dedicated featured section anywhere with Yes, as of 2.5. Enable Settings \u2192 Reviews & Ratings<\/strong> and each listing page gets a star-rating summary, a list of reviews and a review form. Reviews are stored as WordPress comments, so you moderate them from the normal Comments screen (and Akismet works on them). New reviews are held for moderation by default; you can allow guests or require login. Best of all, the aggregate rating is added to each listing's Product structured data (AggregateRating), so listings with reviews become eligible to show star ratings in Google search results<\/strong>.<\/p><\/dd>\n Yes, as of 2.4. Turn on Settings \u2192 Listing Expiry<\/strong> and choose how many days a listing stays live after it's published. When a listing expires it's moved to Draft (or Trash) so it disappears from all public views. You can email the seller when it expires and a few days before, and \u2014 if you allow it \u2014 sellers renew expired listings with one click from their dashboard. This is off by default<\/strong>, and turning it on only affects listings published from that point on; your existing listings are never changed.<\/p><\/dd>\n Built-in payment gateways and listing packages are on the roadmap. Today you can require admin approval before listings go live via Settings \u2192 Submission Mode<\/strong>.<\/p><\/dd>\n Passwords are never stored in plain text. Sellers awaiting manual approval have only a salted hash stored; legacy entries from very old versions are routed through the standard WordPress password-reset flow on approval.<\/p><\/dd>\n Every AJAX endpoint verifies a nonce via Yes. The setup wizard offers a one-click \"Load sample listings\" option that seeds realistic listings \u2014 with categories, prices and map locations \u2014 tailored to the site type you pick. Remove them all again in one click from the wizard's final screen whenever you're ready.<\/p><\/dd>\n Add the Why choose Ultimate Classified Listings<\/h4>\n\n
\n
Core features (all free)<\/h4>\n\n
\n
\/your-theme\/ucl\/...<\/code><\/li>\n<\/ul>\n\n\n\n
\n
Is this plugin really free?<\/h3><\/dt>\n
Is it good for SEO?<\/h3><\/dt>\n
Does it work with Elementor, Gutenberg or Divi?<\/h3><\/dt>\n
Do I need a Google Maps API key?<\/h3><\/dt>\n
Is it lightweight?<\/h3><\/dt>\n
Can I promote or highlight specific listings?<\/h3><\/dt>\n
[uclwp_listings featured=\"only\"]<\/code>, and turn any of this off under Settings \u2192 Featured Listings.<\/p><\/dd>\nCan visitors rate and review listings?<\/h3><\/dt>\n
Can listings expire automatically?<\/h3><\/dt>\n
Can I let users pay to post listings?<\/h3><\/dt>\n
How are seller passwords stored?<\/h3><\/dt>\n
How does the plugin protect against CSRF and abuse?<\/h3><\/dt>\n
check_ajax_referer()<\/code> (separate public and admin nonces), every action runs a capability check, and login, registration and contact-seller endpoints are rate-limited.<\/p><\/dd>\nCan I try it with sample content?<\/h3><\/dt>\n
How do I show listings on a map?<\/h3><\/dt>\n
[uclwp_search_map]<\/code> shortcode to any page (the auto-created Search page includes it), or enable it inline with [uclwp_search_results map=\"enable\"]<\/code>. The map plots every matching listing that has coordinates, clusters nearby pins, and offers a \"Near me\" button plus a radius selector.<\/p><\/dd>\n\n<\/dl>\n\n\n2.5<\/h4>\n\n
\n
uclwp_review<\/code> with a ucl_rating<\/code> meta), so moderation happens on the normal Comments screen and Akismet applies. They are kept out of the site's ordinary comment feeds and Recent Comments widget.<\/li>\nucl_rating_average<\/code> \/ ucl_rating_count<\/code>) and recomputed only when a review is added, moderated, edited or deleted \u2014 never on page render.<\/li>\nuclwp_review_added<\/code>; the reviews template is overridable at \/your-theme\/ucl\/content-single\/reviews.php<\/code>; helper UCLWP_Reviews::stars_html()<\/code>.<\/li>\n2.4<\/h4>\n\n
\n
ucl_listing_expiry<\/code> (Unix timestamp; absent = never), actions uclwp_listing_expired<\/code> and uclwp_listing_renewed<\/code>, and filters on every email string. The daily event is uclwp_expire_listings_event<\/code> and is cleared on deactivation.<\/li>\n<\/ul>\n\n2.3<\/h4>\n\n
\n
edit_post<\/code>).<\/li>\n[uclwp_listings featured=\"only\"]<\/code> renders a dedicated featured-listings section anywhere; featured=\"first\"<\/code> floats featured to the top of any [uclwp_listings]<\/code> query.<\/li>\nucl_featured<\/code> = '1' (deleted when un-featured). New action uclwp_listing_featured_changed<\/code>; ordering helper UCLWP_Featured::apply_featured_first()<\/code> is reusable and idempotent.<\/li>\n2.2<\/h4>\n\n
\n
ucl_regular_price<\/code> meta and currency from Settings; condition<\/code> maps to schema itemCondition<\/code> when set. Filterable via uclwp_seo_product_schema<\/code> and uclwp_seo_breadcrumb_schema<\/code>.<\/li>\nuclwp_seo_output_social<\/code>.<\/li>\nuclwp_share_networks<\/code>.<\/li>\nuclwp_related_listings_args<\/code>.<\/li>\n<head><\/code> schema\/meta and two new single-page blocks, each individually removable in Settings, with theme-overridable, filterable output.<\/li>\n<\/ul>\n\n2.1<\/h4>\n\n
\n
_ucl_sample<\/code> and tracked in the uclwp_sample_ids<\/code> 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.<\/li>\n[uclwp_search_map]<\/code> shortcode renders the listings matching the current search on an interactive Leaflet map, using the bundled leaflet.markercluster<\/code> 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]<\/code>, so it honours the active filters. Also available inline via a new map=\"enable\"<\/code> attribute on [uclwp_search_results]<\/code> (with map_height<\/code>). The auto-created Search page now includes the map between the form and the results.<\/li>\nucl_lat<\/code> \/ ucl_lng<\/code> \/ ucl_radius<\/code> query args, and the search query now restricts results to a bounding box around that point (coordinates cast as DECIMAL<\/code> so fractional degrees aren't truncated). Radius presets are filterable via uclwp_search_map_radius_presets<\/code>, the value via uclwp_search_radius_km<\/code>, and the marker cap via uclwp_search_map_max_markers<\/code>.<\/li>\n\/your-theme\/ucl\/shortcodes\/search\/map.php<\/code>.<\/li>\n<\/ul>\n\n2.0 - 14 June 2026<\/h4>\n\n
\n
[uclwp_search_results top_bar=\"enable\"]<\/code> or anywhere the uclwp_archive_topbar<\/code> action fires) and a visitor changed the sort dropdown, the resulting URL kept only sort_by<\/code> and layout<\/code> and dropped every other active query arg \u2014 keywords, price range, custom-field filters, etc. The top bar now re-emits every other $_GET<\/code> value as a hidden input inside the form (using PHP bracket notation for nested sub-arrays like regular_price[min]<\/code>), so the sort round-trip preserves the active filter set. The grid\/list switcher anchors already used add_query_arg()<\/code> and were unaffected.<\/li>\nuclwp_flatten_query_args()<\/code> that flattens nested arrays into name[sub][sub]<\/code> \/ value pairs suitable for hidden form inputs. Reusable from any template that needs to pass current GET state through a <form method=\"GET\"><\/code>.<\/li>\n<\/ul>\n\n1.16.0<\/h4>\n\n
\n
ucl-listing-style-1\/2\/3<\/code>) added on single-listing pages; templates are unchanged so all theme overrides keep working.<\/li>\nuclwp_search_price_chips<\/code>.<\/li>\n[uclwp_search_results]<\/code> now supports a top_bar=\"enable\"<\/code> attribute (default disable<\/code>) that adds the same sort + grid\/list switcher the [uclwp_listings]<\/code> shortcode renders.<\/li>\nucl_listing_zoom<\/code> input (Leaflet zoomend<\/code> and Google zoom_changed<\/code> 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.<\/li>\ncolumns<\/code> shortcode attribute (1\u20136, default 4) controls how many secondary-field cells appear per row via CSS grid. Mobile collapses to 2 columns at \u2264768px and 1 column at \u2264480px.<\/li>\n[style*=\"--ucl-card-image-ratio\"]<\/code>, which never matched because the variable is emitted via an inline <style><\/code> tag, not the element's style<\/code> attribute. The aspect-ratio rule now applies directly to .uclwp-grid-box-wrap .uclwp-image<\/code> and .uclwp-list-box-wrap .uclwp-image<\/code>, so all four card styles honour the chosen ratio.<\/li>\n<\/ul>\n\n1.15.0<\/h4>\n\n
\n
[uclwp_search_form style=\"2\"]<\/code> and [uclwp_search_form style=\"3\"]<\/code>.\n\n\n
search_form_heading<\/code> \/ search_form_subheading<\/code> settings.<\/li>\n<\/ul><\/li>\nuclwp_render_price_range_search()<\/code> helper renders a modern two-input price control with the currency symbol affixed inside each input, plus optional quick-pick chips (\"Up to $100\", \"Up to $500\", etc.). Used by styles 2 and 3. Preset chip values are filterable via uclwp_search_price_chips<\/code>.<\/li>\n.ucl-display-listings<\/code> so single-listing sidebars and the compare box are unaffected.<\/li>\n[uclwp_categories]<\/code> (and the underlying render_category_image()<\/code>) no longer renders the saved Bootstrap-icon class. The previous wrapper produced class=\"bi bi-{bi bi-house}\"<\/code>, an invalid class that resolved to nothing. Output is now class=\"bi bi-house\"<\/code> (or the admin-set value). Categories with a saved icon will start rendering it immediately on update.<\/li>\n<li><\/code> rows now apply overflow: hidden; text-overflow: ellipsis; white-space: nowrap;<\/code> and pick up the missing right padding so the email truncates inside the bordered chip.<\/li>\n<\/ul>\n\n1.14.2<\/h4>\n\n