Shopify Year Make Model Advance Search App User Guide


Thank you for purchasing Year Make Model Advance Search Shopify App. If you have any difficulty with this App or you find an issue, please feel free to send us a message: shopify@capacitywebsolutions.com

Below you will find the detailed documentation on how to use our App and we wish you have a great experience with our Shopify App.

How to Use it


This App is a handy tool to Search Products very quickly from large products database.

Year Make Model Advance Search allows your customers to find products on your website by Year, Make, Model or any additional fields you have created with the help of this App.


Check Live Demo Here

App Installation


1. Click here to visit our Shopify App >> Shopify Year Make Model Advance Search App

2. Click on Get button.

Install

Show YMM on Frontend


  1. Go to Admin >> Apps >> Year Make Model Advance Search >> How to Use it

  2. Step-1: Copy Template Code by click on Copy to Clipboard.#

  3. Step-2: Click on Go to Theme and Paste Template Code in your Current Active Theme.

    From your Shopify admin, click on Online Store >> Themes and Select your Current Active Theme.

    Current Active Theme

    NOTE: You can Paste Template Code either in Layout/theme.liquid (It will show everywhere in store) OR Templates/index.liquid (It will show in Homepage only).  Watch Video Guide (click here)
    Paste Shortcode

Modify YMM Shortcode


  1. Go to Admin >> Apps >> Year Make Model Advance Search >> How to Use it

  2. In Modify Template code section, You can Enter YMM Searchbox Title and Choose Searchbox Style.

  3. NOTE: After Modify, You need to Re-paste template code if its already exists in your theme file.

  4. Modify Shortcode

  5. Horizontal Style for YMM Search Box:
  6. Horizontal YMM

  7. Vertical Style for YMM Search Box:
  8. Vertical YMM

How to Edit YMM Searchbox Texts into my Language?


  1. Step-1: From your Shopify admin, click on Online Store >> Themes and Select your Current Active Theme.

  2. Step-2: Go to Locales Folder and choose en.default.json file.

    Add below code at the end of JSON File before closing curly brace ("}") but please put comma(,) first.
     

  3. Where to add YMM Language Translation Code in theme file?

  4. Step-3:  Now Go to Online Store >> Themes >> Select your Current Active Theme and Click on "Edit Languages" like below snapshot:

    Edit Languages

  5. Step-4:  You can see Ymm App section in your Language section here you can Enter Language Strings for YMM Searchbox like below snapshot:

    Where to enter ymm texts into my language?

Manage Fields


  1. Go to Admin >> Apps >> Year Make Model Advance Search >>Manage Fields

  2. From here, You can Manage Multiple Dropdowns as per your requirement. Watch Video Guide (click here)
  3. Manage Fields

Add YMM


  1. Go to Admin >> Apps >> Year Make Model Advance Search >>Add YMM

  2. From Here, You can ADD YMM values easily by Auto Suggestion feature, which suggest you about previous YMM values while adding a new record.

    >> Watch Video Guide (click here)

  3. Also, You can Assign selected products to YMM record easily just follow the steps listed in below window: Add YMM

Manage YMM


  1. Go to Admin >> Apps >> Year Make Model Advance Search >>Manage YMM

  2. From Here, You can Manage YMM data by Edit / Delete / Search operations.

  3. Manage YMM

Bulk Product Assign


  1. Go to Admin >> Apps >> Year Make Model Advance Search >> Bulk Product Assign

  2. From Here, You can Bulk Assign Products quickly to Multipe YMM Rows.

    For Bulk Assign, Just follow the steps mentioned in below window:
  3. Bulk Product Assign

Universal Products

 >> Watch Video Guide (click here)

Question: What is the use of Universal Products ?

Answer: Universal Products are very helpful to show it in every YMM Search result.

  1. How to use Universal Products Option ?


  2. Go to Admin >> Apps >> Year Make Model Advance Search >> Universal Products

  3. Step-1: Choose option as Yes from dropdown.

  4. Step-2: You can choose whether to Display Universal Products First or Last from Display Universal Products By option.

  5. Step-3: Just Assign your Universal Products by Select Products from Leftside box and then Click on right arrow to move Products into selected list.

  6. Step-4: Then click on Save Settings button.

  7. Universal Product Assign

