Onboard
A Laravel package to help track user onboarding steps.
Installation:
- Install the package via composer
composer require calebporzio/onboard
- Register the Service Provider and Facade in
config/app.php
'providers' => [
...
Calebporzio\Onboard\OnboardServiceProvider::class,
'aliases' => [
...
Calebporzio\Onboard\OnboardFacade::class,
- Add the
Calebporzio\Onboard\GetsOnboardedtrait to your app's User model
class User extends Model
{
use \Calebporzio\Onboard\GetsOnboarded;
...
Example Configuration:
Configure your steps in your App\Providers\AppServiceProvider.php
use App\User;
use Calebporzio\Onboard\OnboardFacade;
class AppServiceProvider extends ServiceProvider
{
// ...
public function boot()
{
OnboardFacade::addStep('Complete Profile')
->link('/profile')
->cta('Complete')
->completeIf(function (User $user) {
return $user->profile->isComplete();
});
OnboardFacade::addStep('Create Your First Post')
->link('/post/create')
->cta('Create Post')
->completeIf(function (User $user) {
return $user->posts->count() > 0;
});
Usage:
Now you can access these steps along with their state wherever you like. Here is an example blade template:
@if (auth()->user()->onboarding()->inProgress())
<div>
@foreach (auth()->user()->onboarding()->steps as $step)
<span>
@if($step->complete())
<i class="fa fa-check-square-o fa-fw"></i>
<s>{{ $loop->iteration }}. {{ $step->title }}</s>
@else
<i class="fa fa-square-o fa-fw"></i>
{{ $loop->iteration }}. {{ $step->title }}
@endif
</span>
<a href="{{ $step->link }}" {{ $step->complete() ? 'disabled' : '' }}>
{{ $step->cta }}
</a>
@endforeach
</div>
@endif
Check out all the available features below:
$onboarding = Auth::user()->onboarding();
$onboarding->inProgress();
$onboarding->finished();
$onboarding->steps()->each(function($step) {
$step->title;
$step->cta;
$step->link;
$step->complete();
$step->incomplete();
});
Definining custom attributes and accessing them:
// Defining the attributes
OnboardFacade::addStep('Step w/ custom attributes')
->attributes([
'name' => 'Waldo',
'shirt_color' => 'Red & White',
]);
// Accessing them
$step->name;
$step->shirt_color;
Example middleware
If you want to ensure that your user is redirected to the next unfinished onboarding step, whenever they access your web application, you can use the following middleware as a starting point:
<?php
namespace App\Http\Middleware;
use Auth;
use Closure;
class RedirectToUnfinishedOnboardingStep
{
public function handle($request, Closure $next)
{
if (auth()->user()->onboarding()->inProgress()) {
return redirect()->to(
auth()->user()->onboarding()->nextUnfinishedStep()->link
);
}
return $next($request);
}
}
Quick tip: Don't add this middleware to routes that update the state of the onboarding steps, your users will not be able to progress because they will be redirected back to the onboarding step.
![Unresolvable dependency resolving [Parameter #0 [ <required> $user ]] in class Calebporzio\Onboard\OnboardingManager](https://avatars.githubusercontent.com/u/9059975?v=4)
10 Nov 21, 2022
29 Dec 26, 2022
342 Dec 31, 2022
220 Dec 25, 2022
108 Nov 1, 2022
178 Jan 4, 2023
74 May 1, 2022
2 Oct 7, 2022
1.9k Dec 29, 2022
3 Aug 23, 2022
4 Dec 8, 2022
6 May 10, 2021
61 Nov 5, 2022
2 Aug 29, 2022
158 Dec 25, 2022
9 Dec 14, 2022
25 Oct 12, 2022
6 Dec 6, 2022