hichxm/laravel-phones

Laravel sortable packages for Laravel ecosystem by Hichxm

v1.1 2024-04-01 23:40 UTC

Requires

• doctrine/dbal: ^3.5
• hichxm/laravel-sortable: ^1.0.2
• illuminate/database: ^9.0|^10.0|^11.0
• nesbot/carbon: ^2.63|^3.0
• propaganistas/laravel-phone: ^4.0|^5.0
• spatie/laravel-package-tools: ^1.16.4

Requires (Dev)

• orchestra/testbench: v9.0.3
• phpunit/phpunit: ^9.0|^10.0|^11.0

MIT

• Hicham SLIMANI

README

Laravel Phones is a package that provides a simple way to manage phones numbers related to models in your Laravel application.

Installation

You can install the package via composer:

composer require hichxm/laravel-phones

You can publish the config file with:

php artisan vendor:publish --provider="Hichxm\LaravelPhones\LaravelPhonesServiceProvider" --tag="config"

You need to publish and run the migrations with:

php artisan vendor:publish --provider="Hichxm\LaravelPhones\LaravelPhonesServiceProvider" --tag="migrations"

After the migration has been published you can create the phones table by running the migrations:

php artisan migrate

Usage

First, add the HasPhones trait to the model you want to associate phones.

use Hichxm\LaravelPhones\Traits\HasPhones;

class User extends Model
{
    use HasPhones;
}

Then, you can use the phones relationship to manage the phones numbers.

$user = User::find(1);

$user->phones()->create([
    'number' => '1234567890',
    'type' => 'mobile',
]);

$user->addPhone('[phone]');
$user->addPhone('0987654321', ['FR']); // with country code, will be stored as [phone]
$user->addPhone('[phone]', [], 'mobile'); // with type

You can also use the phones relationship to retrieve the phones numbers.

$user = User::find(1);

$phones = $user->phones;
$mobilePhones = $user->phones()->where('type', 'mobile')->get();

// Use scopes
$phones = $user->getPhones();
$mobilePhones = $user->getPhones('mobile'); // specify the type
$firstPhone = $user->getFirstPhone(); // get the first phone

Methods and Relations

HasPhones methods and relations

List of methods available when using the HasPhones trait.

Relation : phones(): MorphMany

Get the phones relationship ordered.

Relation : unorderedPhones(): MorphMany

Get the phones relationship without any order.

Method : addPhone($number, $countries = [], $type = null): Phone

Add a phone number to the model.

Method : getPhones($type = null): Collection|Phone[]

Get the phones numbers related to the model.

Method : getFirstPhone($type = null): Phone

Get the first phone number related to the model.

Testing

./vendor/bin/phpunit

License

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