=== Nigeria Cities for WooCommerce ===
Contributors: jackieriel
Tags: woocommerce, shipping, nigeria, custom shipping, woocommerce shipping
Donate link: https://flutterwave.com/donate/qwmgvnszxtp7
Tested up to: 6.7
Stable tag: 1.0.0
License: GPLv2
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Plugin URI: https://jacksonjonah.com.ng/nigeria-cities-for-woocommerce/
Author URI: https://jacksonjonah.com.ng/about-me/

The plugin adds Nigerian states and their LGAs as shipping zones to WooCommerce for simplified configuration.

== Description ==
The **Nigeria Cities for WooCommerce** plugin integrates Nigerian geographic data into WooCommerce, enabling businesses to cater to Nigerian customers efficiently. It add LGA in Nigeria as shipping zones to the default shipping zones.

Key features include:

* Addition of all Nigerian states and LGAs as shipping zones.
* JSON-based data for easy updates.
* Secure handling with nonce verification and input sanitization.
* Admin notices for missing or invalid JSON files.
* Error logging for debugging.

== Installation ==
= From the WordPress Dashboard =
1. Download the plugin as a `.zip` file.
2. Go to `Plugins > Add New > Upload Plugin` in your WordPress admin.
3. Select the `.zip` file and click "Install Now."
4. Activate the plugin.

= Manual Installation =
1. Download the plugin as a `.zip` file.
2. Extract the file and upload the folder to `/wp-content/plugins/` in your WordPress installation.
3. Activate the plugin via the WordPress admin dashboard.

== Frequently Asked Questions ==
= What happens if the JSON file is not accessible? =
If the plugin is unable to access the JSON file (due to connectivity issues, for example), it will display an admin notice, informing you of the problem. You can resolve the issue by ensuring your site has a stable internet connection.

= Can I request for some specific locations not included to be added for me? =
Yes you can, my simply sending your request across via support

= Can I use the plugin outside of Nigeria? =
Currently, this plugin is designed specifically to handle Nigerian states and LGAs. If you wish to use it for other countries, you would need to modify the JSON data format to include the relevant data and adjust the plugin accordingly.

== Screenshots ==
1. Admin screen showing Nigerian states and LGAs as shipping zones.

== Changelog ==
= 1.0.0 =
* Initial release: Added Nigerian states and LGAs to WooCommerce.

== JSON Data Format ==

The plugin uses a JSON file to define states and LGAs. Below is an example format:

“`json
{
    "Lagos": {
        "LA-01": "Ikeja",
        "LA-02": "Epe",
        "LA-03": "Ikorodu"
    },
    "Abuja": {
        "ABJ-01": "Garki",
        "ABJ-02": "Wuse",
        "ABJ-03": "Asokoro"
    }
}
“`

== Contributing ==
Contributions are welcome! 

== Support ==

For support, contact the author via [Jackson Jonah's website](https://jacksonjonah.com.ng/#contact) or email [contact@jacksonjonah.com.ng](mailto:contact@jacksonjonah.com.ng).