Import/Export


  1. Go to Admin >> Apps >> Year Make Model Advance Search >> Import/Export

  2. From here, You can Import/Export YMM Rows.

  3. Import/Export

How to create YMM CSV from Sample CSV?


  1. Go to Admin >> Apps >> Year Make Model Advance Search >> Import/Export

  2. From here, You can Download Sample CSV then Modify / Add entries in it.

  3. >> Watch Video Guide (click here)
  4. Import/Export

How to Import YMM Rows with Product Id?


  1. To Import YMM Records,You have to Upload CSV File here if you're not sure about CSV Format then Please click on Download Sample CSV button.

  2. Please read below Instructions carefully before Import CSV:

    1. Please DONOT change/delete CSV Column Ordering/Columns.

  3. 2. Whenever you Change/Add Fields. Please "Download Sample CSV" File to get latest fields and Ordering.

  4. 3. You can refer Store Product Ids by choose Product Range only When there are more than 2000 Products in your Store then Click on Export Product CSV Button.

  5. 4. You must have to keep "Product Ids" as "First Column" in your CSV and Enter Product Ids as "~" (tilde sign) separated like snapshot.

  6. IMPORTANT!  You must have to Enter "Product Id" in your YMM CSV not "Product SKU"


  7. Please follow below steps for Assigning Product Ids in YMM Rows by CSV:


    1. Step-1: Export All Product Ids CSV by select ranges one by one If there are more than 2000 Products in your Store. You have to export all product id csv for each range. Watch Video Guide (click here)

      NOTE: Max. 2000 Published Products are Exported at a time.

    2. Step-2: Merge All Exported Product Ids CSV into one CSV. For this Step > Please open this URL in your browser: https://www.ofoct.com/merge-csv-files and then please follow video guide. Watch this Video (click here) (Optional)

    3. Step-3: Now Next step is to Assign Product IDs to YMM rows in CSV file. It is simple process.Just open your Merged CSV file which is generated in Step-2 and Find your product name then you will see Product ID in First column of it like below snapshot:
      Copy Product Id
      Now just add it in YMM CSV file like below snapshot:How to Import YMM Rows

    4. Step-4: After Prepared Final YMM CSV with assigned Product Ids then Import your YMM CSV.

How to Insert Year Range Rows like - 2001-2010 ?

>> Watch Video Guide (click here)

Question: What is the use of Year Range Feature?

Answer: It will allow you to import same Row for each year of range value means You do not have to add 10 YMM Rows in CSV for the year value which starts from 2001 to 2010, instead of it you just need to write one YMM row in which you have to put range value in your Year column like: 2001-2010.


Please follow below steps for Import Year Range Data:

  1. Step-1: Download sample CSV just by click on button to get your Fields ordering.

  2. Step-2: Then modify with your YMM range values.

  3. Step-3: Save it!

  4. Step-4: Select Enable Year Ranges option and Choose your Range Field which have "Year Range Data" for e.x: If Field name is: "My Year" then choose it from Dropdown.

  5. Step-5: Then after Click on Upload button.


  6. Year Range Feature CSV Template:


Note About Year Range Feature:

1. If you specify Year Range then it must be Numeric value only and it must be in four digit format YYYY otherwise it will be skipped.

2. If you have entered range value like 2002-2005 & Choose Wrong Range Field from Dropdown then it will add one YMM Row only with field value as "2002-2005" , not three rows for the years - 2002 to 2005.

Import Rows Option


  1. You can Import YMM Rows either with Bulk Insert / Append Rows / Update Rows option.

  2. 1. Bulk Insert option will Clear Old YMM Rows & Adding Whole New YMM Data.  (Click here to get details on How to Bulk Insert Rows)

  3. 2. Append Rows option will Append (Add) Rows to existing YMM Rows, it doesn't Delete old YMM data. (Click here to get details on How to Append Rows)

  4. 3. Update Rows option will allow you to update existing records. (Click here to get details on How to Update Rows)

  5. Import Rows Option

