Description
Pinora Address Autofill enhances address forms by automatically filling the State and City fields as soon as a valid 6-digit Indian PIN code is entered. No more manual typing, no more typos — just instant, accurate address data.
Why choose this plugin?
- Blazing fast — local data built in. All 19,500+ Indian PIN codes are pre-loaded inside the plugin. Lookups complete in under 1 millisecond with zero external API calls.
- No API dependency. No monthly quotas, no rate limits, no service outages. Your checkout page works even when third-party APIs are down.
- WooCommerce ready. Plug-and-play with WooCommerce billing and shipping address forms on both Checkout and My Account pages.
- Smart city detection. Uses district-level data with intelligent fallback logic, delivering accurate city names — not raw postal division codes.
- Read-only State & City fields. Once auto-filled, State and City are locked to prevent accidental edits, keeping your address data consistent.
- Lightweight & developer friendly. Well-structured code with filters for customizing PIN code selectors, city/state field mappings, and more.
How it works:
- Customer types a 6-digit Indian PIN code in the postcode field.
- After the configured number of digits (default: 3), the plugin triggers a lookup.
- State and City fields are instantly populated from the built-in local index.
- If the PIN code is not in the local index, the plugin falls back to the postalpincode.in API with WP Transient caching as a safety net.
External Services
This plugin may connect to the postalpincode.in API as a fallback when a PIN code is not found in the built-in local index (which covers 19,500+ PIN codes).
What the service is: postalpincode.in is a free, community-maintained public directory of Indian postal PIN code data. It mirrors publicly available India Post pincode information. The service is stateless — it has no user accounts, no cookies, and collects no personal data.
What data is sent: Only the 6-digit PIN code entered by the user, passed as a URL path parameter. No personal data (name, email, address, IP, browser fingerprint, etc.) is ever transmitted.
When it is sent: Only when the local lookup returns no result and the user has typed a valid 6-digit PIN code.
Service provider: postalpincode.in
- Service URL: https://api.postalpincode.in/
- Terms of Service: This service does not publish a formal Terms of Service page (it is a public data API, not a commercial platform).
- Privacy Policy: This service does not publish a formal Privacy Policy page, as it is stateless and does not collect or store any user information. The only data it receives is the PIN code number embedded in the request URL.
If you require guaranteed zero external calls, disable the API fallback by commenting out the fetch_from_external_api() call in includes/class-pin-code-api.php.
Installation
- Upload the
pin-code-autocompletefolder to/wp-content/plugins/, or install via the WordPress Plugins screen. - Activate the plugin through the ‘Plugins’ menu in WordPress.
- That’s it. No API keys, no configuration — it works out of the box.
Requirements: WooCommerce is recommended for the best experience. The plugin can work with other forms via custom selectors (see FAQ).
FAQ
-
Does it work without WooCommerce?
-
Yes. By default the plugin targets WooCommerce selectors (
#billing_postcode,#billing_city, etc.), but you can customize the selectors using filters — see the developer hooks inpin-code-autocomplete.php. -
Does it support countries other than India?
-
No. This plugin is specifically built for the Indian 6-digit PIN code system with pre-loaded India Post data.
-
What happens if the PIN code is not found?
-
An inline error message appears below the postcode field, and the State/City fields remain editable for manual entry.
-
Do I need an internet connection?
-
No. Nearly all lookups are served from the built-in local pincode index. The postalpincode.in API is only used as a last-resort fallback for PIN codes not in the local database.
-
Can I update the pincode data?
-
Yes. Replace
data/pincodes.csvwith an updated India Post dataset and run the build script (scripts/build_pincode_index.py) to regenerate the index.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Pinora Address Autofill for Indian PIN Codes” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Pinora Address Autofill for Indian PIN Codes” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.