Skip to content

Latest commit

 

History

History
144 lines (111 loc) · 3.11 KB

README_en.md

File metadata and controls

144 lines (111 loc) · 3.11 KB
Raw

LARAVOLT INDONESIA

Laravel Package that contains Provinces Data, City/Districts, and Villages in Indonesia.
Data was taken from edwardsamuel/Wilayah-Administratif-Indonesia

Installation

Package Installation

Add Laravolt/Indonesia package with

composer require laravolt/indonesia

Add Facade and Service Provider in config/app.php

'providers' => [

    Laravolt\Indonesia\ServiceProvider::class

]

'aliases' => [

    'Indonesia' => Laravolt\Indonesia\Facade::class

]

Publish Migration (Only for Laravel 5.2)

If you are using Laravel versi 5.3+, you can ignore this step.

php artisan vendor:publish --provider="Laravolt\Indonesia\ServiceProvider"

Run Migration

php artisan migrate

Run Database Seeder to Populate the Database

php artisan laravolt:indonesia:seed

Usage

Indonesia::allProvinces()
Indonesia::paginateProvinces($numRows = 15)
Indonesia::allCities()
Indonesia::paginateCities($numRows = 15)
Indonesia::allDistricts()
Indonesia::paginateDistricts($numRows = 15)
Indonesia::allVillages()
Indonesia::paginateVillages($numRows = 15)

Indonesia::findProvince($provinceId, $with = null)
array $with : cities, districts, villages, cities.districts, cities.districts.villages, districts.villages

Indonesia::findCity($cityId, $with = null)
array $with : province, districts, villages, districts.villages

Indonesia::findDistrict($districtId, $with = null)
array $with: province, city, city.province, villages

Indonesia::findVillage($villageId, $with = null)
array $with: province, city, district, district.city, district.city.province

Examples

Indonesia::findProvince(11, ['cities']);

/*
Will return
Province Object {
    'id' => 11,
    'name' => 'ACEH',
    'cities' => City Collections {
        City Object,
        City Object,
        City Object,
        ...
    }
}
*/

Indonesia::findProvince(11, ['cities', 'districts.villages'])

/*
Will return
Province Object {
    'id' => 11,
    'name' => 'ACEH',
    'cities' => City Collections {
        City Object,
        City Object,
        City Object,
        ...
    },
    'districts' => District Collections {
        District Object {
            'id' => 1101010
            'city_id' => '1101'
            'name' => 'TEUPAH SELATAN'
            'province_id' => '11'
            'villages' => Village Colletions {
                Village Object,
                Village Object,
                Village Object,
                ...
            }
        },
        ...
    }
}
*/

Indonesia::search('jakarta')->all()
Indonesia::search('jakarta')->allProvinces()
Indonesia::search('jakarta')->paginateProvinces()
Indonesia::search('jakarta')->allCities()
Indonesia::search('jakarta')->paginateCities()
Indonesia::search('jakarta')->allDistricts()
Indonesia::search('jakarta')->paginateDistricts()
Indonesia::search('jakarta')->allVillages()
Indonesia::search('jakarta')->paginateVillages()

Testing

Run

vendor/bin/phpunit tests