Skip to content

Philippines Regions, Provinces, Cities and Barangays Address Lookup API for Laravel.

License

Notifications You must be signed in to change notification settings

jvbalcita/laravel-address

 
 

Repository files navigation

Philippines Address Lookup for Laravel

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Total Downloads

A package for providing Philippines Address lookup API with Laravel.

Install

  • Via Composer
$ composer require yajra/laravel-address

Providers and Config

If you are using Laravel 5.5+ then the steps below are optional.

  • Register service provider
Yajra\Address\AddressServiceProvider::class
  • Publish config
$ php artisan vendor:publish

Available Config

address.prefix To change the API base route.

address.middleware Route middleware.

Required Setup (Migration and Seeder)

  • Run the address migration. php artisan migrate
  • Run the address seeder. php artisan db:seed --class=\\AddressSeeder

Routes

The default prefix for the api routes is /api/address. The default can be updated via config address.php file.

  • Get All Regions /api/address/regions.
  • Get All Provinces /api/address/provinces.
  • Get Provinces By Region /api/address/provinces/{regionId}.
  • Get Cities By Province /api/address/cities/{provinceId}.
  • Get Barangays By City /api/address/barangays/{cityId}.

Usage / Examples

Add address migration

Add address migration using $table->address(). This will add the following fields:

  • street
  • barangay_id
  • city_id
  • province_id
  • region_id

Include built-in form (Requires jQuery)

On your view, include @include('address::form', ['model' => $modelWithAddress])

Add scripts section on your master layout.

Before the end of body tag, include @stack('scripts').

<body>
-- Contents Here ---

<script src="/vendor/jquery.js"></script>
@stack('scripts')
</body>

Model with Address Integration

Just use Yajra\Address\HasAddress trait on your model to load address models relationship.

use Yajra\Address\HasAddress;

class User extends Model {
    use HasAddress;
}

Change log

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email aqangeles@gmail.com instead of using the issue tracker.

Credits

Buy me a coffee

paypal Become a Patron

License

The MIT License (MIT). Please see License File for more information.

About

Philippines Regions, Provinces, Cities and Barangays Address Lookup API for Laravel.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 91.4%
  • Blade 8.6%