{"id":380785,"date":"2026-10-08T13:09:48","date_gmt":"2026-10-08T13:09:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ng-postcode-for-woocommerce\/"},"modified":"2026-10-08T16:41:07","modified_gmt":"2026-10-08T16:41:07","slug":"adeniyikayode-nigerian-postcode-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/mg.wordpress.org\/plugins\/adeniyikayode-nigerian-postcode-for-woocommerce\/","author":16469242,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.3","stable_tag":"0.1.3","tested":"7.1.3","requires":"6.7","requires_php":"7.4","requires_plugins":null,"header_name":"Adeniyikayode Nigerian Postcode for WooCommerce","header_author":"Kayode Adeniyi","header_description":"Nigeria's NIPOST digital postcode at checkout: checked, tidied, and usable in shipping zones.","assets_banners_color":"097d4c","last_updated":"2026-10-08 16:41:07","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/Adeniyikayodee\/ng-postcode-woocommerce","header_author_uri":"https:\/\/github.com\/Adeniyikayodee","rating":0,"author_block_rating":0,"active_installs":0,"downloads":50,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.1":{"tag":"0.1.1","author":"adeniyikayode","date":"2026-10-08 13:09:17","revision":3734652},"0.1.2":{"tag":"0.1.2","author":"adeniyikayode","date":"2026-10-08 16:30:18","revision":3735123},"0.1.3":{"tag":"0.1.3","author":"adeniyikayode","date":"2026-10-08 16:41:07","revision":3735168}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3735085,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3735085,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3735085,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3735085,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3735085,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.1","0.1.2","0.1.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3735127,"resolution":"1","location":"assets","locale":"","width":2560,"height":1600},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3735127,"resolution":"2","location":"assets","locale":"","width":2560,"height":1600},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3735127,"resolution":"3","location":"assets","locale":"","width":2560,"height":1100}},"screenshots":{"1":"The checkout after \"Find my postcode\" fills the field.","2":"The settings, under WooCommerce, Settings, General.","3":"The order note once NIPOST confirms the postcode."}},"plugin_section":[],"plugin_tags":[5492,201910,3522,286,3249],"plugin_category":[45],"plugin_contributors":[285039],"plugin_business_model":[],"class_list":["post-380785","plugin","type-plugin","status-publish","hentry","plugin_tags-nigeria","plugin_tags-postal-code","plugin_tags-postcode","plugin_tags-woocommerce","plugin_tags-zip-code","plugin_category-ecommerce","plugin_contributors-adeniyikayode","plugin_committers-adeniyikayode"],"banners":{"banner":"https:\/\/ps.w.org\/adeniyikayode-nigerian-postcode-for-woocommerce\/assets\/banner-772x250.png?rev=3735085","banner_2x":"https:\/\/ps.w.org\/adeniyikayode-nigerian-postcode-for-woocommerce\/assets\/banner-1544x500.png?rev=3735085","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/adeniyikayode-nigerian-postcode-for-woocommerce\/assets\/icon.svg?rev=3735085","icon":"https:\/\/ps.w.org\/adeniyikayode-nigerian-postcode-for-woocommerce\/assets\/icon.svg?rev=3735085","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/adeniyikayode-nigerian-postcode-for-woocommerce\/assets\/screenshot-1.png?rev=3735127","caption":"The checkout after \"Find my postcode\" fills the field."},{"src":"https:\/\/ps.w.org\/adeniyikayode-nigerian-postcode-for-woocommerce\/assets\/screenshot-2.png?rev=3735127","caption":"The settings, under WooCommerce, Settings, General."},{"src":"https:\/\/ps.w.org\/adeniyikayode-nigerian-postcode-for-woocommerce\/assets\/screenshot-3.png?rev=3735127","caption":"The order note once NIPOST confirms the postcode."}],"raw_content":"<!--section=description-->\n<p>Nigeria's National Digital Alphanumeric Postcode System (NDAPS) gives every building an 11-character code such as <code>EK-01-A03-FK-01<\/code>: state, LGA, district, area, and building unit. It is Nigeria's new postal code, or zip code.<\/p>\n\n<p>This plugin does not add a field. It teaches WooCommerce's own postcode field about Nigerian codes, so the postcode reaches everything that already reads that field: orders, emails, exports, the REST API, couriers, and shipping zones.<\/p>\n\n<ul>\n<li><strong>Shows the field.<\/strong> WooCommerce hides the postcode for Nigerian addresses. The plugin shows it and keeps it optional.<\/li>\n<li><strong>Checks the code.<\/strong> A code with the wrong shape is refused, in both the classic and the block checkout.<\/li>\n<li><strong>Tidies the code.<\/strong> <code>ek 01 a03 fk 01<\/code> and <code>EK01A03FK01<\/code> are both stored as <code>EK-01-A03-FK-01<\/code>.<\/li>\n<li><strong>Works with shipping zones.<\/strong> Add a postcode rule such as <code>EK-01*<\/code> to a zone to price delivery for one LGA.<\/li>\n<li><strong>Find my postcode.<\/strong> A button fills the field from the customer's location, and asks them to confirm it.<\/li>\n<li><strong>Check orders.<\/strong> After each order, a note says whether NIPOST has a building for the postcode.<\/li>\n<\/ul>\n\n<p>The first four need no account or key. The last two need a key from the NIPOST developer dashboard.<\/p>\n\n<p>This is an independent project. It is not made or endorsed by NIPOST or by WooCommerce.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to the NIPOST Postcode API at <code>api.postcode.gov.ng<\/code>, and only after you enter an API key in its settings.<\/p>\n\n<ul>\n<li>When a customer presses \"Find my postcode\", the latitude and longitude from their browser are sent, with your key, to find the nearest building. The plugin does not store or log the location.<\/li>\n<li>After an order is placed, if \"Check orders\" is on, the order's postcode is sent, with your key, to ask whether it belongs to a building. Nothing else about the order or the customer is sent.<\/li>\n<\/ul>\n\n<p>The service is provided by the Nigerian Postal Service: <a href=\"https:\/\/postcode.gov.ng\/terms\">terms<\/a> and <a href=\"https:\/\/postcode.gov.ng\/privacy\">privacy policy<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin. WooCommerce must be active.<\/li>\n<li>The postcode field now appears for Nigerian addresses at checkout. No settings are needed for that.<\/li>\n<li>To switch on \"Find my postcode\" and \"Check orders\", go to WooCommerce, Settings, General, and enter your NIPOST API key under \"Nigerian postcode\".<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20the%20postcode%20required%20at%20checkout%3F\"><h3>Is the postcode required at checkout?<\/h3><\/dt>\n<dd><p>No. Most customers do not know their code yet, so the field is optional.<\/p><\/dd>\n<dt id=\"how%20do%20i%20price%20delivery%20by%20area%3F\"><h3>How do I price delivery by area?<\/h3><\/dt>\n<dd><p>In a shipping zone, add a postcode rule with a prefix and a star, written with its hyphens: <code>EK-01*<\/code> for one LGA, or <code>EK-01-A03*<\/code> for one district.<\/p><\/dd>\n<dt id=\"where%20does%20my%20api%20key%20go%3F\"><h3>Where does my API key go?<\/h3><\/dt>\n<dd><p>It is stored on your server and used only there. You can instead define <code>NG_POSTCODE_API_KEY<\/code> in <code>wp-config.php<\/code>, which keeps it out of the database.<\/p><\/dd>\n<dt id=\"can%20a%20visitor%20use%20up%20my%20nipost%20quota%3F\"><h3>Can a visitor use up my NIPOST quota?<\/h3><\/dt>\n<dd><p>\"Find my postcode\" refuses locations outside Nigeria without asking NIPOST, allows each visitor at most 5 searches a minute, and allows the store at most 600 an hour.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.3<\/h4>\n\n<ul>\n<li>Listing tags now include postal code and zip code.<\/li>\n<\/ul>\n\n<h4>0.1.2<\/h4>\n\n<ul>\n<li>Added screenshots and a link on the author's name.<\/li>\n<\/ul>\n\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>Renamed to Adeniyikayode Nigerian Postcode for WooCommerce.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"Nigeria's NIPOST digital postcode at checkout: checked, tidied, found from the customer's location, and usable in shipping zones.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/380785","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=380785"}],"author":[{"embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/adeniyikayode"}],"wp:attachment":[{"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=380785"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=380785"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=380785"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=380785"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=380785"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/mg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=380785"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}