WooCommerce Vehicle Parts Finder

Year/Make/Model/Engine/Category/Keyword


Introduction #back to top


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.

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. 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 Year: 2017, Make: Audi, Model: Cabriolet, Engine: 67.72L.
    • A search results page comes with products which match user selected terms ( 2017, Audi, Cabriolet, 67.72L ).
    • Now User re-visits WooCommerce Shop page and this time it will show only those products which match user selected terms.
  4. 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.
  5. 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. 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.
  2. 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.
  3. 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.
  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. CSV Product Column - While importing terms, there is a column in CSV labeled item_product. This column, by deault, accepts product slugs. Most of the time, you want to import it by product SKU and not by slug and this option is what you can use for this purpose.
  5. 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.
  6. 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.
  7. 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_YMM_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 Years/Makes/Models/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. Tab Title - This option allows the administrator to set the title for VPF custom tab.
  3. Tab Heading - This option allows the administrator to set the heading under VPF custom tab which shows just above the VPF terms list.
  4. Tab Description - This option allows the administrator to add a short description just after heading under VPF custom tab.
  5. 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.
  • 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.
  • 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.
  • Show Models Filter? - This option allows you to show/hide Models drop down in filter. Use true if you want to show Models drop down, otherwise false.
  • 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 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

[woo_vpf_ymm_filter title="Vehicle Parts Filter" view="H/V" label_year="Select Year" label_make="Select Make" show_model="true/false" label_model="Select Model" 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_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.
  • 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.
  • show_model - This option allows you to show/hide Models drop down in filter. Use true if you want to show Models drop down, otherwise false.
  • 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_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.

CSV Importer Tool #back to top

  1. 5 Columns
    • Upload a CSV file having 5 columns: item_year, item_make, item_model, item_engine, item_product.
    • In case you don't have anything to add for any of these columns, just add empty column on its position with correct header.
  2. item_product Column
    • This column should always be on 5th position. In case if you don't have engines but still want ao add products in item_product column, then you can add an empty column with header item_engine on 4th position so that item_product column still remains on 5th position.
    • This column should contain the product skus/slugs based on what setting you choose from plugin's setting panel. For this, visit plugin's setting panel and look for CSV Product Column option under Settings: Admin tab.
  3. Multiple Values per Cell/Column
    • You can use comma seperated multiple values for selected columns from plugin's setting panel under option CSV Comma Separated Columns. This option is mostly useful for multiple Years and Product SKU's/Slugs. EG: 2003, 2004, 2005, 2007
    • You can use value ranges as well for selected columns from plugin's setting panel under option CSV Range Supported Columns. This option is mostly useful for multiple Years. EG: 2003-2007, 2009-2012
  4. Success Message
    • You will see a success message once import process completes.
    • If import process stops half the way, there can be a number of reasons behind this. The most common reason for this is server configuration. There are few server configurations which should have a higher value for smooth process: max_execution_time, memory_limit, etc..
    • In case if process stops half the way, you still can re-import same CSV file again and it will not duplicate already imported terms and will add only pending or new 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.