Download the PHP package lecturize/laravel-addresses without Composer
On this page you can find all versions of the php package lecturize/laravel-addresses. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-addresses
Laravel Addresses
Simple address and contact management for Laravel with automatical geocoding to add longitude and latitude.
Installation
Require the package from your composer.json
file
and run $ composer update
or both in one with $ composer require lecturize/laravel-addresses
.
Configuration & Migration
This will publish the config file to config/lecturize.php
and some migration files, that you'll have to run:
For migrations to be properly published ensure that you have added the directory database/migrations
to the classmap in your projects composer.json
.
Check out Webpatser\Countries readme to see how to seed their countries data to your database.
Usage
First, add our HasAddresses
trait to your model.
Add an Address to a Model
Alternativly you could do...
Available attributes are street
, street_extra
, city
, post_code
, state
, country
, state
, notes
(for internal use). You can also use custom flags like is_primary
, is_billing
& is_shipping
. Optionally you could also pass lng
and lat
, in case you deactivated the included geocoding functionality and want to add them yourself.
Check if Model has Addresses
Get all Addresses for a Model
Get primary/billing/shipping Addresses
Update an Address for a Model
Delete an Address from a Model
Delete all Addresses from a Model
Contacts
First, add our HasContacts
trait to your model.
Add a Contact to a Model
Relate Addresses with Contacts
Above all, addresses
and contacts
can be connected with an optional One To Many relationship. Like so you could assign multiple contacts to an address and retrieve them like so:
Geocoding
The address model provides a method geocode()
which will try to fetch longitude and latitude through the Google Maps API. Please make sure to add your key within the services config file at services.google.maps.key
. If you set the option lecturize.addresses.geocode
to true
, the package will automatically fire the geocode()
method whenever an addresses model is saved (precisely we hook into the saving
event).
Changelog
- [2021-02-02] v1.0 The
geocode
configuration option now defaults tofalse
. - [2022-05-16] v1.1 Updated dependencies to PHP 8 and Laravel 8/9 - for older versions please refer to v1.0.
- [2023-02-21] v1.2 Laravel 10 support.
- [2023-09-21] v1.3 Support custom models for addresses and contacts, thanks to @bfiessinger. The geocoding feature now requires a Google Maps key, see 'Geocoding' above. Also, @bfiessinger has added fallback support for flags, see pull request #40 for further info.
- [in-progress] v1.4 Added additional contact fields to the addresses table, to allow for easier standalone usage (without the contacts model). This is intended to reduce the complexity of relationships and queries, that before were necessary e.g. to generate a shipping label from address and contact.
License
Licensed under MIT license.
Author
Handcrafted with love by Alexander Manfred Poellmann in Vienna & Rome.
All versions of laravel-addresses with dependencies
ext-json Version *
illuminate/database Version ^9.0|^10.0
illuminate/support Version ^9.0|^10.0
webpatser/laravel-countries Version ^1.5
webpatser/laravel-uuid Version ^3.0|^4.0