# WooCommerce Vehicle Parts Finder

Make/Model/Year/Engine/Category/Keyword

## Introduction #back to top

- Item Name : WooCommerce Vehicle Parts Finder - Make/Model/Year/Engine/Category/Keyword
- Author : WP Instinct
- Website : http://wpinstinct.com/
- Email ID : wpinstinct@gmail.com
- Skype ID : wpinstinct

First of all, Thank you so much for purchasing this plugin and for being my loyal customer. You are awesome!
You are entitled to get exceptional support from the author directly and free lifetime updates to this plugin.

This plugin is an add-on for WooCommerce so make sure that you have installed and activated WooCommerce before using this plugin.

## Menu #back to top

- Terms - There you manage VPF Terms ( Makes / Models / Years / Engines ).
- Import CSV - This page allows you to upload VPF Terms quickly through CSV Importer Tool rather you add it one by one manually.
- Settings - This menu allows you to manage all the global settings of plugin from single page.

## Settings #back to top

#### General Options - #back to top

1. Activate Chosen - This option converts the default select/drop boxes to much more user-friendly select boxes. You can find an example on this page: https://harvesthq.github.io/chosen/
2. Disable Dependent Fields - This option prevents the opening of the next drop-downs until one chooses current drop-down.
3. Show Empty Terms - This option forces system to show empty terms in drop-downs.
4. Remember Search - This option restricts WooCommerce Catalog to show only user searched criteria matching products whole over the website. For example:
   - User visits WooCommerce Shop page which shows all the products website have.
   - User searches for Make: Audi, Model: Cabriolet, Year: 2017, Engine: 67.72L.
   - A search results page comes with products which match user selected terms ( Audi, Cabriolet, 2017, 67.72L ).
   - Now User re-visits WooCommerce Shop page and this time it will show only those products which match user selected terms.
5. Disable Redirect Single Search Result - By default, WooCommerce redirects the users to product details page if there is only one product for user search. This option prevents the redirection to product details page when there is only one search result.
6. Years Sort Order - By default, VPF filter shows years from oldest to newest in select/drop boxes. This option allows you to change it from newest to oldest.

#### Labels - #back to top

This section allows the administrator to set labels of VPF terms for frontend. EG: You want "Make" to be labelled as "Brand" on frontend, you can change this under setting "Make Label". In same way you can change labels for other terms too.

1. Make Label - This option allows you to change/override the default label for Make wholeover the website. By default its value is "Make" but you can change it with your required label.
2. Model Label - This option allows you to change/override the default label for Model wholeover the website. By default its value is "Model" but you can change it with your required label.
3. Year Label - This option allows you to change/override the default label for Years wholeover the website. By default its value is "Year" but you can change it with your required label.
4. Engine Label - This option allows you to change/override the default label for Engines wholeover the website. By default its value is "Engine" but you can change it with your required label.
5. Category Label - This option allows you to change/override the default label for Categories. By default its value is "Category" but you can change it with your required label.
6. Keyword Label - This option allows you to change/override the default label for Keyword text field. By default its value is "Keyword" but you can change it with your required label.
7. Search Results Label - This option allows you to change/override the default base label of Search Results heading. By default its value is "Search results for:" but you can change it with your required label.

#### Admin Panel Options - #back to top

1. Activate Quick Edit - This option allows the administrator to show/hide the VPF terms on product quick edit screen. However, disabling this option helps to prevent blank screen on product listing page in case of heavy list of terms.
2. CSV Comma Separated Columns - Importing VPF terms using plugin's CSV Importer Tool, few times you want to add multiple terms in single column than individual row per term in CSV. This option allows you to choose the comma separation supported columns for CSV while importing terms. Eg: 2004, 2005, 2008
3. CSV Range Supported Columns - Importing VPF terms using plugin's CSV Importer Tool, few times you want to add years through year range rather than individual year per row in CSV. This option allows you to choose which columns you want to add range support by using dash (-). Eg: 2004-2008
4. Terms Metabox Template - If you are well familiar with WordPress meta boxes then you can easily understand what this option is for. While adding/editing a product you will see VPF Terms Selector meta box in same way of Product Categoies Selector meta box. This meta box is not too easy to use where you have a long list of checkboxes to select. You can change the layout of this meta box in more user friendly layout by trying different options under this setting.
5. Universal Products - This option allows you to choose universal products which fits with all VPF Terms. Note: Those products will always be in search results on frontend.
6. Categories to Include - This option allows you to show only specific categories over all categories in filter select/drop boxes. Leaving it empty will show all categories in select/drop boxes.

