smajti1/laravel-wizard

Wizard component for laravel5.

Laravel-wizard

simple laravel step-by-step wizard, _(*1)

Install

$ composer require smajti1/laravel-wizard

Example/How

1. add routes, _(*2)

   use App\Http\Controllers\UserWizardController;
   
   Route::get('wizard/user/{step?}', [UserWizardController::class, 'wizard'])->name('wizard.user');
   Route::post('wizard/user/{step}', [UserWizardController::class, 'wizardPost'])->name('wizard.user.post');
   

2. create steps, _(*3)

   add autoload field in composer.json file:, _(*4)

   ...
   "autoload": {
      "psr-4": {
           ...
           "App\\Wizard\\Steps\\": "app/Steps"
       },
   ...

   regenerate autoloader, _(*5)

   $ composer dump-autoload

   create step app/Steps/SetUserNameStep.php, _(*6)

   namespace App\Wizard\Steps;
   
   class SetUserNameStep extends \Smajti1\Laravel\Step
   {
   
       public static $label = 'Set user name';
       public static $slug = 'set-user-name';
       public static $view = 'wizard.user.steps._set_user_name';
   
       public function process(\Illuminate\Http\Request $request)
       {
           // for example, create user
           ...
           // next if you want save one step progress to session use
           $this->saveProgress($request);
       }
   
       public function rules(\Illuminate\Http\Request $request = null): array
       {
           return [
               'username' => 'required|min:4|max:255',
           ];
       }
   }
   

3. create controller, _(*7)

   public $steps = [
       'set-username-key' => SetUserNameStep::class,
       SetPhoneStep::class,
       ...
   ];
   
   protected $wizard;
   
   public function __construct()
   {
       $this->wizard = new Wizard($this->steps, $sessionKeyName = 'user');
   }
   
   public function wizard($step = null)
   {
       try {
           if (is_null($step)) {
               $step = $this->wizard->firstOrLastProcessed();
           } else {
               $step = $this->wizard->getBySlug($step);
           }
       } catch (StepNotFoundException $e) {
           abort(404);
       }
   
       return view('wizard.user.base', compact('step'));
   }
   
   public function wizardPost(Request $request, $step = null)
   {
       try {
           $step = $this->wizard->getBySlug($step);
       } catch (StepNotFoundException $e) {
           abort(404);
       }
   
       $this->validate($request, $step->rules($request));
       $step->process($request);
   
       return redirect()->route('wizard.user', [$this->wizard->nextSlug()]);
   }
   

4. add base view $wizard variable is now automatic sheared with view, _(*8)

   
   
   
       @foreach($wizard->all() as $key => $_step)
           
   
               @if($step->index == $_step->index)
                   {{ $_step::$label }}
               @elseif($step->index > $_step->index)
                   {{ $_step::$label }}
               @else
                   {{ $_step::$label }}
               @endif
           
       @endforeach
   
   
   
   
   
   

   {{ csrf_field() }} @include($step::$view, compact('step', 'errors')) @if ($wizard->hasPrev()) Back @else Back @endif Step {{ $step->number }}/{{ $wizard->limit() }} @if ($wizard->hasNext()) Next @else Done @endif

License

Laravel wizard is open-sourced software licensed under the MIT license, _(*9)