Description
Let visitors check delivery availability before ordering. Configure country-specific postal codes, prefixes, numeric ranges or country-wide rules with delivery availability, estimated minimum/maximum calendar days and cash on delivery availability.
Features:
- 249 ISO country/territory identifiers, with customer dropdown choices based on configured rules.
- Exact postal code, numeric range, prefix and country-wide rules.
- Priority: exact code, longest prefix, first matching numeric range, then country-wide rule. For ties, the first row wins.
- Preserve leading zeros; ignore letter case and whitespace.
- Estimated calendar days and dates, calculated using the WordPress site timezone.
- COD availability information.
- Shortcode: [viralmaisuriyaa_pincode_checker].
- Optional automatic display on classic WooCommerce product pages.
- Works without WooCommerce using the shortcode.
- Accessible labels, keyboard controls and live results.
- All interface strings are translatable. Gujarati and Hindi translations are included.
- No external services, tracking, cookies or API keys.
- Rules are removed on uninstall.
Important: This plugin displays store-wide delivery information only. It does not restrict checkout, shipping zones, shipping methods or payment gateways. COD information does not enable WooCommerce COD. Product-specific, cart-specific and courier live estimates are not included. Configure WooCommerce shipping/payment separately.
There is no default coverage. Unlisted pincodes show delivery unavailable. Estimates use calendar days from today; holidays, dispatch cutoff times and working-day calculations are not included.
Screenshots
Installation
- Upload the ZIP via Plugins > Add New > Upload Plugin, then activate it.
- Open Settings > Delivery Pincode Checker.
- Paste your actual service rules, one CSV row per line, without a header.
- Save changes.
- Add [viralmaisuriyaa_pincode_checker] to a page, post or Shortcode block, or enable classic WooCommerce product page display.
Row format: COUNTRY,POSTAL_RULE,DELIVERY_1_OR_0,MIN_DAYS,MAX_DAYS,COD_1_OR_0
Illustrative examples (not real coverage data): IN,395001,1,2,4,1 IN,395002-395010,1,3,5,0 IN,395006,0,0,0,0 US,00501,1,3,6,0 US,10001-10010,1,4,7,1 GB,SW1A 1AA,1,2,4,0 GB,SW1A,1,3,5,0 CA,K1A 0B1,1,4,8,1 DE,10115,1,2,5,0 AU,2000,1,3,6,0 AE,,1,5,9,0
IN = India, US = United States, GB = United Kingdom (not UK), CA = Canada, DE = Germany, AU = Australia, AE = United Arab Emirates. A complete country code reference and explanations are available below the settings textarea.
IN,395001,1,2,4,1 means delivery available to Indian pincode 395001 in an estimated 2–4 calendar days with COD available. The exact blocked rule for 395006 overrides its broader range. US ZIP 00501 keeps its leading zeros. GB,SW1A* matches valid postcodes beginning with SW1A. A country-wide * rule permits an empty postal code and applies across that country.
Maximum 5,000 rules and 250 KB. Days must be whole numbers from 0 to 365; minimum cannot exceed maximum. Numeric ranges must have equal-width, valid numeric endpoints in ascending order. US ZIP+4 (12345-6789) is an exact code, not a range; use exact or prefix rules. Hyphens are significant for exact matches. Invalid input preserves previous settings. Old five-column rules continue to work as Indian rules and are converted to six-column rows on the next settings save.
FAQ
-
Does it need WooCommerce?
-
No. The shortcode works on a standard WordPress website.
-
Does it block orders from unsupported pincodes?
-
No. It is an informational checker. Use your ecommerce shipping settings for checkout restrictions.
-
Does it support other countries?
-
Yes. Configure rules using ISO two-letter country codes. The customer selector shows countries with saved rules. Common format checks are included for India, United States, United Kingdom, Canada, Netherlands, Japan, Brazil and several numeric-code countries. Other countries use a basic alphanumeric syntax check (up to 20 non-space characters). This is format validation only; it does not confirm that a postal code exists or is served by a courier. Availability always comes from your rules.
-
Does it work in block-based WooCommerce product templates?
-
Use a Shortcode block in the template. Automatic display uses the classic WooCommerce product summary hook.
-
Can I import a CSV file?
-
Copy and paste its rows into the settings textarea without a header. File upload and CSV export are not included.
-
How do I translate it?
-
The text domain is viralmaisuriyaa-delivery-pincode-checker. The languages directory contains a POT template and Gujarati (gu_IN) and Hindi (hi_IN) PO/MO files. Select the appropriate WordPress site language or create another translation using a gettext editor. Country names and interface strings are translatable. CSV uses ISO country identifiers and postal rules.
-
What happens to pincode searches?
-
The plugin sends the selected country and entered postal code to your own site’s public read-only REST endpoint. The plugin does not save searches or send data to third parties. Your hosting/access logs may record requests. Delivery rules can be queried publicly because they are intended for visitors.
-
Why does the checker show an error?
-
Enable JavaScript and make sure your site’s WordPress REST API is accessible. Security tools that block public REST requests may prevent lookups.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“viralmaisuriyaa Delivery Pincode Checker” is open source software. The following people have contributed to this plugin.
Contributors
Translate “viralmaisuriyaa Delivery Pincode Checker” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- Added international country selection, format validation, exact/prefix/range/country-wide rules and detailed settings examples.
- Preserved existing Indian rules and ZIP leading zeros.
- Updated Gujarati and Hindi translations.
1.0.1
- Added a Settings shortcut to the Installed Plugins list.
1.0.0
- Initial release with local delivery rules, estimated delivery dates, COD information, shortcode and optional classic WooCommerce integration.