How to Bulk Insert Rows?

 >> Watch Video Guide (click here)
  1.  All Previous Records will be deleted by Bulk Insert option. So, please be careful & take Backup by Export YMM Records CSV first.


  2. Step-1: Download sample csv file for Adding New Rows.

  3. Step-2: Then Modify CSV for your New YMM values.

  4. Step-3: To Assign Products to YMM Rows by CSV then just click on Export Products CSV button.

  5. Step-4: Refer Product Id from exported products csv in your YMM rows just enter "~" tilde sign between Product Id if its multiple

  6. Step-5: Save it & Upload your modified CSV just by:

  7. - Choose your modified CSV file.

  8. - Choose Bulk Insert option.

  9. - If you have enter year ranges like: 2002-2005 then only you have to select "Enable Year range values" checkbox and choose your field that contains year range value from dropdown.

  10. - Then after Click on Upload button.

How to Append (Add) Rows to existing YMM Rows?

 >> Watch Video Guide (click here)
  1. Step-1: Download current Rows CSV from Export CSV section.

  2. Step-2: Choose CSV Template as Bulk Insert/Append Rows from dropdown.

  3. Step-3: Click on Export YMM CSV button then open your downloaded CSV.

  4. Step-4: You can Add new Rows within this CSV.

  5. Step-5: Upload your modified CSV just by:

  6. - Choose your modified CSV file

  7. - Choose Append Rows option

  8. - If you have enter year ranges like: 2002-2005 then only you have to select "Enable Year range values" checkbox and choose your field that contains year range value from dropdown.

  9. - Then after Click on Upload button.

How to Update Existing YMM Rows via CSV ?

 >> Watch Video Guide (click here)
  1. Step-1: Download current Rows CSV from Export CSV section.

  2. Step-2: Choose CSV Template as Update Rows from dropdown.

  3. Step-3: Then Click on Export YMM CSV button.

  4. Step-4: Open your downloaded CSV.

  5. Step-5: Update YMM Rows as per your need.

  6. Warning!
    1. Please do not modify "Id" column value and also keep this column as it is.

    2. Update Rows will not work with year range value import.

  7. Step-6: Upload this modified CSV from Import section just by

  8. - Choose your modified CSV file.

  9. - Choose Update Rows option from Import Rows by Dropdown.

  10. - Then after Click on Upload button.


  11. Update Rows CSV Format:


Export YMM CSV


  1. You can Export YMM Rows by choose CSV Template option such as either Bulk Insert/Append Rows OR Update Rows then after Click on Export YMM CSV button.

  2. Export YMM

How to fix errors while Import YMM CSV into my Language?


  1. This is caused by improper CSV format.Please use openoffice.org calc spreadsheet application and saving in UTF-8 format. OR Please use Google Doc for Convert Your CSV in UTF-8 format.

  2. Please refer below section for more details on How to convert CSV file in UTF-8 format.

How to convert CSV file in UTF-8 format?


  1. For Convert your file in UTF-8 please follow below steps:

  2. Using Google Sheets:

  3. Step-1:  Go to https://www.google.co.in/sheets/about/ login using your gmail account. Click on Blank.

  4. Step-2:  Go to File -> Open and upload your file.

  5. Step-3:  After upload your file File -> Download as -> Comma-seperated values (.csv, current sheet)

  6. Step-4:  Your file will be start downloading.

  7. Note: Don't forget to remove space from file name.

How to do App Code Uninstallation manually?


After App Uninstalled by Store Owner, Shopify does not permit us to access files on your store. So, You have to remove App code files manually from your Active Theme or Any Theme in which You had previously installed YMM APP Files.

  1. Step-1: From your Shopify admin, click on Online Store >> Themes and Select your Current Active Theme and Delete 7 files one by one:
    • Folder: templates & Filename: page.ymm-custom.liquid
    • Folder: snippets & Filename: ymm-searchbox.liquid
    • Folder: assets & Filename: ymm-custompage.css
    • Folder: assets & Filename: ymm-custompage.js
    • Folder: assets & Filename:ymm-searchbox.css
    • Folder: assets & Filename: loader.gif
    • Folder:assets & Filename: no_img.png

  2. Current Active Theme

  3. Step-2: From your Shopify admin, click on Online Store >> Pages and Delete "Product Result" Page(Custom YMM APP Page):
    Delete YMM Product Result Page

Customer Support


If you have any questions, please do not hesitate to contact us at shopify@capacitywebsolutions.com.We are happy to help!

Please add our email: shopify@capacitywebsolutions.com to your address book to ensure our response email isn’t marked as spam mail.

We will try our best to reply your emails as soon as possible , except weekends and National Holidays.

Thank you.
Capacity Web Solutions Team

Credits