Download the PHP package ixudra/addressable without Composer
On this page you can find all versions of the php package ixudra/addressable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ixudra/addressable
More information about ixudra/addressable
Files in ixudra/addressable
Package addressable
Short Description Custom Laravel package for address support for the Laravel framework - developed by Ixudra
License MIT
Homepage https://ixudra.be
Informations about the package addressable
ixudra/addressable
Custom Laravel address package for the Laravel 5 framework - developed by Ixudra.
The ixudra/addressable package provides an easy to use polymorphic address model that can be linked to one or more models in any Laravel PHP application. The package contains an address model class as well as a factory class that will take care of creating and editing the address model. Additionally, the package will also take care of moving and storing the actual files in the correct locations.
This package can be used by anyone at any given time, but keep in mind that it is optimized for my personal custom workflow. It may not suit your project perfectly and modifications may be in order.
Installation
Pull this package in through Composer:
Add the service provider to your config/app.php
file:
Run package migrations using artisan:
Alternatively, you can also publish the migrations using artisan:
Usage
Create a model with a polymorphic relationship to the Address
model:
You can create new Address
models using the AddressFactory
class which is provided in the package. The AddressFactory
will take care of creating the Address
model, linking the Address
to the designated model and moving the uploaded file to the location which is specified in the designated model.
Updating addresses works similar to creating them. All you need to do is provide the correct information and the AddressFactory
will take care of the rest for you. It is also possible to update the address information without actually updating the uploaded file. This can be done by omitting the file
attribute from the data that is passed to the factory.
A full example of a factory class that leverages the package functionality can be found in the following example:
Finally, the package also provides several views that can be used:
bootstrap/default/data/verticalFull.blade.php
which includes a Twitter Bootstrap implementation that will allow you to show the address on a pagebootstrap/default/data/verticalSimple.blade.php
which includes a Twitter Bootstrap implementation that will allow you to show the address on a pagebootstrap/default/fields/inline.blade.php
which includes a Twitter Bootstrap implementation that can be included in forms to create and/or modify the address informationbootstrap/default/fields/verticalFull.blade.php
which includes a Twitter Bootstrap implementation that can be included in forms to create and/or modify the address informationbootstrap/default/fields/verticalSimple.blade.php
which includes a Twitter Bootstrap implementation that can be included in forms to create and/or modify the address information
Usage example of both cases can be found in the examples below:
The input views assumes one variable $input
, which is associative array of values of the input data. Required keys depend on the view you want to use. Options are: street_1
, street_2
, number
, box
, postal_code
, city
, district
, country
, longitude
, latitude
Both of these variables need to be passed to the view in order to use the default views.
The usage of these views is by no means required to take advantage of the functionality in this package. However, it is worth noting that some views leverage the functionality of the ixudra/translation package by default. The ixudra/translation
package is not included as a requirement for this package, but must be pulled in via composer in order to take advantage of the views which are provided by default.
Planning
- Geocoding
- Additional views
Support
Help me further develop and maintain this package by supporting me via Patreon!!
License
This package is open-sourced software licensed under the MIT license
Contact
For package questions, bug, suggestions and/or feature requests, please use the Github issue system and/or submit a pull request. When submitting an issue, always provide a detailed explanation of your problem, any response or feedback your get, log messages that might be relevant as well as a source code example that demonstrates the problem. If not, I will most likely not be able to help you with your problem. Please review the contribution guidelines before submitting your issue or pull request.
For any other questions, feel free to use the credentials listed below:
Jan Oris (developer)
- Email: [email protected]
- Telephone: +32 496 94 20 57
All versions of addressable with dependencies
illuminate/support Version >=6.0
illuminate/database Version >=6.0
ixudra/core Version ~6.0
laravelcollective/html Version ~6.0
laracasts/presenter Version 0.2.*