Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/michaelnjuguna/kenya-administrative-divisions-php-library
The Kenya Administrative Divisions PHP Library is a package that provides functionality to retrieve administrative divisions data for Kenya. It includes information about counties, constituencies, and wards.
https://github.com/michaelnjuguna/kenya-administrative-divisions-php-library
kenya-administrative-divisions php
Last synced: 3 months ago
JSON representation
The Kenya Administrative Divisions PHP Library is a package that provides functionality to retrieve administrative divisions data for Kenya. It includes information about counties, constituencies, and wards.
- Host: GitHub
- URL: https://github.com/michaelnjuguna/kenya-administrative-divisions-php-library
- Owner: michaelnjuguna
- License: mit
- Created: 2024-07-06T10:08:12.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-07-06T10:31:53.000Z (7 months ago)
- Last Synced: 2024-11-22T08:07:52.514Z (3 months ago)
- Topics: kenya-administrative-divisions, php
- Language: PHP
- Homepage: https://packagist.org/packages/michaelnjuguna/kenya-administrative-divisions
- Size: 23.4 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: license.txt
Awesome Lists containing this project
README
# Kenya Administrative Divisions
The **Kenya Administrative Divisions** PHP Library is a package that provides functionality to retrieve administrative divisions data for Kenya. It includes information about counties, constituencies, and wards.
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Getting started](#getting-started)
- [Methods available](#methods-available)
- [Get all](#get-all)
- [Get counties](#get-counties)
- [Get constituencies](#get-constituencies)
- [Get wards](#get-wards)
- [Contributing](#contributing)
- [Support](#support)
## Installation
You can install the library via Composer. Run the following command in your terminal:
```bash
composer require michaelnjuguna/kenya-administrative-divisions
```
## Usage
### Getting started
To use the library, instantiate the `KenyaAdministrativeDivisions` class:
```php
getAll();
print_r($data);
```
### Get Counties
```php
// Get all counties
$counties = $kenyaAdministrativeDivisions->getCounties();
print_r($counties);
// Get county information by passing the county code
$county = $kenyaAdministrativeDivisions->getCounties(1);
print_r($county);
// Get county information by passing the county name
$county = $kenyaAdministrativeDivisions->getCounties('Mombasa');
print_r($county);
```
### Get Constituencies
```php
// Get all constituencies
$constituencies = $kenyaAdministrativeDivisions->getConstituencies();
print_r($constituencies);
// Get constituencies of a particular county by its code
$constituencies = $kenyaAdministrativeDivisions->getConstituencies(1);
print_r($constituencies);
// Get constituencies of a particular county by its name
$constituencies = $kenyaAdministrativeDivisions->getConstituencies('Nairobi');
print_r($constituencies);
```
### Get wards
```php
// Get all wards
$wards = $kenyaAdministrativeDivisions->getWards();
print_r($wards);
// Get wards of a particular county by passing its county code
$wards = $kenyaAdministrativeDivisions->getWards(1);
print_r($wards);
// Get wards of a particular county by passing its name
$wards = $kenyaAdministrativeDivisions->getWards('Mombasa');
print_r($wards);
// Get wards of a particular county and constituency by passing the respective county code/name and constituency name
$wards = $kenyaAdministrativeDivisions->getWards(1, 'Mvita');
$wards = $kenyaAdministrativeDivisions->getWards('Mombasa', 'Mvita');
// Get the wards of a particular constituency by passing its name
$wards = $kenyaAdministrativeDivisions->getWards(null, 'Mvita');
print_r($wards);
```
## Contributing
1. Fork this repository.
2. Create new branch with feature name.
3. Create your feature.
4. Run the tests and make sure all the tests pass.
5. Commit and set commit message with feature name.
6. Push your code to your fork repository.
7. Create pull request.
## Support
If you like this project, you can support me with starring ⭐ this repository.
## License
[MIT](license.txt)
Made with 💜