raymondwilkinson/larainvite

Laravel Invitation package, existing users can invite others by email

larainvite

User (signup) invitation package for laravel, _(*1)

, _(*2)

larainvite is a laravel package, to allow existing users to invite others by email., _(*3)

It generates referral code and keep track of status., _(*4)

Installation

Begin by installing the package through Composer. Run the following command in your terminal:, _(*5)

composer require raymondwilkinson/larainvite

add the package service provider in the providers array in config/app.php:, _(*6)

Junaidnasir\Larainvite\LaraInviteServiceProvider::class

you may add the facade access in the aliases array:, _(*7)

'Invite'  => Junaidnasir\Larainvite\Facades\Invite::class

publish the migration and config file:, _(*8)

php artisan vendor:publish"

migrate to create user_invitation table, _(*9)

php artisan migrate

edit your User model to include larainviteTrait, _(*10)

use Junaidnasir\Larainvite\InviteTrait;
class user ... {
    use InviteTrait;
}

Usage

You can use facade accessor to retrieve the package controller. Examples:, _(*11)

$user = Auth::user();
//Invite::invite(EMAIL, REFERRAL_ID); 
$refCode = Invite::invite('email@address.com', $user->id);
//or 
//Invite::invite(EMAIL, REFERRAL_ID, EXPIRATION); 
$refCode = Invite::invite('email@address.com', $user->id, '2016-12-31 10:00:00');

now create routes with refCode, when user access that route you can use following methods, _(*12)

// Get route
$code = Request::input('code');
if( Invite::isValid($code))
{
    $invitation = Invite::get($code); //retrieve invitation modal
    $invited_email = $invitation->email;
    $referral_user = $invitation->user;

    // show signup form
} else {
    $status = Invite::status($code);
    // show error or show simple signup form
}

```php // Post route $code = Request::input('code'); $email = Request::input('signup_email'); if( Invite::isAllowed($code,$email) ){ // Register this user Invite::consume($code); } else { // either refCode is inavalid, or provided email was not invited against this refCode }, <sub>(*13)</sub>

with help of new trait you have access to invitations sent by user
```php
$user= User::find(1);
$invitations = $user->invitations;
$count = $user->invitations()->count();

Events

larainvite fires several events, <sub>(*14)</sub>

• 'junaidnasir.larainvite.invited'
• 'junaidnasir.larainvite.consumed'
• 'junaidnasir.larainvite.canceled'
• 'junaidnasir.larainvite.expired'

all of these events incloses invitation modal so you can listen to these events. include listener in EventServiceProvider.php, <sub>(*15)</sub>

protected $listen = [
    'junaidnasir.larainvite.invited' => [
        'App\Listeners\userInvite',
    ],
];

userInvite.php, <sub>(*16)</sub>

public function handle($invitation)
{
    \Mail::queue('invitations.emailBody', $invitation, function ($m) use ($invitation) {
            $m->from('From Address', 'Your App Name');
            $m->to($invitation->email);
            $m->subject("You have been invited by ". $invitation->user->name);
        });
}

Configurations

in config/larainvite.php you can set default expiration time in hours from current time., <sub>(*17)</sub>

'expires' => 48

you can also change user model to be used, in larainvite.php, <sub>(*18)</sub>

'UserModel' => 'App\User'