zaininnari/transition_component

CakePHP TransitionComponent plugin

Installs: 255

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 13

Type:cakephp-plugin

dev-master 2013-04-14 06:02 UTC

This package is not auto-updated.

Last update: 2024-10-26 14:56:18 UTC


README

Build Status

Version

Origin version created by hiromi2424. Forked https://github.com/hiromi2424/TransitionComponent

This was versioned as 2.2.0.

Introduction

Transition component is a CakePHP component to help your transitional pages logic.

  • For instance, this bears most wizard parts.
  • In almost every case, your method for action can be one-liner as like following codes: public function action(){ $this->Transition->automate('previous_action', 'next_action'); }

Requirements

  • CakePHP >= 2.0
  • PHP >= 5.3.2
  • No support PHP 5.2

Recommended:

  • CakePHP >= 2.2
  • CakePHP 2.3.2 support
  • PHP >= 5.3.2
  • PHP 5.4 support

Setup

cd /path/to/root/app/Plugin # or /path/to/root/plugins
git clone git://github.com/zaininnari/TransitionComponent.git TransitionComponent

Or:

cd /path/to/your_repository
git submodule add git://github.com/zaininnari/TransitionComponent.git plugins/TransitionComponent

Summary

  • checkData() is to check data(if given) with model validation and auto redirecting
  • checkPrev() is to check previous page's session data exists.
  • automate() is convenient method for checkData() and checkPrev().

Sample

  1. Simple Wizard Form

     class UsersController extends AppController{
    
     	public $components = array('Transition.Transition');
    
     	// base of user information
     	public function register() {
    
     		// give a next action name
     		$this->Transition->checkData('register_enquete');
    
     	}
    
     	// input enquete
     	public function register_enquete() {
    
     		$this->Transition->automate(
     			'register', // previous action to check
     			'register_confirm', // next action
     			'Enquete' // model name to validate
     		);
    
     	}
    
     	// confirm inputs
     	public function register_confirm() {
    
     		$this->Transition->automate(
     			'register_enquete', // prev
     			'register_save', // next
     			array(
     				'validationMethod' => 'validateCaptcha', // virtual function to validate with captcha
     			)
     		 );
    
     		$this->set('data', $this->Transition->allData());
     		$this->set('captcha', createCaptcha()); // virtual function to create a captcha
    
     	}
    
     	// stroring inputs
     	public function register_save() {
    
     		// As like this, multi action name can be accepted
     		$this->Transition->checkPrev(array(
     			'register',
     			'register_enquete',
     			'register_confirm'
     		));
    
     		// mergedData() returns all session data saved on the actions merged
     		if ($this->User->saveAll($this->Transition->mergedData()) {
    
     			// Clear all of session data TransitionComponent uses
     			$this->Transition->clearData();
     			$this->Session->setFlash(__('Registration complete !!', true));
     			$this->redirect(array('action' => 'index'));
    
     		} else {
    
     			$this->Session->setFlash(__('Registration failed ...', true));
     			$this->redirect(array('action' => 'register'));
    
     		}
    
     	}
    
     }
    
  2. Transition among two Controllers

     class FirstController extends AppContoller {
    
     	public $components = array('Transition.Transition');
    
     	public function one() {
     		$this->Transition->checkData(array('controller' => 'second', 'action' => 'two'));
     	}
    
     	public function three() {
     		$this->Transition->checkPrev(array(
     			'one',
     			array('controller' => 'second', 'action' => 'two')
     		));
     	}
    
     }
    
     class SecondController extends AppContoller {
    
     	public $components = array('Transition.Transition');
    
     	public function two() {
     		$this->Transition->automate(
     			array('controller' => 'first', 'action' => 'one'),
     			array('controller' => 'first', 'action' => 'three')
     		);
     	}
     }