Nigeria GeoData

Nigeria GeoData is a WordPress integration for Nigerian administrative and electoral geographic data, developed by Govware Solutions Limited.

This repository currently contains the foundation of the plugin: custom database tables, a local repository layer, an admin dashboard, secure settings storage, and a remote API client abstraction. It does not yet import or provide production geographic datasets.

Intended Data Hierarchy

The long-term administrative hierarchy is:

Nigeria
-> Geopolitical Zone
-> State / FCT
-> LGA / Area Council
-> Ward / Registration Area
-> Polling Unit

Electoral constituency relationships will also include:

• Senatorial District
• Federal Constituency
• State Constituency

Later versions may add communities and settlements.

Current Functionality

• WordPress admin menu: Nigeria GeoData
• Dashboard showing plugin version, connection status, dataset status, last synchronization, and local record count
• Settings for a future GeoData API base URL and API key
• Custom database tables for geographic entities and dataset sync metadata
• API client class using WordPress HTTP functions
• Sync manager scaffold for the future remote import workflow

What Is Not Implemented Yet

• Production API endpoint configuration
• National dataset import
• Frontend display components
• Campaign Manager integration
• Public query shortcodes or blocks

Development Notes

The plugin intentionally avoids Composer packages, JavaScript frameworks, and WordPress post storage for geographic records at this stage. Geographic data is stored in custom WordPress tables created during plugin activation.