=== Car Listings ===
Contributors: yourname
Tags: car listings, vehicle, automobile, filter, gallery
Requires at least: 5.8
Tested up to: 6.5
Stable tag: 1.0.0
License: GPLv2 or later

A complete car listing plugin with filters, gallery, YouTube video, custom fields, sold ribbon, and contact info.

== Description ==

**Car Listings** lets you build a professional car showcase on your WordPress site without any e-commerce setup.

= Features =
* Card-based grid layout with image gallery per car (up to 10 images)
* AJAX-powered filter bar: Make, Body Type, Fuel, Transmission, Condition, Year range, Price range, Mileage
* Sort by Newest / Price Low–High / Price High–Low
* "Sold" ribbon on sold listings
* "Featured" badge + pin-to-top for featured cars
* YouTube video embed on detail page
* Custom info fields (unlimited key/value pairs per car)
* Highlighted price display
* Recently Viewed cars (stored in browser)
* Classic pagination
* Contact info block (set once in Settings, shown on all detail pages)
* WhatsApp, Phone, and Email contact buttons
* Social share buttons (Facebook, WhatsApp, Twitter/X)
* CSV bulk import
* Shortcode: `[car_listings]`
* No extra plugins required

== Installation ==

1. Upload the `car-listings` folder to `/wp-content/plugins/`
2. Activate the plugin in **Plugins > Installed Plugins**
3. Go to **Car Listings > Settings** and fill in your contact info
4. Create a page, add the shortcode `[car_listings]`, and publish
5. Go to **Car Listings > Add New Car** to start adding cars

== Shortcode ==

`[car_listings]` — Display the full listing page with filters.

Optional attributes:
- `per_page` — Number of cars per page (default from Settings)
- `columns` — Grid columns: 2 or 3 (default 3)

Example: `[car_listings per_page="6" columns="2"]`

== CSV Import ==

Go to **Car Listings > CSV Import** to bulk-upload cars.
Download the sample CSV from that page to see the correct column format.

== Changelog ==

= 1.0.0 =
* Initial release
