=== AWC Vehicle Fitment Search ===

Company: Merchandising & Services Logistics Group Pty Ltd
Trading Name: Australian Web Connections
Contributors: australianwebconnections
Developers: Jakob Wilson, James Alickolli
Testers: Explore Off Road, Auscamper Group Pty Ltd
Tags: woocommerce, vehicle fitment, vehicle search, year make model, product filter
Requires at least: 4.7
Requires PHP: 7.4
Requires Plugins: woocommerce
Tested up to: 7.1
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AWC Vehicle Fitment Search helps customers find products that match their vehicle, using a clear Make, Model, and Year selection experience.


== Description ==

AWC Vehicle Fitment Search brings vehicle-aware product discovery to WooCommerce stores. Store administrators assign vehicle restrictions to products, and customers can then filter the catalogue using the vehicles that those products support.

The selector can be placed through the standard WordPress widget, shortcode, Elementor, ForgeEngine, or PageLayer. The ForgeEngine widget provides the same controls and rendering behaviour as the Elementor widget. It supports both vertical and horizontal layouts, product-category filtering, optional category selectors, and an optional search field.

The My Garage feature lets customers save vehicles for quick access. Guest Garage vehicles are retained in the browser, while logged-in customers can save and manage vehicles from their WooCommerce account. Saved vehicles can be selected for future searches, added from the My Garage account page, and removed when no longer needed.

== How It Works ==

1. Add vehicle fitment restrictions to products from the AWC Vehicle Fitment panel on the WooCommerce product edit screen.
2. Add the AWC Vehicle Fitment Search widget or shortcode to the part of the store where customers search.
3. Customers choose their Make, Model, and Year to see compatible products.
4. When enabled, customers can save a vehicle to My Garage and use it again across their account.
5. Use the AWC admin settings to manage selector behaviour and customise the My Garage labels, form typography, dropdown boxes, and account action buttons.

== Main Features ==

* Vehicle fitment search for WooCommerce products using Make, Model, and Year.
* Product filtering on the shop and product-category pages.
* Compatible vehicle information on individual product pages.
* Vertical and horizontal selector layouts for flexible store design.
* Optional category dropdowns and search field.
* My Garage for saved vehicle selection and repeat searches.
* Guest Garage support with migration to the customer account after login.
* WooCommerce My Account > My Garage management for adding, selecting, and removing vehicles.
* Support for multiple saved vehicles, with up to 10 vehicles per customer account.
* Add and remove Garage controls on the public selector when enabled.
* Elementor, ForgeEngine, and PageLayer integration through the shared selector implementation.
* Standard WordPress widget and shortcode support.
* CSV import and export for product fitment restrictions.
* Admin controls for selector settings and My Garage labels.
* My Garage styling controls for form typography, dropdown boxes, Add Vehicle, Use Vehicle, and Remove buttons.
* Live Admin preview for My Garage settings before saving.
* Translation-ready interface using the `awc-vehicle-fitment-search` text domain.


== Installation ==

1. Download the AWC Vehicle Fitment Search plugin package.
2. In WordPress, go to **Plugins > Add New > Upload Plugin**.
3. Upload the plugin ZIP file and select **Install Now**.
4. Select **Activate Plugin** after installation finishes.
5. Confirm that WooCommerce is installed and active.
6. Go to **AWC Vehicle Fitment Search** in the WordPress admin menu and import vehicle data or configure the selector settings.
7. Edit a WooCommerce product and use the **Vehicle Fitment** panel to assign compatible vehicles.
8. Add the selector using the WordPress widget, shortcode `[awcvefis_selector]`, Elementor, or PageLayer.
9. Review the selector and Garage settings on the front end, then test a vehicle search.

To update the plugin, install the new version over the existing version from the WordPress Plugins screen. Existing vehicle data, selector settings, and account Garage data are retained during normal upgrades.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. AWC Vehicle Fitment Search is designed for WooCommerce product and category pages and requires WooCommerce to be active.

= Can customers use My Garage without logging in? =

Yes. Guest vehicles are stored in the browser. When a customer logs in, their guest Garage vehicles can be migrated to their account.

= How many vehicles can a customer save? =

Each customer account can save up to 10 vehicles.

= Can I customise the My Garage buttons? =

Yes. The My Garage Settings screen includes controls for typography, colours, borders, radius, and sizing for the Add Vehicle, Use Vehicle, and Remove buttons. The Admin preview updates before settings are saved.

= Where can I see the plugin in action? =

See the plugin in use on live customer sites: [www.exploreoffroad.com.au](https://www.exploreoffroad.com.au) and [shop.austrackcampers.com.au](https://shop.austrackcampers.com.au)

== Other AWC Plugins ==

* [AWC Cost Pricing and Purchase Orders](https://wordpress.org/plugins/awc-cost-pricing-and-purchase-orders-for-woocommerce/) - manage cost pricing and purchase order workflows in WooCommerce.


