WooCommerce Pincode/ Zipcode Checker

  • Introduction

    The WooCommerce Pincode/ Zipcode Checker module is a much-needed feature to check the availability of a product by the Zip Code/ Pin Code/ Postal code.

    Features:

    • Check Pincode/ Postal/ Zipcode availability on product page.
    • Pincode/ Zipcode checker works on store and product level.
    • Support all types of Postcodes/ Zipcodes/ Pincodes
    • Bulk CSV import and export.
    • Bulk Editor for Product Level.
    • Single Pincode add, edit, and delete.
    • Disable all payment gateways.
    • Compatible with Dokan Multivendor Lite and Pro versions.
    • Fully responsive.
    • Fully customizable.
    • Supported to all themes with WooCommerce.
    • WPML supported.
    • Shortcode to display Pincode/ Zipcode checker form.
    • 24/7 premium support.
    • Automated updates.
  • How to install plugin

    Step 1: Download the zip file from the codecanyon.net

    Step 2: Extract the downloaded zip file on your desktop or in any folder.

    Step 3: Open the extracted folder “woocommerce-pincode-zipcode-checker“.

    Step 4: Here you found three folders 1) Documentation 2) License 3) Plugin.

    Step 5: Open “Plugin” folder. Now you found the main plugin file “plugin.zip“.

    Step 6: Log in to your WordPress admin panel.

    Step 7: Mouse over the “Plugins” menu and click on “Add new“.

    Step 8: Click on the “Upload Plugin” button and then click on the “Browse” button.

    Step 9: Select the “plugin.zip” file and click on the “Upload” button.

    Step 10: Now the final step, after uploading complete click on the “Activate Plugin” button.

  • Store vs Product Level

    Store Level:

    The store level option allows the admin to set Pincode/Zipcode/Postcode at the store level i.e. if the products to be delivered from a store are all ready to be dispatched at the same time to the particular Pincode/Zipcode/Postcode, the store level setting goes quite well in this case. 

    Example: Let's suppose you have 3 products in your store, Plant, Sunglass and Toy car, all 3 of which are ready to be dispatched at the same time from your store to a particular Pincode/Zipcode/Postcode,  

    1. The plant will be delivered to the Pincode/Zipcode/Postcode 12345678 in 5 days.
    2. The sunglass will be delivered to the Pincode/Zipcode/Postcode 12345678 in 5 days.
    3. The toy car will be delivered to the Pincode/Zipcode/Postcode 12345678 in 5 days.

    In the above example, you can see all the above three products are delivered to the Pincode/Zipcode/Postcode 12345678 in 5 days because of the same time of dispatch.

     

    Product Level:

    The product level option allows the admin to set Pincode/Zipcode/Postcode at the product level i.e. if the products to be delivered from a store to a particular Pincode/Zipcode/Postcode have different dispatch timing, the product level setting is suitable for you.  

    Example: Let's suppose you have 3 products in your store, Plant, Sunglass and Toy car. But all these products have different dispatch duration. These products then definitely would take different times to get delivered to a particular Pincode/Zipcode/Postcode. Suppose,

    1. The plant takes 3 days dispatch time and is delivered to the Pincode/Zipcode/Postcode 12345678 in 5 days.
    2. The sunglass takes 1 day dispatch time and is delivered to the Pincode/Zipcode/Postcode 12345678 in 3 days.
    3. The toy car takes 8 days dispatch time and is delivered to the Pincode/Zipcode/Postcode 12345678 in 10 days.

    In the above example, you can see all three products are delivered to the Pincode/Zipcode/Postcode 12345678 in different periods of time because of different dispatch timings.

    Read more about Product Level.

    Have any questions? Please feel free to contact us for Pre-sale or Support

  • Plugin Settings

    • Appearance Settings

       

      Primary Background Color: Select the primary background color. Default #fafafa

      Primary Text Color: Select the primary text color. Default #333333

      Button Background Color: Select the counter background color. Default #fc563f

      Button Text Color: Select the counter text color. Default #fffff

    • Basic Settings

      Pincode Checker level: Select the pincode checker level.

      • Store Level - common for all products.
      • Product Level - you can set the pincode/ zipcode individually for products.

      Pincode Checker Location: Select the location of pincode/ zipcode checker form.

      Pincode Checker On Cart Page: You can enable/ disable pincode checker on cart page.

      Pincode Checker On Checkout Page: You can enable/ disable pincode checker on checkoue page.

      Disable Payment Gateways?: You can disable all or specific payment gateways if pincode/ zipcode not serviceable.

      Shortcode: You can disable all payment gateways if pincode/ zipcode not serviceable.

      Custom CSS: You can enter the plugin related custom CSS here.

    • Advanced Settings

      Advanced Settings Introduced in version 3.0.0

      Regex Match: Regex match allows you to match the Pincode/Zipcode/Postcode using the regex pattern. It allows you to minimize Pincode/Zipcode/Postcode entries. Read more here

      Regex Match option is only available for the Product level for now.
    • Shop Page Checker Settings

      Introduced in version 1.1.7

      Shop Page Checker: You can enable/disable Pincode checker on the shop page. Default Disable

      Shop Page Checker Location: You can change the location of the Pincode checker on the shop page. Default After Add To Cart Button

      Enter Placeholder Text: Enter the placeholder text for Pincode checker on the shop page.

      Pincode Found Message: Enter the message for the Pincode/ Zipcode found on the shop page.

      Pincode Not Found Message: Enter the message for the Pincode/ Zipcode not found on the shop page.

    • Pincodes

      Pincodes section allow you to mange ( Add, edit, and delete ) pincodes/zipcodes/postcodes directly for WordPress admin.

       

      Add Pincode/zipcode/postcode manually: 

      • Login to the WordPress admin dashboard.
      • Mouse over the Pincode Checker menu and click on the Pincodes link.
      • Click on the Add Pincode button.
      • Enter the Pincode/zipcode, Day(s), Note.
      • Click on the Save Changes button.

       

      Edit existing Pincode/zipcode/postcode manually:

      • Login to the WordPress admin dashboard.
      • Mouse over the Pincode Checker menu and click on the Pincodes link.
      • Select or search the pincode/zipcode/postcode that you want to edit and then click on edit.
      • Change the details you want to.
      • Click on the Save Changes button.

       

      Delete existing Pincode/zipcode/postcode manually:

      • Login to the WordPress admin dashboard.
      • Mouse over the Pincode Checker menu and click on the Pincodes link.
      • Select or search the pincode/zipcode/postcode that you want to edit and then click on delete.
    • Pincode Checker Settings

      Enter Title: Enter the title of pincode/zipcode checker.

      Pincode Found Message: Enter the message for the pincode/ zipcode found.

      • Use {{pincode}} placeholder for display pincode.
      • Use {{days}} placeholder  for display day(s).
      • Use {{calculated-days}} placeholder for display calculated day(s).
      • Use {{note}} placeholder for display note.

      Pincode Not Found Message: Enter the message for the pincode/ zipcode not found.

      • Use {{pincode}} placeholder for display pincode.
      • Use {{days}} placeholder for display day(s).
      • Use {{calculated-days}} placeholder for display calculated day(s).
      • Use {{note}} placeholder  for display note.

      Button Text: Enter the button text.

      Input Placeholder Text: Enter the input placeholder text.

    • Import/ Export

      • Import/ Export Global CSV Steps

        Import and export CSV makes life easy.

        Download Sample CSV: Click on the Download button to download the sample CSV file.

        Export Pincode/ Zipcode CSV: If you want to export the existing uploaded Pincode/zipcode/postcode then click on the Download button.

        Import Pincode/ Zipcode CSV: You can upload the created CSV file here.

         

        Step 1: Go to the plugin settings and click on Import/ Export.

        Step 2: Click on the “Download Sample CSV” – Download Button.

        Step 3: Open the downloaded sample.csv file

        Step 4: Enter your Pincode under the pincode column, Delivery days under the days column, and Message ( You can leave it blank ) under the note column.

        Step 5: Save the CSV file.

        Step 6: upload the CSV file and click on Start Import button.

        Note: Don't change or delete the header row of the sample CSV while you adding the pincodes/zipcodes/postcodes.
  • Product Level

    The product level option allows the admin to set Pincode/Zipcode/Postcode at the product level i.e. if the products to be delivered from a store to a particular Pincode/Zipcode/Postcode have different dispatch timing, the product level setting is suitable for you. 

     

    Pincode/ Zipcode Product Level Settings:

    You can find the option to set the product deliverability on each product page. Make sure, you selected Product Level from Pincode Checker > Basic Settings > Pincode Checker level dropdown.

     

    Uploaded CSV (Priority 4): Uploaded CSV or Global CSV is the simplest way to add Pincodes/Zipcodes/ Postcodes for all existing products. By default, this option is enabled for all products. Let's suppose, you have 10 products in-store and all products' delivery time is the same for the particular Pincode/Zipcode/Postcode then the Uploaded CSV option is best for you.

    Zone (Priority 3): Zones are the best way to show delivery time if the product has different delivery times for different Pincodes/Zipcodes/Postcodes. Let's suppose, you have product A and Product A can deliver to the Pincode/Zipcode/Postcode 123456 in 10 days, and can deliver to the Pincode/Zipcode/Postcode 987654 in 5 days then you can create zones.

    Manually (Priority 2): Manually option allows the addition of some Pincodes/Zipcodes/Postcodes (comma separated). 

    Disable (Priority 1): Disable option is to disable the Pincode/ Zipcode checker form from the product. 

    • Pincode Zones

      Note: This feature only available for Product Level pincode checker.

      Pincode Zone allows to create zones for the pincode/zipcode/postcode and then you easily assign zone to the particular product.

       

      Add a new Pincode Zone:

      • Login in to your WordPress admin dashboard.
      • Mouse over the Pincode Checker menu and then click on Pincode Zone.
      • Click on the Add New button.
      • Now, add the zone name in the title input.
      • Enter the Day(s), Note, Pincodes ( comma separated ).
      • Click on the Publish button

       

      Assign Pincode Zone to a product:

      • Edit the WooCommerce product on which you want to assign the Pincode Zone.
      • Scroll down to Product Data and click on the Pincode/Zipcode.
      • Enable Pincode/ Zipcode checker at zone level for this product option.
      • Select the zone that you want to assign.
      • Click on the Update/Publish button.

    • Bulk Editor

      Wow, Bulk Editor made life so easy. Bulk Editor is the very powerful and fastest feature to add delivery time to the products. You don't need to go individual product's edit page to manage the delivery times, you can now do it directly from one page. 

    • Import/ Export Products Wise CSV

      Products wise CSV feature used to import and export CSV according to the products. Make sure, you selected Product Level from Pincode Checker > Basic Settings > Pincode Checker level dropdown to see this setting on the Import/ Export page.

       

      How to Export Products Wise CSV:  

      Exporting the products-wise CSV is very simple. Just click on the Export button from the Products Wise CSV group options. Exported CSV has a list of products with Pincode/Zipcode checker fields. 

       

      How to Import Products Wise CSV:

      To import the products-wise CSV, you have to export products-wise CSV first to get the latest CSV. Now, open the exported CSV with any CSV editor software or the best way is Google sheets to edit the CSV. 

      CSV Columns: Products-wise exported CSV should have the following columns:

      1. product_id: The product_id column contains the ID of the product (Don't change the Product ID).
      2. product_name:  The product_name column contains the name of the product.
      3. days: The day column contains the days to deliver the product. This should be in number and non-negative value.
      4. note: Optional, note column is the optional cell. the note column is used to display the additional message or note if a product is deliverables. 
      5. enable: The enable column is used to enable or disable the Pincode/ Zipcode checker for a product. This should be 1 or 0 where 1 is enabled and 0 is disabled.
      6. pincodes: The pincodes column is used to add deliverable Pincodes/Zipcodes/Postcodes comma separated.

      Filled CSV File Example:

      Don't change or delete the CSV column header. It should be always product_id, product_name, days, note, enable, pincodes
  • Compatibilities

    • Dokan Multi-vendor

      WooCommerce Pincode/Zipcode Checker is fully compatible with Dokan Lite and Dokan Pro versions. Your vendors/shop managers can add pincode/zipcode/postcode to their products.

       

      Add Pincode/Zipcode/Postcode By Dokan Vendor:

      • The vendor should log in to their Dokan dashboard.
      • Click on the Products from the Dokan dashboard menu.
      • Select or search the product on which vendor want to add Pincode/zipcode/postcode.
      • Click on the Edit link on the selected product.
      • Scroll down to Pincode/ Zipcode Checker section.
      • Enter the Day(s)NotePincode/Zipcode (  comma separated ).
      • Click on the Save Product to save the changes.

    • WCFM – Frontend Manager

      Introduced in version 2.2.0

      WooCommerce Pincode/Zipcode Checker is fully compatible with WCFM – Frontend Manager. Your vendors/shop managers can add pincode/zipcode/postcode to their products.

       

      Add Pincode/Zipcode/Postcode By WCFM – Frontend Manager:

      • Vendor should login to their dashboard.
      • Click on the Products from the WCFM – Frontend Manager dashboard menu.
      • Select or search the product on which vendor want to add pincode/zipcode/postcode.
      • Click on the Edit link on the selected product.
      • Scroll down to Pincode/ Zipcode Checker section.
      • Enter the Day(s)NotePincode/Zipcode ( comma separated ).
      • Click on the Save Product to save the changes.

  • Advanced Features

    • Regex Match

      Introduced in version 3.0.0

      Regex Match is a powerful feature in our plugin. Regex match allows you to match the Pincode/Zipcode/Postcode using the regex pattern. It allows you to minimize Pincode/Zipcode/Postcode entries. 

      Currently, the Regex match option is available for Product Level only. You can add the regex in Pincode Zones and Manually ( under the product's Pincode/ Zipcode tab ).

       

      Let's suppose, you want to cover Pincode/Zipcode/Postcode range from 111111 to 666666, normally it required 555555 entries to make it possible but using the Regex match you can do it with just one enter [1-6]{6}. Here [1-6] allows only numbers from 1 to 6 and {6} allows 6 digits combination of 1 to 6. Any 6 digits Pincode/Zipcode/Postcode from 1-6 falls into this condition.

       

      Example 1: Pincode/Zipcode/Postcode range between 100000 to 999999. Like, 110001, 146001, 660123, 889933, etc.

      Regex: [1-9]{6}

      Regex Detail: [1-9] allows numbers between 1 to 9 only and {6} allows a combination of 6 digits from 1-9. 

       

      Example 2: Pincode/Zipcode/Postcode starts with AB  and then any 4 digits. Like, AB1234, AB3109, AB1101, etc.

      Regex: AB[0-9]{4}

      Regex Detail: AB are the fixed characters, [0-9] allows numbers between 0 to 9 only and {4} allows a combination of 4 digits from 0-9. 

       

      Example 3: Pincode/Zipcode/Postcode starts with 2 or 6 followed by 4 digits only. Like, 2342, 6001, 2301, 6124, etc.

      Regex:[2|6][0-9]{3}

      Regex Detail: [2|6] allows only 2 and 6 digits, [0-9] allows numbers between 0 to 9 only and {3} allows a combination of 3 digits from 0-9. 

       

      More information about Regex:

      Regex Playground: https://regex101.com/

      Regex Cheat Sheet: https://www.optimisation-conversion.com/wp-content/uploads/2015/05/regex-cheat-sheet.gif

      Regex Full Cheat Sheet: https://cheatography.com/davechild/cheat-sheets/regular-expressions/

  • How To

    Here you can find some most asked technical questions and their solutions.

    • How check for update?

      Open the article to check the process for manually check for update.

      https://wecreativez.com/article/how-to-manually-check-wecreativez-plugin-for-updates/

    • How use shortcode?

      Note: Shortcode to display the pincode/zipcode/postcode checker only works when you selected Store Level from the Basic Settings.

       

      You can display the pincode/zipcode/postcode checker form on any page or location on your website via using the following shortcode.

      Shortcode: [wpzc-pincode-checker]

      Display pincode/zipcode/postcode checker form on the page, post through WordPress Admin.

      • Edit the page or post on which you want to show the pincode checker form.
      • Copy and paste the shortcode [wpzc-pincode-checker] inside the WordPress text editor.
    • How disable payment gateway(s)?

      Disable payment gateway(s) allow to disable the one, some, or all payment gateways if the product(s) not deliverable.

      • Step 1: Log in to your WordPress admin panel.
      • Step 2: Click on the Pincode Checker from the admin navigation panel.
      • Step 3: Now, click on the Basic Settings tab.
      • Step 4: Now, you can disable by checking one, some, or all payment gateways from the Disable Payment Gateways? option.
      • Step 5: Hit the Save Changes button.
      Note*: Product Level: If 5 products are in the cart and 2 products are not deliverable on the entered Pincode/Postcode/ZipCode then the payment method will be disabled until customer not remove the not deliverable products from the cart.
    • How to not save Pincode/ Zipcode

      By default, WooCommerce Pincode/ Zipcode checker saves the pincode/zipcode/postcode entered by the user. If you don't want to save the pincode/zipcode/postcode then copy the following code and paste it into the child theme's functions.php file.

      add_filter( 'wpzc_get_customer_pincode', '__return_false' );
    • How to show date in range

      Introduced in version 3.0.1

      You can show a range of the dates when the product is deliverable using the {{days+}} and {{days-}} placeholders. Where will be replaced by the number you want to add or subtract from actual days.

      For example:

      If you want to show like, the Estimated delivery in 3-6 days then you have to use {{days}} placeholder to display the days you added in Global CSV or in any Product Level methods and use {{days+3}} to add 3 more days in actual days. 

      Some cases:

      • Estimated delivery in 3-6 days = Estimated delivery in {{days}}-{{days+3}} days
      • We will deliver in 5-6 days = We will deliver in {{days}}-{{days+1}} days
      • Estimated delivery in between 10 to 14 days = Estimated delivery in between {{days}} to {{days+4}} days

       

    • How to replace pencil icon with button

      By default, WooCommerce Pincode/ Zipcode Checker has a pencil icon to change the entered Pincode. You can easily replace the pencil icon with a button with text or with simple text by adding CSS to the plugin's Custom CSS option.

      Replace the pencil icon with a button with text:

      Example:

      Custom CSS:

      .wpzc-pincode-checker__change {
          width: auto;
          padding: 6px 12px;
          background: #fc563f; /* Button background color hex code. */
          color: #ffffff; /* Button text color hex code. */
          font-weight: 400;
          border-radius: 6px;
      }
      
      .wpzc-pincode-checker__change:hover {
          background: #fc563f; /* Button background color hex code. */
          color: #ffffff; /* Button text color hex code. */
      }
      
      .wpzc-pincode-checker__change::after {
          content: "Check Again"; /* Button text. */
      }
      
      .wpzc-pincode-checker__change img {
          display: none;  
      }

      Replace pencil icon with text only:

      Example:

      Custom CSS:

      .wpzc-pincode-checker__change {
          width: auto;
          padding: 0;
          color: #3f51b5; /* Button text color hex code. */
          font-weight: 400;
          border-radius: 0;
          text-decoration: underline !important;
      }
      
      .wpzc-pincode-checker__change:hover {
          color: #3f51b5; /* Button text color hex code. */
      }
      
      .wpzc-pincode-checker__change::after {
          content: "Check Again"; /* Button text. */
      }
      
      .wpzc-pincode-checker__change img {
          display: none;  
      }
  • Developer

    • API

      Introduced in version 1.1.7

      API endpoint for Store Level:

      https://yourdomain.com/wp-json/wpzc/v1/check/[pincode]

      Example: https://yourdomain.com/wp-json/wpzc/v1/check/110001

      Return:

      {
          "status": true|false,
          "message": "Success or failed message",
          "data": {
              "pincode": "110001"
          }
      }
      

       

      Introduced in version 1.1.7

      API endpoint for Product Level:

      https://yourdomain.com/wp-json/wpzc/v1/check/[pincode]?product_id=[product ID]

      Example: https://yourdomain.com/wp-json/wpzc/v1/check/110001?product_id=10

      Return:

      {
          "status": true|false,
          "message": "Success or failed message",
          "data": {
              "pincode": "110001"
          }
      }
      
  • FAQ

    Que: Can I use city name instead of Pincode?

    Ans: Yes, you can enter the city name instead of pincode/zipcode/postcode. 

     

    Que: Can I use HTML inside the note column?

    Ans: Yes, you can use the HTML code inside the note column of CSV or manually entered while adding the pincode/zipcode/postcode.

     

    Que: Can I restrict user not to purchase a product if pincode/zipcode/postcode not found?

    Ans: Yes, you can disable selected payment gateway(s) or all gateways, if pincode/zipcode /postcode not found.

     

    Que: I have 1,00,000+ pincodes/zipcodes/postcodes can I use your plugin?

    Ans: Yes, our plugin is very optimized. You can easily upload 1,00,000+ pincodes/zipcodes/postcodes using the CSV upload process.

     

    Que: Can I enable pincode/zipcode/postcode checker on specific products?

    Ans: Yes, you can enable the form on specific or selected products by selecting the Product Level.

     

    Que: Is it possible to hide a product if delivery is not available to specific postcodes & make it visible to the others?

    Ans: No, it is not possible to hide a product if postcode is not deliverable but yes, you can disable the payment gateway(s) so you users or customers can not purchase a product if a product is not deliverable.

     

    Que: Is your plugin compatible with Dokan multi-vendor?

    Ans: Yes, our plugin is fully compatible with Dokan Lite and Dokan Pro versions. Your vendors can add the pincode/zipcode/postcode to their products from Dokan dashboard. You can read in details here.

  • Other