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
geocodeconfiguration 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