#### My Garage Options - #back to top

This plugin comes with a very nice feature "My Vehicles" which allows frontend visitors/users to save their searches. They can directly access/visit their searches later from their search histories or saved searches with simple "click to go" link rather than re-filling search form again and again.
Function to show "My Vehicles" widget: WOO_VPF_My_Vehicles::get_template();

1. Activate My Vehicles - This option allows the administrator to enable/disable "My Vehicles" feature whole over the website. This option requires "Remember Search" option enabled in order to work properly.
2. Main Title - This option allows you to change the main title of the widget on frontend. By default its "My Garage:" but you can change it with what you want.
3. Saved Vehicles - Limit - This option allows the administrator to limit maximum number of saved searches per user. Everytime, a user tries to save another search where he has already saved maximum number of searches, the new search will take place by removing first saved search from the list.
4. Saved Vehicles - Title - This options allows you to change the title from "My Saved Vehicles" with your choice title under "My Saved Searches" section.
5. Saved Vehicles - Description - This options allows you to add a short description just after title under "My Saved Searches" section.
6. Saved Vehicles - No Items - This option allows you to set the text which will display when there is no item in "My Saved Searches" section.
7. Saved Vehicles - Clear History - This option allows you to change the text for "Clear History" link under "My Saved Searches" section.
8. Vehicles History - Limit - This option allows the administrator to limit maximum number of search histories per user/visitor. Everytime, a user performs a new search where he has already performed maximum number of searches, the new search will take place by removing first search history from the list.
9. Vehicles History - Title - This options allows you to change the title from "Vehicles History" with your choice title under "My Search Histories" section.
10. Vehicles History - Description - This options allows you to add a short description just after title under "My Search Histories" section.
11. Vehicles History - No Items - This option allows you to set the text which will display when there is no item in "My Search Histories" section.
12. Vehicles History - Clear History - This option allows you to change the text for "Clear History" link under "My Search Histories" section.
13. Add Vehicle Text - This option allows you to change the text for "Add Vehicle" link under "My Search Histories" section.
14. Add Vehicle Heading - This option allows you to change the title for "Add Vehicle" poopup.
15. Add Vehicle Description - This option allows you to add a short description just after title under "Add Vehicle" poopup.
16. Add Vehicle Shortcode - This is the setting which allows you to setup the VPF filter search form in "Add Vehicle" poopup.

#### Custom Tab Options - #back to top

This section allows administrator to show a custom tab on fontend in product details page along with other WooCommerce tabs which will display all the Makes/Models/Years/Engines assigned to this particular product.

1. Activate Tab - This option allows the administrator to enable/disable VPF custom tab on product details page.
2. Ajax - Use this option while you have a long list of terms to show on the product details page and it's slowing down the speed. This option will force the terms to load via ajax once the page loads completely.
3. Ajax Loading Text - This option allows you to set a text which shows before the terms load via ajax. eg: Loading...
4. Tab Title - This option allows the administrator to set the title for VPF custom tab.
5. Tab Heading - This option allows the administrator to set the heading under VPF custom tab which shows just above the VPF terms list.
6. Tab Description - This option allows the administrator to add a short description just after heading under VPF custom tab.
7. Show Engines - This option allows the administrator to show/hide the ENGINE column in VPF custom tab.
8. Show Year in Ranges - Few times, you have a long list of VPF terms per product. This setting allows you to wrap the rows in ranges for years if Makes/Models/Engines are same at the same time with different set of years. That way it helps to fit large list of terms in less area.

#### Validation Rules - #back to top

This section allows administrator to add validations for VPF filter form fields. Administrator can customize the validation messages as well under this section.

## Widget #back to top

