This is a laravel package you can use to retrieve data for Uganda's regions, districts, subcounties and population according to the 2014 census
# UgGeog
This is a laravel package you can use to retrieve population data for Uganda's regions, districts, subcounties and population according to the 2014 census data
# Description
This package lets you to access population statistics such as male/female population, gender ratio, land area and population density associated with regions, districts or subcounties within Uganda
## Table of Contents
- Requirements
- Installation
- Composer
- Service Provider
- Publish Package
- Run Migrations
- Usage
- Getting All Records
- Getting Specific Records
- Credits
- Contributions
- License
---
## Requirements
In order to run this project, ensure that you have installed;
- PHP 5.3 or later
- Composer
## Installation
Follow these steps to install and setup the package within your project
### Composer
Pull this package in through Composer
```
composer require jaymeskat/ug-geog
```
### Service Provider
* Laravel 5.5 +
Uses package auto discovery features to recognise the package.
* Laravel 5.4 and below
Add the package to your application service providers in `config/app.php` file.
```php
'providers' => [
...
/**
* Package Service Providers...
*/
JaymesKat\UgGeog\UgGeogServiceProvider::class,
],
```
### Publish Package
Publish the package to your application if required by running this command in your terminal.
php artisan vendor:publish --provider="JaymesKat\UgGeog\UgGeogServiceProvider"
Ensure all package classes are autoloaded
composer dump-autoload
### Run Migrations
Set up seeding by adding the code below in the body of the `run` function inside the `DatabaseSeeder.php` file located within the `database/seeds` folder
$this->call(RegionsTableSeeder::class);
Run migrations to provision tables in your database, this will also add seed data to tables.
php artisan migrate --seed
---
## Usage
### Getting All Records
Use models from package to get the records.
#### Regions
```php
use JaymesKat\UgGeog\Models\Region;
$regionsArray = Region::list() …