viitortest/contactable

Provide the contacts to store multiple contacts at one place

dev-master 2020-04-29 10:48 UTC

Requires

• php: >=5.4.0

MIT

• Dhaval Joshi

README

Contacts is a polymorphic Laravel package, for contact management system. You can add contacts to any eloquent model with ease.

Installation

1. Install the package via composer:

   composer require viitortest/contactable

2. Publish resources (migrations and config files):

   php artisan vendor:publish --tag=contact-migrations
   php artisan vendor:publish --tag=contact-config

3. Execute migrations via the following command:

   php artisan migrate

4. Done!

Usage

To add contacts support to your eloquent models simply use \Viitortest\Contacts\Traits\HasContacts trait.

Manage your contacts

// Get instance of your model
$user = new \App\Models\User::find(1);

// Create a single contact
$user->addContact([
    'name' => 'Dhaval Joshi',
    'email' => '[e-mail]',
    'phone' => '9999999999',
]);

// Create a multiple contacts
$user->addManyContacts(
[
    [
    'name' => 'Dhaval Joshi',
    'email' => '[e-mail]',
    'phone' => '9999999999',
    ],
    [
    'name' => 'Shailesh Jakhaniya',
    'email' => '[e-mail]',
    'phone' => '9999999999',
    ]
]);

// Find an existing contact
$contact = Contactable::find(1);

// Update an existing contact
$contact->update([
    'email' => '[e-mail]',
]);

// Delete contact
$contact->delete();

// Alternative way of contact deletion
$user->contacts()->where('id', 123)->first()->delete();

// Get attached contacts collection
$user->contacts;

// Get attached contacts query builder
$user->contacts();