cleaniquecoders/profile

Common Profile Information

v6.0.1 2024-10-24 17:16 UTC

Requires

• php: ^8.3
• cleaniquecoders/traitify: ^1.0
• illuminate/auth: ^11.0
• illuminate/support: ^11.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• laravel/pint: ^1.6
• orchestra/testbench: ^9.5
• pestphp/pest: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/phpstan-phpunit: ^1.2

MIT

• Nasrul Hazim

README

Profile is a package to store basic information - addresses, phone numbers, emails, and websites using Polymorph approach.

Installation

Install Profile package by running in your terminal:

composer require cleaniquecoders/profile

Publish migrations files:

php artisan vendor:publish --tag=profile-migrations

Then run:

php artisan migrate

Then run default seeders:

php artisan profile:seed

Configuration

Now you are able to configure your own models and type name. See config/profile.php.

You may want to define your own seeders for profile:seed in config/profile.php.

Available Polymorph Traits

User Cases:

1. A company has addresses, phone numbers, emails and websites.
2. An employee has addresses, phone numbers, emails and websites.

This lead us to use Polymorph to tackle the issue of similarity in data stored.

Setup

Available traits for polymorph:

1. CleaniqueCoders\Profile\Concerns\Addressable
2. CleaniqueCoders\Profile\Concerns\Emailable
3. CleaniqueCoders\Profile\Concerns\Phoneable
4. CleaniqueCoders\Profile\Concerns\Websiteable
5. CleaniqueCoders\Profile\Concerns\Bankable

For most common setup for entity is to use HasProfile trait.

HasProfile trait consist of:

1. CleaniqueCoders\Profile\Concerns\Addressable
2. CleaniqueCoders\Profile\Concerns\Emailable
3. CleaniqueCoders\Profile\Concerns\Phoneable
4. CleaniqueCoders\Profile\Concerns\Websiteable

namespace App;

use CleaniqueCoders\Profile\Concerns\HasProfile;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
 use HasProfile;
}

Usage

Create a record for each profile

$user->addresses()->create([
 'primary' => '9 miles, Sungei Way',
 'secondary' => 'P.O.Box 6503, Seri Setia',
 'city' => 'Petaling Jaya',
 'postcode' => '46150',
 'state' => 'Selangor',
 'country_id' => config('profile.providers.country.model')::name('Malaysia')->first()->id
]);

$user->phones()->create([
    'phone_number'  => '[phone]',
    'is_default'    => true,
    'phone_type_id' => PhoneType::HOME,
]);
$user->phones()->create([
    'phone_number'  => '[phone]',
    'is_default'    => true,
    'phone_type_id' => PhoneType::MOBILE,
]);
$user->phones()->create([
    'phone_number'  => '[phone]',
    'is_default'    => true,
    'phone_type_id' => PhoneType::OFFICE,
]);
$user->phones()->create([
    'phone_number'  => '[phone]',
    'is_default'    => true,
    'phone_type_id' => PhoneType::OTHER,
]);
$user->phones()->create([
    'phone_number'  => '[phone]',
    'is_default'    => true,
    'phone_type_id' => PhoneType::FAX,
]);

// you can futher query using local scopes in phone models.
// get the first home phone number
$user->phones()->home()->first();
// get all the mobile phone numbers
$user->phones()->mobile()->get();

$user->emails()->create([...]);
$user->websites()->create([...]);
$user->bankable()->create([...]);

Get all records

$user->addresses;
$user->emails;
$user->phones;
$user->websites;
$user->banks;

License

This package is open-sourced software licensed under the MIT license.