Download the PHP package idkwhoami/flux-wizards without Composer

Flux Wizards

A Laravel package that provides functionality for building wizard-style multi-step forms with Livewire Flux.

Table of Contents

• Features
• Installation
• Requirements
• Usage
  • Quick Start
  • Creating a Wizard
  • Required Methods
  • Navigation Methods
  • Creating Step Views
  • Blade Directives
  • Customizing the Wizard View
  • Localization
• API Reference
  • Wizard Class
  • Step Class
• License

Features

• Object-oriented API for defining wizard steps and their relationships
• Navigation between steps with next() and previous() methods
• Custom flow logic for determining step progression
• Validation rules for each step
• Blade directives for conditional step rendering
• Livewire integration with the HasWizard trait
• Designed for use with Livewire Flux

Installation

You can install the package via composer:

The package will automatically register its service provider.

Requirements

• PHP 8.3+
• Laravel 11+
• Livewire Flux 2.1+
• Livewire Flux Pro 2.1+

Usage

Quick Start

To quickly implement a wizard in your Livewire component:

1. Add the HasWizard trait to your Livewire component
2. Implement the required createWizard() and complete() methods
3. Create views for each step in your wizard
4. Use the navigation methods nextStep() and previousStep() for moving between steps

Creating a Wizard

To create a wizard, use the HasWizard trait in your Livewire component and implement the required methods:

Required Methods

When using the HasWizard trait, you must implement the following methods:

1. createWizard(): Returns a configured Wizard instance with steps.
2. complete(array $data): Handles the final submission when all steps are completed.

Navigation Methods

The HasWizard trait provides two methods for navigating between steps:

1. nextStep(): Move to the next step in the sequence or complete the wizard if on the last step.
2. previousStep(): Move to the previous step in the sequence.

Creating Step Views

Create Blade views for each step in your wizard. The views should be placed in the directory specified in the directory() method of your Wizard:

Blade Directives

The package provides two Blade directives for conditional rendering based on the current step:

1. @step('step-key'): Renders content only if the current step matches the specified key.
2. @endstep: Closes the conditional block.

Example:

Customizing the Wizard View

The package comes with a default wizard view that includes navigation buttons and error handling. You can publish this view to customize it:

Localization

The package includes translations for navigation buttons. You can publish the language files to customize them:

API Reference

Wizard Class

The Wizard class is the main container for your wizard:

• make(string $name): Create a new wizard instance
• root(Step $root): Set the root step of the wizard
• directory(string $directory): Set the directory where step views are stored
• next(): Move to the next step
• previous(): Move to the previous step
• getCurrent(): Get the current step
• setData(array $data): Set data for the wizard
• getData(): Get all data from the wizard

Step Class

The Step class represents a single step in your wizard:

• make(string $name): Create a new step instance
• label(string $label): Set a human-readable label for the step
• view(string $view): Set a custom view name (defaults to the step name)
• rules(array $rules): Set validation rules for the step
• children(array $children): Set child steps
• flow(Closure $flow): Set custom flow logic
• is(string $name): Check if the step has a specific name
• isFirst(): Check if the step is the first in the sequence
• isLast(): Check if the step is the last in the sequence
• validate(array $data): Validate the step data
• resolveNext(array $data): Resolve the next step based on flow logic

License

The MIT License (MIT). Please see License File for more information.