- Title - This option follows other widgets in order to show widget title on front end.
- View - This option comes with two layouts: Horizontal and Vertical. By default it's Vertical.
- Make Label - This option allows you to change/override the default label for Make drop down. By default its value is "Select Make" but you can change it with your required label.
- Model Label - This option allows you to change/override the default label for Model drop down. By default its value is "Select Model" but you can change it with your required label.
- Show Years Filter? - This option allows you to show/hide Years drop down in filter. Use true if you want to show Years drop down, otherwise false.
- Year Label - This option allows you to change/override the default label for Years drop down. By default its value is "Select Year" but you can change it with your required label.
- Show Engines Filter? - This option allows you to show/hide Engines drop down in filter. Use true if you want to show Engines drop down, otherwise false.
- Engine Label - This option allows you to change/override the default label for Engines drop down. By default its value is "Select Engine" but you can change it with your required label.
- Show Categories Filter? - This option allows you to show/hide Categories drop down in filter. Use true if you want to show Categories drop down, otherwise false.
- Category Label - This option allows you to change/override the default label for Categories drop down. By default its value is "Select Category" but you can change it with your required label.
- Show Keyword? - This option allows you to show/hide Keyword text field in filter. Use true if you want to show Keyword text field, otherwise false.
- Keyword Label - This option allows you to change/override the default label for Keyword text field. By default its value is "Product Name" but you can change it with your required label.
- Show My Vehicles Widget? - This option allows you to show/hide "My Vehicles" sub widget in filter. Use true if you want to show this widget, otherwise false.
- Search Button Label - This option allows you to change/override the default label for Search button. By default its value is "Search" but you can change it with your required label.
- Reset Search Label - This option allows you to change/override the default label for RESET Search button. By default its value is "Reset Search" but you can change it with your required label.

## Shortcode #back to top

#### Vehicle Parts Finder - #back to top

    [woo_vpf_filter title="Vehicle Parts Filter" view="H/V" label_make="Select Make" label_model="Select Model" show_year="true/false" label_year="Select Year" show_engine="true/false" label_engine="Select Engine" show_category="true/false" label_category="Select Category" show_keyword="true/false" label_keyword="Product Name" show_my_vehicles="" label_search="Search" label_reset_search="Reset Search"]

- title - For the time this option is of no use but has been added for future reference
- view - This filter comes with two layouts: Horizontal and Vertical. Use H for horizontal layout and V for vertical layout. By default its value is V.
- label_make - This option allows you to change/override the default label for Make drop down. By default its value is "Select Make" but you can change it with your required label.
- label_model - This option allows you to change/override the default label for Model drop down. By default its value is "Select Model" but you can change it with your required label.
- show_year - This option allows you to show/hide Years drop down in filter. Use true if you want to show Years drop down, otherwise false.
- label_year - This option allows you to change/override the default label for Years drop down. By default its value is "Select Year" but you can change it with your required label.
- show_engine - This option allows you to show/hide Engines drop down in filter. Use true if you want to show Engines drop down, otherwise false.
- label_engine - This option allows you to change/override the default label for Engines drop down. By default its value is "Select Engine" but you can change it with your required label.
- show_category - This option allows you to show/hide Categories drop down in filter. Use true if you want to show Categories drop down, otherwise false.
- label_category - This option allows you to change/override the default label for Categories drop down. By default its value is "Select Category" but you can change it with your required label.
- show_keyword - This option allows you to show/hide Keyword text field in filter. Use true if you want to show Keyword text field, otherwise false.
- label_keyword - This option allows you to change/override the default label for Keyword text field. By default its value is "Product Name" but you can change it with your required label.
- show_my_vehicles - This option allows you to show/hide "My Vehicles" sub widget in filter. Use true if you want to show this widget, otherwise false.
- label_search - This option allows you to change/override the default label for Search button. By default its value is "Search" but you can change it with your required label.
- label_reset_search - This option allows you to change/override the default label for RESET Search button. By default its value is "Reset Search" but you can change it with your required label.

#### Product Terms List - #back to top

    [vpf_product_terms_list id=""]

- id - ( Optional ) This option contains the product ID for which you want to show the VPF Terms. By default, it picks the ID of current product if you are using it on product details page somewhere.

## CSV Importer Tool #back to top

1. Delete existing terms This option allows you to delete previous existing terms before importing new terms from CSV file.
2. Product matching column This option allows you to choose whether you use SKU or Slug in CSV file for products auto association with terms.

## Thank You #back to top

Once again, thank you so much for purchasing this plugin. I'd be glad to help you if you have any questions relating to this plugin. No guarantees, but I'll do my best to assist. If you have a more general question relating to the other plugins on CodeCanyon, you might consider asking your question through email.