=== Best Classifieds ===

Contributors: fasterthemes
Tags: blog, two-columns, right-sidebar, custom-colors, custom-logo, custom-menu, featured-images, footer-widgets, full-width-template, threaded-comments, translation-ready, theme-options, block-styles, wide-blocks, accessibility-ready
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 2.0.0
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A refined, classy WordPress theme for classified ads and marketplace websites.

== Description ==

Best Classifieds is a refined, classy WordPress theme for launching professional classified ads and marketplace websites. With editorial typography (Playfair Display + Inter), a deep emerald and warm cream color palette with gold accents, and a clean two-column layout, it stands apart from typical loud classifieds designs.

Built mobile-first, fully responsive, translation-ready, and tuned for fast Core Web Vitals. Perfect for local marketplaces, niche classifieds, real estate listings, vehicle sales, jobs, and community ad sites.

= Features =

* Single, classy color palette: deep emerald, warm cream, muted gold accent
* Self-hosted Playfair Display + Inter fonts (GDPR-friendly, no Google Fonts CDN call)
* Hero section with search bar
* Featured categories grid with custom icons
* Latest listings grid (3 columns desktop / 2 tablet / 1 mobile)
* CTA banner with custom text & link
* Sticky listing detail price card
* Built-in listing meta fields: price, location, condition, contact email, contact phone
* Schema.org Product/Offer markup on listings with prices
* Bundled Tabler Icons webfont (5800+ icons available)
* 2 custom widgets: Latest Listings, Listing Categories
* Customizer panel with hero, homepage section toggles, currency, sidebar position
* 4 footer widget areas
* 3 navigation menu locations: Primary, Footer, Social
* Editor styles for Gutenberg matching the front-end
* Block editor color palette (Emerald, Cream, Charcoal, Gold, Border)
* Translation-ready (POT file in /languages/)
* Accessibility-ready: skip links, ARIA, keyboard nav, reduced motion support
* Compatible with all major SEO and caching plugins

= Best Classifieds Pro plugin (optional) =

The companion plugin "Best Classifieds Pro" extends the free theme with:

* Frontend submission form
* Paid listing packages (Free, Featured, Premium)
* Stripe + Razorpay payment gateways
* Image galleries (up to 10 per listing) with lightbox
* Advanced search with price range, location, custom-field filters
* Custom fields per category (cars: make/model/year, jobs: salary/type, etc.)
* User dashboard (My Ads, Edit, Renew, Messages, Saved Searches)
* Built-in messaging between buyers and sellers
* Saved search alerts (daily/weekly digest emails)
* OpenStreetMap integration (no API key required)
* Bump-up & promote (paid listing refresh)
* Listing expiry & renewal reminders
* Reviews and ratings for sellers
* Report listing for community moderation
* Honeypot + reCAPTCHA v3 anti-spam
* Per-listing analytics (views, contacts, favorites)
* Favorites / wishlist
* Coupons & discounts
* Bulk CSV import
* WPDigiPro license + automatic updates
* 6 additional color palettes (Navy, Oxblood, Charcoal Gold, Sage, Terracotta, Plum)
* 5 additional font combinations
* One-click demo content import

Learn more: https://fasterthemes.com/wordpress-themes/best-classifieds/

== Installation ==

1. In your WordPress admin, go to Appearance > Themes > Add New.
2. Search for "Best Classifieds".
3. Click Install, then Activate.
4. Go to Appearance > Customize to set your hero text, colors, and homepage sections.
5. Go to Posts > Categories and use the auto-created "Listings" category for your ad posts.
6. Each post in the Listings category gets a "Listing Details" meta box on the right side of the post editor for price, location, condition, contact email, and contact phone.
7. Set your homepage: Settings > Reading > "Your latest posts" to show the front-page hero, categories, and latest listings.

= How to add your first listing =

1. Posts > Add New
2. Enter title, description, and a featured image
3. In the right sidebar, expand "Categories" and select "Listings" (or any sub-category)
4. In the "Listing Details" meta box, fill in price, location, condition, and contact info
5. Publish

== Frequently Asked Questions ==

= Why is "post" the post type instead of a Custom Post Type? =

WordPress.org theme guidelines do not allow themes to register Custom Post Types or taxonomies. The free theme uses standard WordPress posts filed under a "Listings" category. The optional Best Classifieds Pro plugin registers a proper "listing" Custom Post Type and migrates your data automatically.

= How do I change the colors? =

Go to Appearance > Customize > Best Classifieds Options > Theme Style. The free theme ships with one carefully chosen palette (Emerald & Cream). Best Classifieds Pro unlocks 6 additional palettes.

= Can I change the fonts? =

The free theme ships with Playfair Display + Inter, self-hosted for speed and GDPR. Best Classifieds Pro adds 5 additional combinations.

= Is the theme translation-ready? =

Yes. A .pot file is included in /languages/. All strings use the "best-classifieds" text domain.

= Does the theme work without the Pro plugin? =

Yes, completely. The free theme is fully functional as a classifieds-style blog with built-in price/location/contact fields on every post. The Pro plugin is optional and only required if you want frontend submission, paid packages, image galleries, etc.

== Changelog ==

= 2.0.0 =
* Complete rebuild from the ground up.
* New refined visual design: editorial typography (Playfair Display + Inter), deep emerald + cream + gold palette.
* Self-hosted fonts (no Google Fonts CDN call).
* Bundled Tabler Icons webfont.
* Built-in listing meta box: price, location, condition, contact.
* Sticky price card on single listing pages.
* Schema.org Product/Offer markup.
* New homepage layout: hero with search, featured categories grid, latest listings, CTA banner.
* 4 footer widget areas.
* 2 custom widgets: Latest Listings, Listing Categories.
* Customizer panel with full theme options.
* Editor styles + block editor color palette.
* Accessibility-ready: skip links, ARIA, keyboard nav.
* Filter hooks throughout for the optional Pro plugin to extend.
* Translation-ready POT file.

= 1.2.2 =
* Previous release. See WordPress.org for legacy changelog.

== Upgrade Notice ==

= 2.0.0 =
Major rebuild. Backup your site before upgrading. Visual design, layout, and Customizer options are completely new. Existing posts and content remain untouched. Custom CSS may need adjustment.

== Credits ==

= Bundled Resources =

* Playfair Display font by Claus Eggers Sørensen
  License: SIL Open Font License, 1.1
  Source: https://fonts.google.com/specimen/Playfair+Display

* Inter font by Rasmus Andersson
  License: SIL Open Font License, 1.1
  Source: https://fonts.google.com/specimen/Inter

* Tabler Icons by Paweł Kuna
  License: MIT License
  Source: https://tabler.io/icons

= Screenshot Image =

Theme screenshot is an original composition by FasterThemes (CC0).

= Default Hero Image =

If used, the default hero image is sourced from Pexels under the Pexels License (free for commercial use, no attribution required).
Source: https://www.pexels.com/

== Resources ==

* Theme homepage: https://fasterthemes.com/wordpress-themes/best-classifieds/
* Documentation: https://docs.fasterthemes.com/best-classifieds-wordpress-theme/
* Support: https://fasterthemes.com/support/
