formers / former

src/Former/LiveValidation.php

Indentation +334 added lines, -334 removed lines

@@ -9,338 +9,338 @@
  */
 class LiveValidation
 {
-	/**
-	 * The field being worked on
-	 *
-	 * @var Field
-	 */
-	public $field;
-
-	/**
-	 * Load a Field instance to apply rules to it
-	 *
-	 * @param Field $field The field
-	 */
-	public function __construct(Field&$field)
-	{
-		$this->field = $field;
-	}
-
-	/**
-	 * Apply live validation rules to a field
-	 *
-	 * @param array $rules The rules to apply
-	 */
-	public function apply($rules)
-	{
-		// If no rules to apply, cancel
-		if (!$rules) {
-			return false;
-		}
-
-		foreach ($rules as $rule => $parameters) {
-
-			// If the rule is unsupported yet, skip it
-			if (!method_exists($this, $rule)) {
-				continue;
-			}
-
-			$this->$rule($parameters);
-		}
-	}
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////////////// RULES /////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	// Field types
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Email field
-	 */
-	public function email()
-	{
-		$this->field->setType('email');
-	}
-
-	/**
-	 * URL field
-	 */
-	public function url()
-	{
-		$this->field->setType('url');
-	}
-
-	/**
-	 * Required field
-	 */
-	public function required()
-	{
-		$this->field->required();
-	}
-
-	// Patterns
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Integer field
-	 */
-	public function integer()
-	{
-		$this->field->pattern('\d+');
-	}
-
-	/**
-	 * Numeric field
-	 */
-	public function numeric()
-	{
-		if ($this->field->isOfType('number')) {
-			$this->field->step('any');
-		} else {
-			$this->field->pattern('[+-]?\d*\.?\d+');
-		}
-	}
-
-	/**
-	 * Not numeric field
-	 */
-	public function not_numeric()
-	{
-		$this->field->pattern('\D+');
-	}
-
-	/**
-	 * Only alphanumerical
-	 */
-	public function alpha()
-	{
-		$this->field->pattern('[a-zA-Z]+');
-	}
-
-	/**
-	 * Only alphanumerical and numbers
-	 */
-	public function alpha_num()
-	{
-		$this->field->pattern('[a-zA-Z0-9]+');
-	}
-
-	/**
-	 * Alphanumerical, numbers and dashes
-	 */
-	public function alpha_dash()
-	{
-		$this->field->pattern('[a-zA-Z0-9_\-]+');
-	}
-
-	/**
-	 * In []
-	 */
-	public function in($possible)
-	{
-		// Create the corresponding regex
-		$possible = (sizeof($possible) == 1) ? $possible[0] : '('.join('|', $possible).')';
-
-		$this->field->pattern('^'.$possible.'$');
-	}
-
-	/**
-	 * Not in []
-	 */
-	public function not_in($impossible)
-	{
-		$this->field->pattern('(?:(?!^'.join('$|^', $impossible).'$).)*');
-	}
-
-	/**
-	 * Matches a pattern
-	 */
-	public function match($pattern)
-	{
-		// Remove delimiters from existing regex
-		$pattern = substr($pattern[0], 1, -1);
-
-		$this->field->pattern($pattern);
-	}
-
-	/**
-	 * Alias for match
-	 */
-	public function regex($pattern)
-	{
-		return $this->match($pattern);
-	}
-
-	// Boundaries
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Max value
-	 */
-	public function max($max)
-	{
-		if ($this->field->isOfType('file')) {
-			$this->size($max);
-		} else {
-			$this->setMax($max[0]);
-		}
-	}
-
-	/**
-	 * Max size
-	 */
-	public function size($size)
-	{
-		$this->field->max($size[0]);
-	}
-
-	/**
-	 * Min value
-	 */
-	public function min($min)
-	{
-		$this->setMin($min[0]);
-	}
-
-	/**
-	 * Set boundaries
-	 */
-	public function between($between)
-	{
-		list($min, $max) = $between;
-
-		$this->setBetween($min, $max);
-	}
-
-	/**
-	 * Set accepted mime types
-	 *
-	 * @param string[] $mimes
-	 */
-	public function mimes($mimes)
-	{
-		// Only useful on file fields
-		if (!$this->field->isOfType('file')) {
-			return false;
-		}
-
-		$this->field->accept($this->setAccepted($mimes));
-	}
-
-	/**
-	 * Set accept only images
-	 */
-	public function image()
-	{
-		$this->mimes(array('jpg', 'png', 'gif', 'bmp'));
-	}
-
-	// Dates
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Before a date
-	 */
-	public function before($date)
-	{
-		list($format, $date) = $this->formatDate($date[0]);
-
-		$this->field->max(date($format, $date));
-	}
-
-	/**
-	 * After a date
-	 */
-	public function after($date)
-	{
-		list($format, $date) = $this->formatDate($date[0]);
-
-		$this->field->min(date($format, $date));
-	}
-
-	////////////////////////////////////////////////////////////////////
-	////////////////////////////// HELPERS /////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Transform extensions and mime groups into a list of mime types
-	 *
-	 * @param  string[] $mimes An array of mimes
-	 *
-	 * @return string A concatenated list of mimes
-	 */
-	private function setAccepted($mimes)
-	{
-		// Transform extensions or mime groups into mime types
-		$mimes = array_map(array('\Laravel\File', 'mime'), $mimes);
-
-		return implode(',', $mimes);
-	}
-
-	/**
-	 * Format a date to a pattern
-	 *
-	 * @param  string $date The date
-	 *
-	 * @return string The pattern
-	 */
-	private function formatDate($date)
-	{
-		$format = 'Y-m-d';
-
-		// Add hour for datetime fields
-		if ($this->field->isOfType('datetime', 'datetime-local')) {
-			$format .= '\TH:i:s';
-		}
-
-		return array($format, strtotime($date));
-	}
-
-	/**
-	 * Set a maximum value to a field
-	 *
-	 * @param integer $max
-	 */
-	private function setMax($max)
-	{
-		$attribute = $this->field->isOfType('number') ? 'max' : 'maxlength';
-
-		$this->field->$attribute($max);
-	}
-
-	/**
-	 * Set a minimum value to a field
-	 *
-	 * @param integer $min
-	 */
-	private function setMin($min)
-	{
-		if ($this->field->isOfType('number') == 'min') {
-			$this->field->min($min);
-		} else {
-			$this->field->pattern(".{".$min.",}");
-		}
-	}
-
-	/**
-	 * Set a minimum and maximum value to a field
-	 *
-	 * @param $min
-	 * @param $max
-	 */
-	public function setBetween($min, $max)
-	{
-		if ($this->field->isOfType('number') == 'min') {
-			// min, max values for generation of the pattern
-			$this->field->min($min);
-			$this->field->max($max);
-		} else {
-			$this->field->pattern('.{'.$min.','.$max.'}');
-
-			// still let the browser limit text input after reaching the max
-			$this->field->maxlength($max);
-		}
-	}
+    /**
+     * The field being worked on
+     *
+     * @var Field
+     */
+    public $field;
+
+    /**
+     * Load a Field instance to apply rules to it
+     *
+     * @param Field $field The field
+     */
+    public function __construct(Field&$field)
+    {
+        $this->field = $field;
+    }
+
+    /**
+     * Apply live validation rules to a field
+     *
+     * @param array $rules The rules to apply
+     */
+    public function apply($rules)
+    {
+        // If no rules to apply, cancel
+        if (!$rules) {
+            return false;
+        }
+
+        foreach ($rules as $rule => $parameters) {
+
+            // If the rule is unsupported yet, skip it
+            if (!method_exists($this, $rule)) {
+                continue;
+            }
+
+            $this->$rule($parameters);
+        }
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////////////// RULES /////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    // Field types
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Email field
+     */
+    public function email()
+    {
+        $this->field->setType('email');
+    }
+
+    /**
+     * URL field
+     */
+    public function url()
+    {
+        $this->field->setType('url');
+    }
+
+    /**
+     * Required field
+     */
+    public function required()
+    {
+        $this->field->required();
+    }
+
+    // Patterns
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Integer field
+     */
+    public function integer()
+    {
+        $this->field->pattern('\d+');
+    }
+
+    /**
+     * Numeric field
+     */
+    public function numeric()
+    {
+        if ($this->field->isOfType('number')) {
+            $this->field->step('any');
+        } else {
+            $this->field->pattern('[+-]?\d*\.?\d+');
+        }
+    }
+
+    /**
+     * Not numeric field
+     */
+    public function not_numeric()
+    {
+        $this->field->pattern('\D+');
+    }
+
+    /**
+     * Only alphanumerical
+     */
+    public function alpha()
+    {
+        $this->field->pattern('[a-zA-Z]+');
+    }
+
+    /**
+     * Only alphanumerical and numbers
+     */
+    public function alpha_num()
+    {
+        $this->field->pattern('[a-zA-Z0-9]+');
+    }
+
+    /**
+     * Alphanumerical, numbers and dashes
+     */
+    public function alpha_dash()
+    {
+        $this->field->pattern('[a-zA-Z0-9_\-]+');
+    }
+
+    /**
+     * In []
+     */
+    public function in($possible)
+    {
+        // Create the corresponding regex
+        $possible = (sizeof($possible) == 1) ? $possible[0] : '('.join('|', $possible).')';
+
+        $this->field->pattern('^'.$possible.'$');
+    }
+
+    /**
+     * Not in []
+     */
+    public function not_in($impossible)
+    {
+        $this->field->pattern('(?:(?!^'.join('$|^', $impossible).'$).)*');
+    }
+
+    /**
+     * Matches a pattern
+     */
+    public function match($pattern)
+    {
+        // Remove delimiters from existing regex
+        $pattern = substr($pattern[0], 1, -1);
+
+        $this->field->pattern($pattern);
+    }
+
+    /**
+     * Alias for match
+     */
+    public function regex($pattern)
+    {
+        return $this->match($pattern);
+    }
+
+    // Boundaries
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Max value
+     */
+    public function max($max)
+    {
+        if ($this->field->isOfType('file')) {
+            $this->size($max);
+        } else {
+            $this->setMax($max[0]);
+        }
+    }
+
+    /**
+     * Max size
+     */
+    public function size($size)
+    {
+        $this->field->max($size[0]);
+    }
+
+    /**
+     * Min value
+     */
+    public function min($min)
+    {
+        $this->setMin($min[0]);
+    }
+
+    /**
+     * Set boundaries
+     */
+    public function between($between)
+    {
+        list($min, $max) = $between;
+
+        $this->setBetween($min, $max);
+    }
+
+    /**
+     * Set accepted mime types
+     *
+     * @param string[] $mimes
+     */
+    public function mimes($mimes)
+    {
+        // Only useful on file fields
+        if (!$this->field->isOfType('file')) {
+            return false;
+        }
+
+        $this->field->accept($this->setAccepted($mimes));
+    }
+
+    /**
+     * Set accept only images
+     */
+    public function image()
+    {
+        $this->mimes(array('jpg', 'png', 'gif', 'bmp'));
+    }
+
+    // Dates
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Before a date
+     */
+    public function before($date)
+    {
+        list($format, $date) = $this->formatDate($date[0]);
+
+        $this->field->max(date($format, $date));
+    }
+
+    /**
+     * After a date
+     */
+    public function after($date)
+    {
+        list($format, $date) = $this->formatDate($date[0]);
+
+        $this->field->min(date($format, $date));
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ////////////////////////////// HELPERS /////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Transform extensions and mime groups into a list of mime types
+     *
+     * @param  string[] $mimes An array of mimes
+     *
+     * @return string A concatenated list of mimes
+     */
+    private function setAccepted($mimes)
+    {
+        // Transform extensions or mime groups into mime types
+        $mimes = array_map(array('\Laravel\File', 'mime'), $mimes);
+
+        return implode(',', $mimes);
+    }
+
+    /**
+     * Format a date to a pattern
+     *
+     * @param  string $date The date
+     *
+     * @return string The pattern
+     */
+    private function formatDate($date)
+    {
+        $format = 'Y-m-d';
+
+        // Add hour for datetime fields
+        if ($this->field->isOfType('datetime', 'datetime-local')) {
+            $format .= '\TH:i:s';
+        }
+
+        return array($format, strtotime($date));
+    }
+
+    /**
+     * Set a maximum value to a field
+     *
+     * @param integer $max
+     */
+    private function setMax($max)
+    {
+        $attribute = $this->field->isOfType('number') ? 'max' : 'maxlength';
+
+        $this->field->$attribute($max);
+    }
+
+    /**
+     * Set a minimum value to a field
+     *
+     * @param integer $min
+     */
+    private function setMin($min)
+    {
+        if ($this->field->isOfType('number') == 'min') {
+            $this->field->min($min);
+        } else {
+            $this->field->pattern(".{".$min.",}");
+        }
+    }
+
+    /**
+     * Set a minimum and maximum value to a field
+     *
+     * @param $min
+     * @param $max
+     */
+    public function setBetween($min, $max)
+    {
+        if ($this->field->isOfType('number') == 'min') {
+            // min, max values for generation of the pattern
+            $this->field->min($min);
+            $this->field->max($max);
+        } else {
+            $this->field->pattern('.{'.$min.','.$max.'}');
+
+            // still let the browser limit text input after reaching the max
+            $this->field->maxlength($max);
+        }
+    }
 }

src/Former/Exceptions/InvalidFrameworkException.php

Indentation +27 added lines, -27 removed lines

@@ -2,33 +2,33 @@
 
 class InvalidFrameworkException extends \RuntimeException {
 
-	/**
-	 * reference to framework class
-	 *
-	 * @var
-	 */
-	private $framework;
+    /**
+     * reference to framework class
+     *
+     * @var
+     */
+    private $framework;
 
-	/**
-	 * Set framework
-	 *
-	 * @param string $framework
-	 * @return $this
-	 */
-	public function setFramework($framework)
-	{
-		$this->framework = $framework;
-		$this->message = "Framework was not found [{$this->framework}]";
+    /**
+     * Set framework
+     *
+     * @param string $framework
+     * @return $this
+     */
+    public function setFramework($framework)
+    {
+        $this->framework = $framework;
+        $this->message = "Framework was not found [{$this->framework}]";
 
-		return $this;
-	}
-	/**
-	 * Gets the errors object.
-	 *
-	 * @return string
-	 */
-	public function getFramework()
-	{
-		return $this->framework;
-	}
+        return $this;
+    }
+    /**
+     * Gets the errors object.
+     *
+     * @return string
+     */
+    public function getFramework()
+    {
+        return $this->framework;
+    }
 }

src/Former/Traits/Field.php

Indentation +431 added lines, -431 removed lines

@@ -16,435 +16,435 @@
  */
 abstract class Field extends FormerObject implements FieldInterface
 {
-	/**
-	 * The IoC Container
-	 *
-	 * @var Container
-	 */
-	protected $app;
-
-	/**
-	 * The Form instance
-	 *
-	 * @var Former\Form
-	 */
-	protected $form;
-
-	/**
-	 * A label for the field (if not using Bootstrap)
-	 *
-	 * @var string
-	 */
-	protected $label;
-
-	/**
-	 * The field's group
-	 *
-	 * @var Group
-	 */
-	protected $group;
-
-	/**
-	 * The field's default element
-	 *
-	 * @var string
-	 */
-	protected $element = 'input';
-
-	/**
-	 * Whether the Field is self-closing or not
-	 *
-	 * @var boolean
-	 */
-	protected $isSelfClosing = true;
-
-	/**
-	 * The field's bind destination
-	 *
-	 * @var string
-	 */
-	protected $bind;
-
-	/**
-	 * Get the current framework instance
-	 *
-	 * @return Framework
-	 */
-	protected function currentFramework()
-	{
-		if ($this->app->bound('former.form.framework')) {
-			return $this->app['former.form.framework'];
-		}
-
-		return $this->app['former.framework'];
-	}
-
-	////////////////////////////////////////////////////////////////////
-	///////////////////////////// INTERFACE ////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Set up a Field instance
-	 *
-	 * @param string $type A field type
-	 */
-	public function __construct(Container $app, $type, $name, $label, $value, $attributes)
-	{
-		// Set base parameters
-		$this->app   = $app;
-		$this->type  = $type;
-		$this->value = $value;
-		$this->setAttributes($attributes);
-		$this->form = $this->app->bound('former.form') ? $this->app['former.form'] : null;
-
-		// Compute and translate label
-		$this->automaticLabels($name, $label);
-
-		// Repopulate field
-		if ($type != 'password' && $name !== '_token') {
-			$this->value = $this->repopulate();
-		}
-
-		// Apply Live validation rules
-		if ($this->app['former']->getOption('live_validation')) {
-			$rules = new LiveValidation($this);
-			$rules->apply($this->getRules());
-		}
-
-		// Bind the Group class
-		$groupClass = $this->isCheckable() ? 'CheckableGroup' : 'Group';
-		$groupClass = Former::FORMSPACE.$groupClass;
-
-		$this->group = new $groupClass($this->app, $this->label);
-	}
-
-	/**
-	 * Redirect calls to the group if necessary
-	 *
-	 * @param string $method
-	 */
-	public function __call($method, $parameters)
-	{
-		// Translate attributes
-		$translatable = $this->app['former']->getOption('translatable', array());
-		if (in_array($method, $translatable) and isset($parameters[0])) {
-			$parameters[0] = Helpers::translate($parameters[0]);
-		}
-
-		// Redirect calls to the Control Group
-		if (method_exists($this->group, $method) or Str::startsWith($method, 'onGroup')) {
-			$method = str_replace('onGroup', '', $method);
-			$method = lcfirst($method);
-
-			call_user_func_array(array($this->group, $method), $parameters);
-
-			return $this;
-		}
-
-		return parent::__call($method, $parameters);
-	}
-
-	/**
-	 * Prints out the field, wrapped in its group
-	 *
-	 * @return string
-	 */
-	public function wrapAndRender()
-	{
-		// Dry syntax (hidden fields, plain fields)
-		if ($this->isUnwrappable()) {
-			$html = $this->render();
-			// Control group syntax
-		} elseif (Form::hasInstanceOpened()) {
-			$html = $this->group->wrapField($this);
-			// Classic syntax
-		} else {
-			$html = $this->currentFramework()->createLabelOf($this);
-			$html .= $this->render();
-		}
-
-		return $html;
-	}
-
-	/**
-	 * Prints out the field
-	 *
-	 * @return string
-	 */
-	public function __toString()
-	{
-		return $this->wrapAndRender();
-	}
-
-	////////////////////////////////////////////////////////////////////
-	////////////////////////// PUBLIC INTERFACE ////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Whether the current field is required or not
-	 *
-	 * @return boolean
-	 */
-	public function isRequired()
-	{
-		return isset($this->attributes['required']);
-	}
-
-	/**
-	 * Check if a field is unwrappable (no label)
-	 *
-	 * @return boolean
-	 */
-	public function isUnwrappable()
-	{
-		return
-			($this->form and $this->currentFramework()->is('Nude')) or
-			($this->form and $this->isOfType('inline')) or
-			$this->isButton() or
-			$this->isOfType('hidden') or
-			\Former\Form\Group::$opened or
-			$this->group and $this->group->isRaw();
-	}
-
-	/**
-	 * Check if field is a checkbox or a radio
-	 *
-	 * @return boolean
-	 */
-	public function isCheckable()
-	{
-		return $this->isOfType('checkbox', 'checkboxes', 'radio', 'radios');
-	}
-
-	/**
-	 * Check if the field is a button
-	 *
-	 * @return boolean
-	 */
-	public function isButton()
-	{
-		return false;
-	}
-
-	/**
-	 * Get the rules applied to the current field
-	 *
-	 * @return array An array of rules
-	 */
-	public function getRules()
-	{
-		return $this->app['former']->getRules($this->name);
-	}
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////// SETTERS AND GETTERS ///////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Apply a Live Validation rule by chaining
-	 *
-	 * @param string $rule The rule
-	 */
-	public function rule($rule)
-	{
-		$parameters = func_get_args();
-		array_shift($parameters);
-
-		$live = new LiveValidation($this);
-		$live->apply(array(
-			$rule => $parameters,
-		));
-
-		return $this;
-	}
-
-	/**
-	 * Apply multiple rules passed as a string.
-	 *
-	 * @param $rules
-	 * @return $this
-	 */
-	public function rules($rules)
-	{
-		if (!is_array($rules)) {
-			$rules = explode('|', $rules);
-		}
-
-		foreach ($rules as $rule) {
-			$parameters = null;
-
-			// If we have a rule with a value
-			if (($colon = strpos($rule, ':')) !== false) {
-				$rulename = substr($rule, 0, $colon) ;
-
-				/**
-				 * Regular expressions may contain commas and should not be divided by str_getcsv.
-				 * For regular expressions we are just using the complete expression as a parameter.
-				 */
-				if ($rulename !== 'regex') {
-					$parameters = str_getcsv(substr($rule, $colon + 1));
-				} else {
-					$parameters = [substr($rule, $colon + 1)];
-				}
-			}
-
-			// Exclude unsupported rules
-			$rule = is_numeric($colon) ? substr($rule, 0, $colon) : $rule;
-
-			// Store processed rule in Former's array
-			if (!isset($parameters)) {
-				$parameters = array();
-			}
-
-			call_user_func_array([$this, 'rule'], array_merge([$rule], $parameters));
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Adds a label to the group/field
-	 *
-	 * @param  string $text       A label
-	 * @param  array  $attributes The label's attributes
-	 *
-	 * @return Field              A field
-	 */
-	public function label($text, $attributes = array())
-	{
-		// Create the Label element
-		$for   = $this->id ?: $this->name;
-		$label = $this->app['former']->label($text, $for, $attributes);
-
-		// Set label
-		$this->label = $label;
-		if ($this->group) {
-			$this->group->setLabel($label);
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Set the Field value no matter what
-	 *
-	 * @param string $value A new value
-	 */
-	public function forceValue($value)
-	{
-		$this->value = $value;
-
-		return $this;
-	}
-
-	/**
-	 * Classic setting of attribute, won't overwrite any populate() attempt
-	 *
-	 * @param  string $value A new value
-	 */
-	public function value($value)
-	{
-		// Check if we already have a value stored for this field or in POST data
-		$already = $this->repopulate();
-
-		if (!$already) {
-			$this->value = $value;
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Change the field's name
-	 *
-	 * @param  string $name The new name
-	 */
-	public function name($name)
-	{
-		$this->name = $name;
-
-		// Also relink the label to the new name
-		$this->label($name);
-
-		return $this;
-	}
-
-	/**
-	 * Get the field's labels
-	 *
-	 * @return string
-	 */
-	public function getLabel()
-	{
-		return $this->label;
-	}
-
-	/**
-	 * Change the field's bind destination
-	 *
-	 * @param $destination
-	 */
-	public function bind($destination) {
-		$this->bind = $destination;
-		if ($this->type != 'password') {
-			$this->value = $this->repopulate();
-		}
-
-		return $this;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////////////// HELPERS ///////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Use values stored in Former to populate the current field
-	 */
-	private function repopulate($fallback = null)
-	{
-		// Get values from POST, populated, and manually set value
-		$post      = $this->app['former']->getPost($this->name);
-		$populator = $this->form ? $this->form->getPopulator() : $this->app['former.populator'];
-		$populate  = $populator->get($this->bind ?: $this->name);
-
-		// Assign a priority to each
-		if (!is_null($post)) {
-			return $post;
-		}
-		if (!is_null($populate)) {
-			return $populate;
-		}
-
-		return $fallback ?: $this->value;
-	}
-
-	/**
-	 * Ponders a label and a field name, and tries to get the best out of it
-	 *
-	 * @param  string $label A label
-	 * @param  string $name  A field name
-	 *
-	 * @return false|null         A label and a field name
-	 */
-	private function automaticLabels($name, $label)
-	{
-		// Disabled automatic labels
-		if (!$this->app['former']->getOption('automatic_label')) {
-			$this->name = $name;
-			$this->label($label);
-
-			return false;
-		}
-
-		// Check for the two possibilities
-		if ($label and is_null($name)) {
-			$name = Str::slug($label);
-		} elseif (is_null($label) and $name) {
-			$label = preg_replace('/\[\]$/', '', $name);
-		}
-
-		// Save values
-		$this->name = $name;
-		$this->label($label);
-	}
+    /**
+     * The IoC Container
+     *
+     * @var Container
+     */
+    protected $app;
+
+    /**
+     * The Form instance
+     *
+     * @var Former\Form
+     */
+    protected $form;
+
+    /**
+     * A label for the field (if not using Bootstrap)
+     *
+     * @var string
+     */
+    protected $label;
+
+    /**
+     * The field's group
+     *
+     * @var Group
+     */
+    protected $group;
+
+    /**
+     * The field's default element
+     *
+     * @var string
+     */
+    protected $element = 'input';
+
+    /**
+     * Whether the Field is self-closing or not
+     *
+     * @var boolean
+     */
+    protected $isSelfClosing = true;
+
+    /**
+     * The field's bind destination
+     *
+     * @var string
+     */
+    protected $bind;
+
+    /**
+     * Get the current framework instance
+     *
+     * @return Framework
+     */
+    protected function currentFramework()
+    {
+        if ($this->app->bound('former.form.framework')) {
+            return $this->app['former.form.framework'];
+        }
+
+        return $this->app['former.framework'];
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ///////////////////////////// INTERFACE ////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Set up a Field instance
+     *
+     * @param string $type A field type
+     */
+    public function __construct(Container $app, $type, $name, $label, $value, $attributes)
+    {
+        // Set base parameters
+        $this->app   = $app;
+        $this->type  = $type;
+        $this->value = $value;
+        $this->setAttributes($attributes);
+        $this->form = $this->app->bound('former.form') ? $this->app['former.form'] : null;
+
+        // Compute and translate label
+        $this->automaticLabels($name, $label);
+
+        // Repopulate field
+        if ($type != 'password' && $name !== '_token') {
+            $this->value = $this->repopulate();
+        }
+
+        // Apply Live validation rules
+        if ($this->app['former']->getOption('live_validation')) {
+            $rules = new LiveValidation($this);
+            $rules->apply($this->getRules());
+        }
+
+        // Bind the Group class
+        $groupClass = $this->isCheckable() ? 'CheckableGroup' : 'Group';
+        $groupClass = Former::FORMSPACE.$groupClass;
+
+        $this->group = new $groupClass($this->app, $this->label);
+    }
+
+    /**
+     * Redirect calls to the group if necessary
+     *
+     * @param string $method
+     */
+    public function __call($method, $parameters)
+    {
+        // Translate attributes
+        $translatable = $this->app['former']->getOption('translatable', array());
+        if (in_array($method, $translatable) and isset($parameters[0])) {
+            $parameters[0] = Helpers::translate($parameters[0]);
+        }
+
+        // Redirect calls to the Control Group
+        if (method_exists($this->group, $method) or Str::startsWith($method, 'onGroup')) {
+            $method = str_replace('onGroup', '', $method);
+            $method = lcfirst($method);
+
+            call_user_func_array(array($this->group, $method), $parameters);
+
+            return $this;
+        }
+
+        return parent::__call($method, $parameters);
+    }
+
+    /**
+     * Prints out the field, wrapped in its group
+     *
+     * @return string
+     */
+    public function wrapAndRender()
+    {
+        // Dry syntax (hidden fields, plain fields)
+        if ($this->isUnwrappable()) {
+            $html = $this->render();
+            // Control group syntax
+        } elseif (Form::hasInstanceOpened()) {
+            $html = $this->group->wrapField($this);
+            // Classic syntax
+        } else {
+            $html = $this->currentFramework()->createLabelOf($this);
+            $html .= $this->render();
+        }
+
+        return $html;
+    }
+
+    /**
+     * Prints out the field
+     *
+     * @return string
+     */
+    public function __toString()
+    {
+        return $this->wrapAndRender();
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ////////////////////////// PUBLIC INTERFACE ////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Whether the current field is required or not
+     *
+     * @return boolean
+     */
+    public function isRequired()
+    {
+        return isset($this->attributes['required']);
+    }
+
+    /**
+     * Check if a field is unwrappable (no label)
+     *
+     * @return boolean
+     */
+    public function isUnwrappable()
+    {
+        return
+            ($this->form and $this->currentFramework()->is('Nude')) or
+            ($this->form and $this->isOfType('inline')) or
+            $this->isButton() or
+            $this->isOfType('hidden') or
+            \Former\Form\Group::$opened or
+            $this->group and $this->group->isRaw();
+    }
+
+    /**
+     * Check if field is a checkbox or a radio
+     *
+     * @return boolean
+     */
+    public function isCheckable()
+    {
+        return $this->isOfType('checkbox', 'checkboxes', 'radio', 'radios');
+    }
+
+    /**
+     * Check if the field is a button
+     *
+     * @return boolean
+     */
+    public function isButton()
+    {
+        return false;
+    }
+
+    /**
+     * Get the rules applied to the current field
+     *
+     * @return array An array of rules
+     */
+    public function getRules()
+    {
+        return $this->app['former']->getRules($this->name);
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////// SETTERS AND GETTERS ///////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Apply a Live Validation rule by chaining
+     *
+     * @param string $rule The rule
+     */
+    public function rule($rule)
+    {
+        $parameters = func_get_args();
+        array_shift($parameters);
+
+        $live = new LiveValidation($this);
+        $live->apply(array(
+            $rule => $parameters,
+        ));
+
+        return $this;
+    }
+
+    /**
+     * Apply multiple rules passed as a string.
+     *
+     * @param $rules
+     * @return $this
+     */
+    public function rules($rules)
+    {
+        if (!is_array($rules)) {
+            $rules = explode('|', $rules);
+        }
+
+        foreach ($rules as $rule) {
+            $parameters = null;
+
+            // If we have a rule with a value
+            if (($colon = strpos($rule, ':')) !== false) {
+                $rulename = substr($rule, 0, $colon) ;
+
+                /**
+                 * Regular expressions may contain commas and should not be divided by str_getcsv.
+                 * For regular expressions we are just using the complete expression as a parameter.
+                 */
+                if ($rulename !== 'regex') {
+                    $parameters = str_getcsv(substr($rule, $colon + 1));
+                } else {
+                    $parameters = [substr($rule, $colon + 1)];
+                }
+            }
+
+            // Exclude unsupported rules
+            $rule = is_numeric($colon) ? substr($rule, 0, $colon) : $rule;
+
+            // Store processed rule in Former's array
+            if (!isset($parameters)) {
+                $parameters = array();
+            }
+
+            call_user_func_array([$this, 'rule'], array_merge([$rule], $parameters));
+        }
+
+        return $this;
+    }
+
+    /**
+     * Adds a label to the group/field
+     *
+     * @param  string $text       A label
+     * @param  array  $attributes The label's attributes
+     *
+     * @return Field              A field
+     */
+    public function label($text, $attributes = array())
+    {
+        // Create the Label element
+        $for   = $this->id ?: $this->name;
+        $label = $this->app['former']->label($text, $for, $attributes);
+
+        // Set label
+        $this->label = $label;
+        if ($this->group) {
+            $this->group->setLabel($label);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Set the Field value no matter what
+     *
+     * @param string $value A new value
+     */
+    public function forceValue($value)
+    {
+        $this->value = $value;
+
+        return $this;
+    }
+
+    /**
+     * Classic setting of attribute, won't overwrite any populate() attempt
+     *
+     * @param  string $value A new value
+     */
+    public function value($value)
+    {
+        // Check if we already have a value stored for this field or in POST data
+        $already = $this->repopulate();
+
+        if (!$already) {
+            $this->value = $value;
+        }
+
+        return $this;
+    }
+
+    /**
+     * Change the field's name
+     *
+     * @param  string $name The new name
+     */
+    public function name($name)
+    {
+        $this->name = $name;
+
+        // Also relink the label to the new name
+        $this->label($name);
+
+        return $this;
+    }
+
+    /**
+     * Get the field's labels
+     *
+     * @return string
+     */
+    public function getLabel()
+    {
+        return $this->label;
+    }
+
+    /**
+     * Change the field's bind destination
+     *
+     * @param $destination
+     */
+    public function bind($destination) {
+        $this->bind = $destination;
+        if ($this->type != 'password') {
+            $this->value = $this->repopulate();
+        }
+
+        return $this;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////////////// HELPERS ///////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Use values stored in Former to populate the current field
+     */
+    private function repopulate($fallback = null)
+    {
+        // Get values from POST, populated, and manually set value
+        $post      = $this->app['former']->getPost($this->name);
+        $populator = $this->form ? $this->form->getPopulator() : $this->app['former.populator'];
+        $populate  = $populator->get($this->bind ?: $this->name);
+
+        // Assign a priority to each
+        if (!is_null($post)) {
+            return $post;
+        }
+        if (!is_null($populate)) {
+            return $populate;
+        }
+
+        return $fallback ?: $this->value;
+    }
+
+    /**
+     * Ponders a label and a field name, and tries to get the best out of it
+     *
+     * @param  string $label A label
+     * @param  string $name  A field name
+     *
+     * @return false|null         A label and a field name
+     */
+    private function automaticLabels($name, $label)
+    {
+        // Disabled automatic labels
+        if (!$this->app['former']->getOption('automatic_label')) {
+            $this->name = $name;
+            $this->label($label);
+
+            return false;
+        }
+
+        // Check for the two possibilities
+        if ($label and is_null($name)) {
+            $name = Str::slug($label);
+        } elseif (is_null($label) and $name) {
+            $label = preg_replace('/\[\]$/', '', $name);
+        }
+
+        // Save values
+        $this->name = $name;
+        $this->label($label);
+    }
 }

src/Former/Traits/Framework.php

Indentation +301 added lines, -301 removed lines

@@ -8,305 +8,305 @@
  */
 abstract class Framework
 {
-	/**
-	 * The Container
-	 *
-	 * @var Container
-	 */
-	protected $app;
-
-	/**
-	 * Form types that trigger special styling
-	 *
-	 * @var array
-	 */
-	protected $availableTypes = array();
-
-	/**
-	 * The field states available
-	 *
-	 * @var array
-	 */
-	protected $states = array();
-
-	/**
-	 * The default label width (for horizontal forms)
-	 *
-	 * @var string
-	 */
-	protected $labelWidth;
-
-	/**
-	 * The default field width (for horizontal forms)
-	 *
-	 * @var string
-	 */
-	protected $fieldWidth;
-
-	/**
-	 * The default offset for fields (for horizontal form fields
-	 * with no label, so usually equal to the default label width)
-	 *
-	 * @var string
-	 */
-	protected $fieldOffset;
-
-	/**
-	 * The default HTML tag used for icons
-	 *
-	 * @var string
-	 */
-	protected $iconTag;
-
-	/**
-	 * The default set for icon fonts
-	 *
-	 * @var string
-	 */
-	protected $iconSet;
-
-	/**
-	 * The default prefix icon names
-	 *
-	 * @var string
-	 */
-	protected $iconPrefix;
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////// CURRENT FRAMEWORK /////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Get the name of the current framework
-	 *
-	 * @return string
-	 */
-	public function current()
-	{
-		return basename(str_replace('\\', '/', get_class($this)));
-	}
-
-	/**
-	 * Check if the current framework matches something
-	 *
-	 * @param  string $framework
-	 *
-	 * @return boolean
-	 */
-	public function is($framework)
-	{
-		return $framework == $this->current();
-	}
-
-	/**
-	 * Check if the current framework doesn't match something
-	 *
-	 * @param  string $framework
-	 *
-	 * @return boolean
-	 */
-	public function isnt($framework)
-	{
-		return $framework != $this->current();
-	}
-
-	////////////////////////////////////////////////////////////////////
-	/////////////////////////// COMMON METHODS /////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * List form types triggered special styling form current framework
-	 *
-	 * @return array
-	 */
-	public function availableTypes()
-	{
-		return $this->availableTypes;
-	}
-
-	/**
-	 * Filter a field state
-	 *
-	 * @param string $state
-	 *
-	 * @return string
-	 */
-	public function filterState($state)
-	{
-		// Filter out wrong states
-		return in_array($state, $this->states) ? $state : null;
-	}
-
-	/**
-	 * Framework error state
-	 *
-	 * @return string
-	 */
-	public function errorState()
-	{
-		return 'error';
-	}
-
-	/**
-	 * Returns corresponding inline class of a field
-	 *
-	 * @param Field $field
-	 *
-	 * @return string
-	 */
-	public function getInlineLabelClass($field)
-	{
-		return 'inline';
-	}
-
-	/**
-	 * Set framework defaults from its config file
-	 */
-	protected function setFrameworkDefaults()
-	{
-		$this->setFieldWidths($this->getFrameworkOption('labelWidths'));
-		$this->setIconDefaults();
-	}
-
-	/**
-	 * @param string $widths
-	 */
-	protected function setFieldWidths($widths)
-	{
-	}
-
-	/**
-	 * Override framework defaults for icons with config values where set
-	 */
-	protected function setIconDefaults()
-	{
-		$this->iconTag    = $this->getFrameworkOption('icon.tag');
-		$this->iconSet    = $this->getFrameworkOption('icon.set');
-		$this->iconPrefix = $this->getFrameworkOption('icon.prefix');
-	}
-
-	/**
-	 * Render an icon
-	 *
-	 * @param array $attributes Its general attributes
-	 *
-	 * @return string
-	 */
-	public function createIcon($iconType, $attributes = array(), $iconSettings = array())
-	{
-		// Check for empty icons
-		if (!$iconType) {
-			return false;
-		}
-
-		// icon settings can be overridden for a specific icon
-		$tag    = array_get($iconSettings, 'tag', $this->iconTag);
-		$set    = array_get($iconSettings, 'set', $this->iconSet);
-		$prefix = array_get($iconSettings, 'prefix', $this->iconPrefix);
-
-		return Element::create($tag, null, $attributes)->addClass("$set $prefix-$iconType");
-	}
-
-	////////////////////////////////////////////////////////////////////
-	///////////////////////////// HELPERS //////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Add classes to a field
-	 *
-	 * @param Field $field
-	 * @param array $classes
-	 *
-	 * @return \Former\Traits\Field
-	 */
-	protected function addClassesToField($field, $classes)
-	{
-		// If we found any class, add them
-		if ($classes) {
-			$field->addClass(implode(' ', $classes));
-		}
-
-		return $field;
-	}
-
-	/**
-	 * Prepend an array of classes with a string
-	 *
-	 * @param array  $classes The classes to prepend
-	 * @param string $with    The string to prepend them with
-	 *
-	 * @return array A prepended array
-	 */
-	protected function prependWith($classes, $with)
-	{
-		return array_map(function($class) use ($with) {
-			return $with.$class;
-		}, $classes);
-	}
-
-	/**
-	 * Create a label for a field
-	 *
-	 * @param Field   $field
-	 * @param Element $label The field label if non provided
-	 *
-	 * @return string A label
-	 */
-	public function createLabelOf(Field $field, Element $label = null)
-	{
-		// Get the label and its informations
-		if (!$label) {
-			$label = $field->getLabel();
-		}
-
-		// Get label "for"
-		$for = $field->id ?: $field->getName();
-
-		// Get label text
-		$text = $label->getValue();
-		if (!$text) {
-			return false;
-		}
-
-		// Append required text
-		if ($field->isRequired()) {
-			$text .= $this->app['former']->getOption('required_text');
-		}
-
-		// Render plain label if checkable, else a classic one
-		$label->setValue($text);
-		if (!$field->isCheckable()) {
-			$label->for($for);
-		}
-
-		return $label;
-	}
-
-	/**
-	 * Get an option for the current framework
-	 *
-	 * @param string $option
-	 *
-	 * @return string
-	 */
-	protected function getFrameworkOption($option)
-	{
-		return $this->app['config']->get("former.{$this->current()}.$option");
-	}
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////////// WRAP BLOCKS ///////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Wraps all label contents with potential additional tags.
-	 *
-	 * @param  string $label
-	 *
-	 * @return string A wrapped label
-	 */
-	public function wrapLabel($label)
-	{
-		return $label;
-	}
+    /**
+     * The Container
+     *
+     * @var Container
+     */
+    protected $app;
+
+    /**
+     * Form types that trigger special styling
+     *
+     * @var array
+     */
+    protected $availableTypes = array();
+
+    /**
+     * The field states available
+     *
+     * @var array
+     */
+    protected $states = array();
+
+    /**
+     * The default label width (for horizontal forms)
+     *
+     * @var string
+     */
+    protected $labelWidth;
+
+    /**
+     * The default field width (for horizontal forms)
+     *
+     * @var string
+     */
+    protected $fieldWidth;
+
+    /**
+     * The default offset for fields (for horizontal form fields
+     * with no label, so usually equal to the default label width)
+     *
+     * @var string
+     */
+    protected $fieldOffset;
+
+    /**
+     * The default HTML tag used for icons
+     *
+     * @var string
+     */
+    protected $iconTag;
+
+    /**
+     * The default set for icon fonts
+     *
+     * @var string
+     */
+    protected $iconSet;
+
+    /**
+     * The default prefix icon names
+     *
+     * @var string
+     */
+    protected $iconPrefix;
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////// CURRENT FRAMEWORK /////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Get the name of the current framework
+     *
+     * @return string
+     */
+    public function current()
+    {
+        return basename(str_replace('\\', '/', get_class($this)));
+    }
+
+    /**
+     * Check if the current framework matches something
+     *
+     * @param  string $framework
+     *
+     * @return boolean
+     */
+    public function is($framework)
+    {
+        return $framework == $this->current();
+    }
+
+    /**
+     * Check if the current framework doesn't match something
+     *
+     * @param  string $framework
+     *
+     * @return boolean
+     */
+    public function isnt($framework)
+    {
+        return $framework != $this->current();
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    /////////////////////////// COMMON METHODS /////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * List form types triggered special styling form current framework
+     *
+     * @return array
+     */
+    public function availableTypes()
+    {
+        return $this->availableTypes;
+    }
+
+    /**
+     * Filter a field state
+     *
+     * @param string $state
+     *
+     * @return string
+     */
+    public function filterState($state)
+    {
+        // Filter out wrong states
+        return in_array($state, $this->states) ? $state : null;
+    }
+
+    /**
+     * Framework error state
+     *
+     * @return string
+     */
+    public function errorState()
+    {
+        return 'error';
+    }
+
+    /**
+     * Returns corresponding inline class of a field
+     *
+     * @param Field $field
+     *
+     * @return string
+     */
+    public function getInlineLabelClass($field)
+    {
+        return 'inline';
+    }
+
+    /**
+     * Set framework defaults from its config file
+     */
+    protected function setFrameworkDefaults()
+    {
+        $this->setFieldWidths($this->getFrameworkOption('labelWidths'));
+        $this->setIconDefaults();
+    }
+
+    /**
+     * @param string $widths
+     */
+    protected function setFieldWidths($widths)
+    {
+    }
+
+    /**
+     * Override framework defaults for icons with config values where set
+     */
+    protected function setIconDefaults()
+    {
+        $this->iconTag    = $this->getFrameworkOption('icon.tag');
+        $this->iconSet    = $this->getFrameworkOption('icon.set');
+        $this->iconPrefix = $this->getFrameworkOption('icon.prefix');
+    }
+
+    /**
+     * Render an icon
+     *
+     * @param array $attributes Its general attributes
+     *
+     * @return string
+     */
+    public function createIcon($iconType, $attributes = array(), $iconSettings = array())
+    {
+        // Check for empty icons
+        if (!$iconType) {
+            return false;
+        }
+
+        // icon settings can be overridden for a specific icon
+        $tag    = array_get($iconSettings, 'tag', $this->iconTag);
+        $set    = array_get($iconSettings, 'set', $this->iconSet);
+        $prefix = array_get($iconSettings, 'prefix', $this->iconPrefix);
+
+        return Element::create($tag, null, $attributes)->addClass("$set $prefix-$iconType");
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ///////////////////////////// HELPERS //////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Add classes to a field
+     *
+     * @param Field $field
+     * @param array $classes
+     *
+     * @return \Former\Traits\Field
+     */
+    protected function addClassesToField($field, $classes)
+    {
+        // If we found any class, add them
+        if ($classes) {
+            $field->addClass(implode(' ', $classes));
+        }
+
+        return $field;
+    }
+
+    /**
+     * Prepend an array of classes with a string
+     *
+     * @param array  $classes The classes to prepend
+     * @param string $with    The string to prepend them with
+     *
+     * @return array A prepended array
+     */
+    protected function prependWith($classes, $with)
+    {
+        return array_map(function($class) use ($with) {
+            return $with.$class;
+        }, $classes);
+    }
+
+    /**
+     * Create a label for a field
+     *
+     * @param Field   $field
+     * @param Element $label The field label if non provided
+     *
+     * @return string A label
+     */
+    public function createLabelOf(Field $field, Element $label = null)
+    {
+        // Get the label and its informations
+        if (!$label) {
+            $label = $field->getLabel();
+        }
+
+        // Get label "for"
+        $for = $field->id ?: $field->getName();
+
+        // Get label text
+        $text = $label->getValue();
+        if (!$text) {
+            return false;
+        }
+
+        // Append required text
+        if ($field->isRequired()) {
+            $text .= $this->app['former']->getOption('required_text');
+        }
+
+        // Render plain label if checkable, else a classic one
+        $label->setValue($text);
+        if (!$field->isCheckable()) {
+            $label->for($for);
+        }
+
+        return $label;
+    }
+
+    /**
+     * Get an option for the current framework
+     *
+     * @param string $option
+     *
+     * @return string
+     */
+    protected function getFrameworkOption($option)
+    {
+        return $this->app['config']->get("former.{$this->current()}.$option");
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////////// WRAP BLOCKS ///////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Wraps all label contents with potential additional tags.
+     *
+     * @param  string $label
+     *
+     * @return string A wrapped label
+     */
+    public function wrapLabel($label)
+    {
+        return $label;
+    }
 }

src/Former/Traits/Checkable.php

Indentation +544 added lines, -544 removed lines

@@ -12,548 +12,548 @@
  */
 abstract class Checkable extends Field
 {
-	/**
-	 * Renders the checkables as inline
-	 *
-	 * @var boolean
-	 */
-	protected $inline = false;
-
-	/**
-	 * Add a text to a single element
-	 *
-	 * @var string
-	 */
-	protected $text = null;
-
-	/**
-	 * Renders the checkables as grouped
-	 *
-	 * @var boolean
-	 */
-	protected $grouped = false;
-
-	/**
-	 * The checkable items currently stored
-	 *
-	 * @var array
-	 */
-	protected $items = array();
-
-	/**
-	 * The type of checkable item
-	 *
-	 * @var string
-	 */
-	protected $checkable = null;
-
-	/**
-	 * An array of checked items
-	 *
-	 * @var array
-	 */
-	protected $checked = array();
-
-	/**
-	 * The checkable currently being focused on
-	 *
-	 * @var integer
-	 */
-	protected $focus = null;
-
-	/**
-	 * Whether this particular checkable is to be pushed
-	 *
-	 * @var boolean
-	 */
-	protected $isPushed = null;
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////////// CORE METHODS //////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Build a new checkable
-	 *
-	 * @param Container $app
-	 * @param string    $type
-	 * @param array     $name
-	 * @param           $label
-	 * @param           $value
-	 * @param           $attributes
-	 */
-	public function __construct(Container $app, $type, $name, $label, $value, $attributes)
-	{
-		// Unify auto and chained methods of grouping checkboxes
-		if (ends_with($name, '[]')) {
-			$name = substr($name, 0, -2);
-			$this->grouped();
-		}
-		parent::__construct($app, $type, $name, $label, $value, $attributes);
-
-		if (is_array($this->value)) {
-			$this->items($this->value);
-		}
-	}
-
-	/**
-	 * Apply methods to focused checkable
-	 *
-	 * @param string $method
-	 * @param array  $parameters
-	 *
-	 * @return $this
-	 */
-	public function __call($method, $parameters)
-	{
-		$focused = $this->setOnFocused('attributes.'.$method, array_get($parameters, 0));
-		if ($focused) {
-			return $this;
-		}
-
-		return parent::__call($method, $parameters);
-	}
-
-	/**
-	 * Prints out the currently stored checkables
-	 */
-	public function render()
-	{
-		$html = null;
-
-		// Multiple items
-		if ($this->items) {
-			unset($this->app['former']->labels[array_search($this->name, $this->app['former']->labels)]);
-			foreach ($this->items as $key => $item) {
-				$value = $this->isCheckbox() && !$this->isGrouped() ? 1 : $key;
-				$html .= $this->createCheckable($item, $value);
-			}
-
-			return $html;
-		}
-
-		// Single item
-		return $this->createCheckable(array(
-			'name'  => $this->name,
-			'label' => $this->text,
-			'value' => $this->value,
-			'attributes' => $this->attributes,
-		));
-	}
-
-	////////////////////////////////////////////////////////////////////
-	////////////////////////// FIELD METHODS ///////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Focus on a particular checkable
-	 *
-	 * @param integer $on The checkable to focus on
-	 *
-	 * @return $this
-	 */
-	public function on($on)
-	{
-		if (!isset($this->items[$on])) {
-			return $this;
-		} else {
-			$this->focus = $on;
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Set the checkables as inline
-	 */
-	public function inline()
-	{
-		$this->inline = true;
-
-		return $this;
-	}
-
-	/**
-	 * Set the checkables as stacked
-	 */
-	public function stacked()
-	{
-		$this->inline = false;
-
-		return $this;
-	}
-
-	/**
-	 * Set the checkables as grouped
-	 */
-	public function grouped()
-	{
-		$this->grouped = true;
-
-		return $this;
-	}
-
-	/**
-	 * Add text to a single checkable
-	 *
-	 * @param  string $text The checkable label
-	 *
-	 * @return $this
-	 */
-	public function text($text)
-	{
-		// Translate and format
-		$text = Helpers::translate($text);
-
-		// Apply on focused if any
-		$focused = $this->setOnFocused('label', $text);
-		if ($focused) {
-			return $this;
-		}
-
-		$this->text = $text;
-
-		return $this;
-	}
-
-	/**
-	 * Push this particular checkbox
-	 *
-	 * @param boolean $pushed
-	 *
-	 * @return $this
-	 */
-	public function push($pushed = true)
-	{
-		$this->isPushed = $pushed;
-
-		return $this;
-	}
-
-	/**
-	 * Check a specific item
-	 *
-	 * @param bool|string $checked The checkable to check, or an array of checked items
-	 *
-	 * @return $this
-	 */
-	public function check($checked = true)
-	{
-		// If we're setting all the checked items at once
-		if (is_array($checked)) {
-			$this->checked = $checked;
-			// Checking an item in particular
-		} elseif (is_string($checked) or is_int($checked)) {
-			$this->checked[$checked] = true;
-			// Only setting a single item
-		} else {
-			$this->checked[$this->name] = (bool) $checked;
-		}
-
-		return $this;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	////////////////////////// INTERNAL METHODS ////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Creates a series of checkable items
-	 *
-	 * @param array $_items Items to create
-	 */
-	protected function items($_items)
-	{
-		// If passing an array
-		if (sizeof($_items) == 1 and
-			isset($_items[0]) and
-			is_array($_items[0])
-		) {
-			$_items = $_items[0];
-		}
-
-		// Fetch models if that's what we were passed
-		if (isset($_items[0]) and is_object($_items[0])) {
-			$_items = Helpers::queryToArray($_items);
-			$_items = array_flip($_items);
-		}
-
-		// Iterate through items, assign a name and a label to each
-		$count = 0;
-		foreach ($_items as $label => $name) {
-
-			// Define a fallback name in case none is found
-			$fallback = $this->isCheckbox()
-				? $this->name.'_'.$count
-				: $this->name;
-
-			// Grouped fields
-			if ($this->isGrouped()) {
-				$attributes['id'] = str_replace('[]', null, $fallback);
-				$fallback         = str_replace('[]', null, $this->name).'[]';
-			}
-
-			// If we haven't any name defined for the checkable, try to compute some
-			if (!is_string($label) and !is_array($name)) {
-				$label = $name;
-				$name  = $fallback;
-			}
-
-			// If we gave custom information on the item, add them
-			if (is_array($name)) {
-				$attributes = $name;
-				$name       = array_get($attributes, 'name', $fallback);
-				unset($attributes['name']);
-			}
-
-			// Store all informations we have in an array
-			$item = array(
-				'name'  => $name,
-				'label' => Helpers::translate($label),
-				'count' => $count,
-			);
-			if (isset($attributes)) {
-				$item['attributes'] = $attributes;
-			}
-
-			$this->items[] = $item;
-			$count++;
-		}
-	}
-
-	/**
-	 * Renders a checkable
-	 *
-	 * @param string|array $item          A checkable item
-	 * @param integer      $fallbackValue A fallback value if none is set
-	 *
-	 * @return string
-	 */
-	protected function createCheckable($item, $fallbackValue = 1)
-	{
-		// Extract informations
-		extract($item);
-
-		// Set default values
-		if (!isset($attributes)) {
-			$attributes = array();
-		}
-		if (isset($attributes['value'])) {
-			$value = $attributes['value'];
-		}
-		if (!isset($value) or $value === $this->app['former']->getOption('unchecked_value')) {
-			$value = $fallbackValue;
-		}
-
-		// If inline items, add class
-		$isInline = $this->inline ? ' '.$this->app['former.framework']->getInlineLabelClass($this) : null;
-
-		// In Bootsrap 3, don't append the the checkable type (radio/checkbox) as a class if
-		// rendering inline.
-		$class = $this->app['former']->framework() == 'TwitterBootstrap3' ? trim($isInline) : $this->checkable.$isInline;
-
-		// Merge custom attributes with global attributes
-		$attributes = array_merge($this->attributes, $attributes);
-		if (!isset($attributes['id'])) {
-			$attributes['id'] = $name.$this->unique($name);
-		}
-
-		// Create field
-		$field = Input::create($this->checkable, $name, $value, $attributes);
-		if ($this->isChecked($item, $value)) {
-			$field->checked('checked');
-		}
-
-		// Add hidden checkbox if requested
-		if ($this->isOfType('checkbox', 'checkboxes')) {
-			if ($this->isPushed or ($this->app['former']->getOption('push_checkboxes') and $this->isPushed !== false)) {
-				$field = $this->app['former']->hidden($name)->forceValue($this->app['former']->getOption('unchecked_value')).$field->render();
-
-				// app['former.field'] was overwritten by Former::hidden() call in the line above, so here
-				// we reset it to $this to enable $this->app['former']->getErrors() to retrieve the correct object
-				$this->app->instance('former.field', $this);
-			}
-		}
-
-		// If no label to wrap, return plain checkable
-		if (!$label) {
-			$element = (is_object($field)) ? $field->render() : $field;
-		} else {
-			$element = Element::create('label', $field.$label)->for($attributes['id'])->class($class)->render();
-		}
-
-		// If BS3, if checkables are stacked, wrap them in a div with the checkable type
-		if (!$isInline && $this->app['former']->framework() == 'TwitterBootstrap3') {
-			$wrapper = Element::create('div', $element)->class($this->checkable);
-			if ($this->getAttribute('disabled')) {
-				$wrapper->addClass('disabled');
-			}
-			$element = $wrapper->render();
-		}
-
-		// Return the field
-		return $element;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	///////////////////////////// HELPERS //////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Generate an unique ID for a field
-	 *
-	 * @param string $name The field's name
-	 *
-	 * @return string A field number to use
-	 */
-	protected function unique($name)
-	{
-		$this->app['former']->labels[] = $name;
-
-		// Count number of fields with the same ID
-		$where  = array_filter($this->app['former']->labels, function($label) use ($name) {
-			return $label == $name;
-		});
-		$unique = sizeof($where);
-
-		// In case the field doesn't need to be numbered
-		if ($unique < 2 or empty($this->items)) {
-			return false;
-		}
-
-		return $unique;
-	}
-
-	/**
-	 * Set something on the currently focused checkable
-	 *
-	 * @param string $attribute The key to set
-	 * @param string $value     Its value
-	 *
-	 * @return $this|bool
-	 */
-	protected function setOnFocused($attribute, $value)
-	{
-		if (is_null($this->focus)) {
-			return false;
-		}
-
-		$this->items[$this->focus] = array_set($this->items[$this->focus], $attribute, $value);
-
-		return $this;
-	}
-
-	/**
-	 * Check if a checkable is checked
-	 *
-	 * @return boolean Checked or not
-	 */
-	protected function isChecked($item = null, $value = null)
-	{
-		if (isset($item['name'])) {
-			$name = $item['name'];
-		}
-		if (empty($name)) {
-			$name = $this->name;
-		}
-
-		// If it's a checkbox, see if we marqued that one as checked in the array
-		// Or if it's a single radio, simply see if we called check
-		if ($this->isCheckbox() or
-			!$this->isCheckbox() and !$this->items
-		) {
-			$checked = array_get($this->checked, $name, false);
-
-			// If there are multiple, search for the value
-			// as the name are the same between radios
-		} else {
-			$checked = array_get($this->checked, $value, false);
-		}
-
-		// Check the values and POST array
-		if ($this->isGrouped()) {
-			// The group index. (e.g. 'bar' if the item name is foo[bar], or the item index for foo[])
-			$groupIndex = self::getGroupIndexFromItem($item);
-
-			// Search using the bare name, not the individual item name
-			$post   = $this->app['former']->getPost($this->name);
-			$static = $this->app['former']->getValue($this->bind ?: $this->name);
-
-			if (isset($post[$groupIndex])) {
-				$post = $post[$groupIndex];
-			}
-
-			/**
-			 * Support for Laravel Collection repopulating for grouped checkboxes. Note that the groupIndex must
-			 * match the value in order for the checkbox to be considered checked, e.g.:
-			 *
-			 *  array(
-			 *    'name' = 'roles[foo]',
-			 *    'value' => 'foo',
-			 *  )
-			 */
-			if ($static instanceof Collection) {
-				// If the repopulate value is a collection, search for an item matching the $groupIndex
-				foreach ($static as $staticItem) {
-					$staticItemValue = method_exists($staticItem, 'getKey') ? $staticItem->getKey() : $staticItem;
-					if ($staticItemValue == $groupIndex) {
-						$static = $staticItemValue;
-						break;
-					}
-				}
-			} else if (isset($static[$groupIndex])) {
-				$static = $static[$groupIndex];
-			}
-		} else {
-			$post   = $this->app['former']->getPost($name);
-			$static = $this->app['former']->getValue($this->bind ?: $name);
-		}
-
-		if (!is_null($post) and $post !== $this->app['former']->getOption('unchecked_value')) {
-			$isChecked = ($post == $value);
-		} elseif (!is_null($static)) {
-			$isChecked = ($static == $value);
-		} else {
-			$isChecked = $checked;
-		}
-
-		return $isChecked ? true : false;
-	}
-
-	/**
-	 * Check if the current element is a checkbox
-	 *
-	 * @return boolean Checkbox or radio
-	 */
-	protected function isCheckbox()
-	{
-		return $this->checkable == 'checkbox';
-	}
-
-	/**
-	 * Check if the checkables are grouped or not
-	 *
-	 * @return boolean
-	 */
-	protected function isGrouped()
-	{
-		return
-			$this->grouped == true or
-			strpos($this->name, '[]') !== false;
-	}
-
-	/**
-	 * @param array $item The item array, containing at least name and count keys.
-	 *
-	 * @return mixed The group index. (e.g. returns bar if the item name is foo[bar], or the item count for foo[])
-	 */
-	public static function getGroupIndexFromItem($item)
-	{
-		$groupIndex = preg_replace('/^.*?\[(.*)\]$/', '$1', $item['name']);
-		if (empty($groupIndex) or $groupIndex == $item['name']) {
-			return $item['count'];
-		}
-
-		return $groupIndex;
-	}
+    /**
+     * Renders the checkables as inline
+     *
+     * @var boolean
+     */
+    protected $inline = false;
+
+    /**
+     * Add a text to a single element
+     *
+     * @var string
+     */
+    protected $text = null;
+
+    /**
+     * Renders the checkables as grouped
+     *
+     * @var boolean
+     */
+    protected $grouped = false;
+
+    /**
+     * The checkable items currently stored
+     *
+     * @var array
+     */
+    protected $items = array();
+
+    /**
+     * The type of checkable item
+     *
+     * @var string
+     */
+    protected $checkable = null;
+
+    /**
+     * An array of checked items
+     *
+     * @var array
+     */
+    protected $checked = array();
+
+    /**
+     * The checkable currently being focused on
+     *
+     * @var integer
+     */
+    protected $focus = null;
+
+    /**
+     * Whether this particular checkable is to be pushed
+     *
+     * @var boolean
+     */
+    protected $isPushed = null;
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////////// CORE METHODS //////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Build a new checkable
+     *
+     * @param Container $app
+     * @param string    $type
+     * @param array     $name
+     * @param           $label
+     * @param           $value
+     * @param           $attributes
+     */
+    public function __construct(Container $app, $type, $name, $label, $value, $attributes)
+    {
+        // Unify auto and chained methods of grouping checkboxes
+        if (ends_with($name, '[]')) {
+            $name = substr($name, 0, -2);
+            $this->grouped();
+        }
+        parent::__construct($app, $type, $name, $label, $value, $attributes);
+
+        if (is_array($this->value)) {
+            $this->items($this->value);
+        }
+    }
+
+    /**
+     * Apply methods to focused checkable
+     *
+     * @param string $method
+     * @param array  $parameters
+     *
+     * @return $this
+     */
+    public function __call($method, $parameters)
+    {
+        $focused = $this->setOnFocused('attributes.'.$method, array_get($parameters, 0));
+        if ($focused) {
+            return $this;
+        }
+
+        return parent::__call($method, $parameters);
+    }
+
+    /**
+     * Prints out the currently stored checkables
+     */
+    public function render()
+    {
+        $html = null;
+
+        // Multiple items
+        if ($this->items) {
+            unset($this->app['former']->labels[array_search($this->name, $this->app['former']->labels)]);
+            foreach ($this->items as $key => $item) {
+                $value = $this->isCheckbox() && !$this->isGrouped() ? 1 : $key;
+                $html .= $this->createCheckable($item, $value);
+            }
+
+            return $html;
+        }
+
+        // Single item
+        return $this->createCheckable(array(
+            'name'  => $this->name,
+            'label' => $this->text,
+            'value' => $this->value,
+            'attributes' => $this->attributes,
+        ));
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ////////////////////////// FIELD METHODS ///////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Focus on a particular checkable
+     *
+     * @param integer $on The checkable to focus on
+     *
+     * @return $this
+     */
+    public function on($on)
+    {
+        if (!isset($this->items[$on])) {
+            return $this;
+        } else {
+            $this->focus = $on;
+        }
+
+        return $this;
+    }
+
+    /**
+     * Set the checkables as inline
+     */
+    public function inline()
+    {
+        $this->inline = true;
+
+        return $this;
+    }
+
+    /**
+     * Set the checkables as stacked
+     */
+    public function stacked()
+    {
+        $this->inline = false;
+
+        return $this;
+    }
+
+    /**
+     * Set the checkables as grouped
+     */
+    public function grouped()
+    {
+        $this->grouped = true;
+
+        return $this;
+    }
+
+    /**
+     * Add text to a single checkable
+     *
+     * @param  string $text The checkable label
+     *
+     * @return $this
+     */
+    public function text($text)
+    {
+        // Translate and format
+        $text = Helpers::translate($text);
+
+        // Apply on focused if any
+        $focused = $this->setOnFocused('label', $text);
+        if ($focused) {
+            return $this;
+        }
+
+        $this->text = $text;
+
+        return $this;
+    }
+
+    /**
+     * Push this particular checkbox
+     *
+     * @param boolean $pushed
+     *
+     * @return $this
+     */
+    public function push($pushed = true)
+    {
+        $this->isPushed = $pushed;
+
+        return $this;
+    }
+
+    /**
+     * Check a specific item
+     *
+     * @param bool|string $checked The checkable to check, or an array of checked items
+     *
+     * @return $this
+     */
+    public function check($checked = true)
+    {
+        // If we're setting all the checked items at once
+        if (is_array($checked)) {
+            $this->checked = $checked;
+            // Checking an item in particular
+        } elseif (is_string($checked) or is_int($checked)) {
+            $this->checked[$checked] = true;
+            // Only setting a single item
+        } else {
+            $this->checked[$this->name] = (bool) $checked;
+        }
+
+        return $this;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ////////////////////////// INTERNAL METHODS ////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Creates a series of checkable items
+     *
+     * @param array $_items Items to create
+     */
+    protected function items($_items)
+    {
+        // If passing an array
+        if (sizeof($_items) == 1 and
+            isset($_items[0]) and
+            is_array($_items[0])
+        ) {
+            $_items = $_items[0];
+        }
+
+        // Fetch models if that's what we were passed
+        if (isset($_items[0]) and is_object($_items[0])) {
+            $_items = Helpers::queryToArray($_items);
+            $_items = array_flip($_items);
+        }
+
+        // Iterate through items, assign a name and a label to each
+        $count = 0;
+        foreach ($_items as $label => $name) {
+
+            // Define a fallback name in case none is found
+            $fallback = $this->isCheckbox()
+                ? $this->name.'_'.$count
+                : $this->name;
+
+            // Grouped fields
+            if ($this->isGrouped()) {
+                $attributes['id'] = str_replace('[]', null, $fallback);
+                $fallback         = str_replace('[]', null, $this->name).'[]';
+            }
+
+            // If we haven't any name defined for the checkable, try to compute some
+            if (!is_string($label) and !is_array($name)) {
+                $label = $name;
+                $name  = $fallback;
+            }
+
+            // If we gave custom information on the item, add them
+            if (is_array($name)) {
+                $attributes = $name;
+                $name       = array_get($attributes, 'name', $fallback);
+                unset($attributes['name']);
+            }
+
+            // Store all informations we have in an array
+            $item = array(
+                'name'  => $name,
+                'label' => Helpers::translate($label),
+                'count' => $count,
+            );
+            if (isset($attributes)) {
+                $item['attributes'] = $attributes;
+            }
+
+            $this->items[] = $item;
+            $count++;
+        }
+    }
+
+    /**
+     * Renders a checkable
+     *
+     * @param string|array $item          A checkable item
+     * @param integer      $fallbackValue A fallback value if none is set
+     *
+     * @return string
+     */
+    protected function createCheckable($item, $fallbackValue = 1)
+    {
+        // Extract informations
+        extract($item);
+
+        // Set default values
+        if (!isset($attributes)) {
+            $attributes = array();
+        }
+        if (isset($attributes['value'])) {
+            $value = $attributes['value'];
+        }
+        if (!isset($value) or $value === $this->app['former']->getOption('unchecked_value')) {
+            $value = $fallbackValue;
+        }
+
+        // If inline items, add class
+        $isInline = $this->inline ? ' '.$this->app['former.framework']->getInlineLabelClass($this) : null;
+
+        // In Bootsrap 3, don't append the the checkable type (radio/checkbox) as a class if
+        // rendering inline.
+        $class = $this->app['former']->framework() == 'TwitterBootstrap3' ? trim($isInline) : $this->checkable.$isInline;
+
+        // Merge custom attributes with global attributes
+        $attributes = array_merge($this->attributes, $attributes);
+        if (!isset($attributes['id'])) {
+            $attributes['id'] = $name.$this->unique($name);
+        }
+
+        // Create field
+        $field = Input::create($this->checkable, $name, $value, $attributes);
+        if ($this->isChecked($item, $value)) {
+            $field->checked('checked');
+        }
+
+        // Add hidden checkbox if requested
+        if ($this->isOfType('checkbox', 'checkboxes')) {
+            if ($this->isPushed or ($this->app['former']->getOption('push_checkboxes') and $this->isPushed !== false)) {
+                $field = $this->app['former']->hidden($name)->forceValue($this->app['former']->getOption('unchecked_value')).$field->render();
+
+                // app['former.field'] was overwritten by Former::hidden() call in the line above, so here
+                // we reset it to $this to enable $this->app['former']->getErrors() to retrieve the correct object
+                $this->app->instance('former.field', $this);
+            }
+        }
+
+        // If no label to wrap, return plain checkable
+        if (!$label) {
+            $element = (is_object($field)) ? $field->render() : $field;
+        } else {
+            $element = Element::create('label', $field.$label)->for($attributes['id'])->class($class)->render();
+        }
+
+        // If BS3, if checkables are stacked, wrap them in a div with the checkable type
+        if (!$isInline && $this->app['former']->framework() == 'TwitterBootstrap3') {
+            $wrapper = Element::create('div', $element)->class($this->checkable);
+            if ($this->getAttribute('disabled')) {
+                $wrapper->addClass('disabled');
+            }
+            $element = $wrapper->render();
+        }
+
+        // Return the field
+        return $element;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ///////////////////////////// HELPERS //////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Generate an unique ID for a field
+     *
+     * @param string $name The field's name
+     *
+     * @return string A field number to use
+     */
+    protected function unique($name)
+    {
+        $this->app['former']->labels[] = $name;
+
+        // Count number of fields with the same ID
+        $where  = array_filter($this->app['former']->labels, function($label) use ($name) {
+            return $label == $name;
+        });
+        $unique = sizeof($where);
+
+        // In case the field doesn't need to be numbered
+        if ($unique < 2 or empty($this->items)) {
+            return false;
+        }
+
+        return $unique;
+    }
+
+    /**
+     * Set something on the currently focused checkable
+     *
+     * @param string $attribute The key to set
+     * @param string $value     Its value
+     *
+     * @return $this|bool
+     */
+    protected function setOnFocused($attribute, $value)
+    {
+        if (is_null($this->focus)) {
+            return false;
+        }
+
+        $this->items[$this->focus] = array_set($this->items[$this->focus], $attribute, $value);
+
+        return $this;
+    }
+
+    /**
+     * Check if a checkable is checked
+     *
+     * @return boolean Checked or not
+     */
+    protected function isChecked($item = null, $value = null)
+    {
+        if (isset($item['name'])) {
+            $name = $item['name'];
+        }
+        if (empty($name)) {
+            $name = $this->name;
+        }
+
+        // If it's a checkbox, see if we marqued that one as checked in the array
+        // Or if it's a single radio, simply see if we called check
+        if ($this->isCheckbox() or
+            !$this->isCheckbox() and !$this->items
+        ) {
+            $checked = array_get($this->checked, $name, false);
+
+            // If there are multiple, search for the value
+            // as the name are the same between radios
+        } else {
+            $checked = array_get($this->checked, $value, false);
+        }
+
+        // Check the values and POST array
+        if ($this->isGrouped()) {
+            // The group index. (e.g. 'bar' if the item name is foo[bar], or the item index for foo[])
+            $groupIndex = self::getGroupIndexFromItem($item);
+
+            // Search using the bare name, not the individual item name
+            $post   = $this->app['former']->getPost($this->name);
+            $static = $this->app['former']->getValue($this->bind ?: $this->name);
+
+            if (isset($post[$groupIndex])) {
+                $post = $post[$groupIndex];
+            }
+
+            /**
+             * Support for Laravel Collection repopulating for grouped checkboxes. Note that the groupIndex must
+             * match the value in order for the checkbox to be considered checked, e.g.:
+             *
+             *  array(
+             *    'name' = 'roles[foo]',
+             *    'value' => 'foo',
+             *  )
+             */
+            if ($static instanceof Collection) {
+                // If the repopulate value is a collection, search for an item matching the $groupIndex
+                foreach ($static as $staticItem) {
+                    $staticItemValue = method_exists($staticItem, 'getKey') ? $staticItem->getKey() : $staticItem;
+                    if ($staticItemValue == $groupIndex) {
+                        $static = $staticItemValue;
+                        break;
+                    }
+                }
+            } else if (isset($static[$groupIndex])) {
+                $static = $static[$groupIndex];
+            }
+        } else {
+            $post   = $this->app['former']->getPost($name);
+            $static = $this->app['former']->getValue($this->bind ?: $name);
+        }
+
+        if (!is_null($post) and $post !== $this->app['former']->getOption('unchecked_value')) {
+            $isChecked = ($post == $value);
+        } elseif (!is_null($static)) {
+            $isChecked = ($static == $value);
+        } else {
+            $isChecked = $checked;
+        }
+
+        return $isChecked ? true : false;
+    }
+
+    /**
+     * Check if the current element is a checkbox
+     *
+     * @return boolean Checkbox or radio
+     */
+    protected function isCheckbox()
+    {
+        return $this->checkable == 'checkbox';
+    }
+
+    /**
+     * Check if the checkables are grouped or not
+     *
+     * @return boolean
+     */
+    protected function isGrouped()
+    {
+        return
+            $this->grouped == true or
+            strpos($this->name, '[]') !== false;
+    }
+
+    /**
+     * @param array $item The item array, containing at least name and count keys.
+     *
+     * @return mixed The group index. (e.g. returns bar if the item name is foo[bar], or the item count for foo[])
+     */
+    public static function getGroupIndexFromItem($item)
+    {
+        $groupIndex = preg_replace('/^.*?\[(.*)\]$/', '$1', $item['name']);
+        if (empty($groupIndex) or $groupIndex == $item['name']) {
+            return $item['count'];
+        }
+
+        return $groupIndex;
+    }
 }

src/Former/Traits/FormerObject.php

Indentation +143 added lines, -143 removed lines

@@ -10,147 +10,147 @@
  */
 abstract class FormerObject extends Element
 {
-	/**
-	 * The field's name
-	 *
-	 * @var string
-	 */
-	protected $name;
-
-	/**
-	 * The field type
-	 *
-	 * @var string
-	 */
-	protected $type;
-
-	/**
-	 * A list of class properties to be added to attributes
-	 *
-	 * @var array
-	 */
-	protected $injectedProperties = array('name');
-
-	////////////////////////////////////////////////////////////////////
-	/////////////////////////// ID AND LABELS //////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Create an unique ID and return it
-	 *
-	 * @return string
-	 */
-	public function getCreatedId()
-	{
-		$this->setId();
-
-		return $this->attributes['id'];
-	}
-
-	/**
-	 * Set the matching ID on a field if possible
-	 */
-	protected function setId()
-	{
-		if (!array_key_exists('id', $this->attributes) and
-			in_array($this->name, $this->app['former']->labels)
-		) {
-			// Set and save the field's ID
-			$id                         = $this->getUniqueId($this->name);
-			$this->attributes['id']     = $id;
-			$this->app['former']->ids[] = $id;
-		}
-	}
-
-	/**
-	 * Get an unique ID for a field from its name
-	 *
-	 * @param string $name
-	 *
-	 * @return string
-	 */
-	protected function getUniqueId($name)
-	{
-		$names = &$this->app['former']->names;
-
-		if (array_key_exists($name, $names)) {
-			$count = $names[$name] + 1;
-			$names[$name] = $count;
-			return $name.'-'.$count;
-		}
-
-		$names[$name] = 1;
-		return $name;
-	}
-
-	/**
-	 * Render the FormerObject and set its id
-	 *
-	 * @return string
-	 */
-	public function render()
-	{
-		// Set the proper ID according to the label
-		$this->setId();
-
-		// Encode HTML value
-		$isButton = ($this instanceof Field) ? $this->isButton() : false;
-		if (!$isButton and is_string($this->value)) {
-			$this->value = Helpers::encode($this->value);
-		}
-
-		return parent::render();
-	}
-
-	////////////////////////////////////////////////////////////////////
-	////////////////////////////// GETTERS /////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Get the object's name
-	 *
-	 * @return string
-	 */
-	public function getName()
-	{
-		return $this->name;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////////// OBJECT TYPE ///////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Get the object's type
-	 *
-	 * @return string
-	 */
-	public function getType()
-	{
-		return $this->type;
-	}
-
-	/**
-	 * Change a object's type
-	 *
-	 * @param string $type
-	 */
-	public function setType($type)
-	{
-		$this->type = $type;
-
-		return $this;
-	}
-
-	/**
-	 * Check if an object is of a certain type
-	 *
-	 * @return boolean
-	 */
-	public function isOfType()
-	{
-		$types = func_get_args();
-
-		return in_array($this->type, $types);
-	}
+    /**
+     * The field's name
+     *
+     * @var string
+     */
+    protected $name;
+
+    /**
+     * The field type
+     *
+     * @var string
+     */
+    protected $type;
+
+    /**
+     * A list of class properties to be added to attributes
+     *
+     * @var array
+     */
+    protected $injectedProperties = array('name');
+
+    ////////////////////////////////////////////////////////////////////
+    /////////////////////////// ID AND LABELS //////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Create an unique ID and return it
+     *
+     * @return string
+     */
+    public function getCreatedId()
+    {
+        $this->setId();
+
+        return $this->attributes['id'];
+    }
+
+    /**
+     * Set the matching ID on a field if possible
+     */
+    protected function setId()
+    {
+        if (!array_key_exists('id', $this->attributes) and
+            in_array($this->name, $this->app['former']->labels)
+        ) {
+            // Set and save the field's ID
+            $id                         = $this->getUniqueId($this->name);
+            $this->attributes['id']     = $id;
+            $this->app['former']->ids[] = $id;
+        }
+    }
+
+    /**
+     * Get an unique ID for a field from its name
+     *
+     * @param string $name
+     *
+     * @return string
+     */
+    protected function getUniqueId($name)
+    {
+        $names = &$this->app['former']->names;
+
+        if (array_key_exists($name, $names)) {
+            $count = $names[$name] + 1;
+            $names[$name] = $count;
+            return $name.'-'.$count;
+        }
+
+        $names[$name] = 1;
+        return $name;
+    }
+
+    /**
+     * Render the FormerObject and set its id
+     *
+     * @return string
+     */
+    public function render()
+    {
+        // Set the proper ID according to the label
+        $this->setId();
+
+        // Encode HTML value
+        $isButton = ($this instanceof Field) ? $this->isButton() : false;
+        if (!$isButton and is_string($this->value)) {
+            $this->value = Helpers::encode($this->value);
+        }
+
+        return parent::render();
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ////////////////////////////// GETTERS /////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Get the object's name
+     *
+     * @return string
+     */
+    public function getName()
+    {
+        return $this->name;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////////// OBJECT TYPE ///////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Get the object's type
+     *
+     * @return string
+     */
+    public function getType()
+    {
+        return $this->type;
+    }
+
+    /**
+     * Change a object's type
+     *
+     * @param string $type
+     */
+    public function setType($type)
+    {
+        $this->type = $type;
+
+        return $this;
+    }
+
+    /**
+     * Check if an object is of a certain type
+     *
+     * @return boolean
+     */
+    public function isOfType()
+    {
+        $types = func_get_args();
+
+        return in_array($this->type, $types);
+    }
 }

src/Former/Form/Actions.php

Indentation +106 added lines, -106 removed lines

@@ -11,110 +11,110 @@
  */
 class Actions extends FormerObject
 {
-	/**
-	 * The Container
-	 *
-	 * @var Container
-	 */
-	protected $app;
-
-	/**
-	 * The Actions element
-	 *
-	 * @var string
-	 */
-	protected $element = 'div';
-
-	////////////////////////////////////////////////////////////////////
-	/////////////////////////// CORE METHODS ///////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Constructs a new Actions block
-	 *
-	 * @param Container $app
-	 * @param array     $value The block content
-	 */
-	public function __construct(Container $app, $value)
-	{
-		$this->app   = $app;
-		$this->value = $value;
-
-		// Add specific actions classes to the actions block
-		$this->addClass($this->app['former.framework']->getActionClasses());
-	}
-
-	/**
-	 * Get the content of the Actions block
-	 *
-	 * @return string
-	 */
-	public function getContent()
-	{
-		$content = array_map(function($content) {
-			return method_exists($content, '__toString') ? (string) $content : $content;
-		}, $this->value);
-
-		return $this->app['former.framework']->wrapActions(implode(' ', $content));
-	}
-
-	/**
-	 * Dynamically append actions to the block
-	 *
-	 * @param string $method     The method
-	 * @param array  $parameters Its parameters
-	 *
-	 * @return Actions
-	 */
-	public function __call($method, $parameters)
-	{
-		// Dynamically add buttons to an actions block
-		if ($this->isButtonMethod($method)) {
-			$text       = array_get($parameters, 0);
-			$link       = array_get($parameters, 1);
-			$attributes = array_get($parameters, 2);
-			if (!$attributes and is_array($link)) {
-				$attributes = $link;
-			}
-
-			return $this->createButtonOfType($method, $text, $link, $attributes);
-		}
-
-		return parent::__call($method, $parameters);
-	}
-
-	////////////////////////////////////////////////////////////////////
-	////////////////////////////// HELPERS /////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Create a new Button and add it to the actions
-	 *
-	 * @param string $type       The button type
-	 * @param string $name       Its name
-	 * @param string $link       A link to point to
-	 * @param array  $attributes Its attributes
-	 *
-	 * @return Actions
-	 */
-	private function createButtonOfType($type, $name, $link, $attributes)
-	{
-		$this->value[] = $this->app['former']->$type($name, $link, $attributes)->__toString();
-
-		return $this;
-	}
-
-	/**
-	 * Check if a given method calls a button or not
-	 *
-	 * @param string $method The method to check
-	 *
-	 * @return boolean
-	 */
-	private function isButtonMethod($method)
-	{
-		$buttons = array('button', 'submit', 'link', 'reset');
-
-		return (bool) Str::contains($method, $buttons);
-	}
+    /**
+     * The Container
+     *
+     * @var Container
+     */
+    protected $app;
+
+    /**
+     * The Actions element
+     *
+     * @var string
+     */
+    protected $element = 'div';
+
+    ////////////////////////////////////////////////////////////////////
+    /////////////////////////// CORE METHODS ///////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Constructs a new Actions block
+     *
+     * @param Container $app
+     * @param array     $value The block content
+     */
+    public function __construct(Container $app, $value)
+    {
+        $this->app   = $app;
+        $this->value = $value;
+
+        // Add specific actions classes to the actions block
+        $this->addClass($this->app['former.framework']->getActionClasses());
+    }
+
+    /**
+     * Get the content of the Actions block
+     *
+     * @return string
+     */
+    public function getContent()
+    {
+        $content = array_map(function($content) {
+            return method_exists($content, '__toString') ? (string) $content : $content;
+        }, $this->value);
+
+        return $this->app['former.framework']->wrapActions(implode(' ', $content));
+    }
+
+    /**
+     * Dynamically append actions to the block
+     *
+     * @param string $method     The method
+     * @param array  $parameters Its parameters
+     *
+     * @return Actions
+     */
+    public function __call($method, $parameters)
+    {
+        // Dynamically add buttons to an actions block
+        if ($this->isButtonMethod($method)) {
+            $text       = array_get($parameters, 0);
+            $link       = array_get($parameters, 1);
+            $attributes = array_get($parameters, 2);
+            if (!$attributes and is_array($link)) {
+                $attributes = $link;
+            }
+
+            return $this->createButtonOfType($method, $text, $link, $attributes);
+        }
+
+        return parent::__call($method, $parameters);
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ////////////////////////////// HELPERS /////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Create a new Button and add it to the actions
+     *
+     * @param string $type       The button type
+     * @param string $name       Its name
+     * @param string $link       A link to point to
+     * @param array  $attributes Its attributes
+     *
+     * @return Actions
+     */
+    private function createButtonOfType($type, $name, $link, $attributes)
+    {
+        $this->value[] = $this->app['former']->$type($name, $link, $attributes)->__toString();
+
+        return $this;
+    }
+
+    /**
+     * Check if a given method calls a button or not
+     *
+     * @param string $method The method to check
+     *
+     * @return boolean
+     */
+    private function isButtonMethod($method)
+    {
+        $buttons = array('button', 'submit', 'link', 'reset');
+
+        return (bool) Str::contains($method, $buttons);
+    }
 }

src/Former/Form/Group.php

Indentation +457 added lines, -457 removed lines

@@ -12,461 +12,461 @@
  */
 class Group extends Tag
 {
-	/**
-	 * The Container
-	 *
-	 * @var Container
-	 */
-	protected $app;
-
-	/**
-	 * The current state of the group
-	 *
-	 * @var string
-	 */
-	protected $state = null;
-
-	/**
-	 * Whether the field should be displayed raw or not
-	 *
-	 * @var boolean
-	 */
-	protected $raw = false;
-
-	/**
-	 * The group label
-	 *
-	 * @var Element
-	 */
-	protected $label;
-
-	/**
-	 * The group help
-	 *
-	 * @var array
-	 */
-	protected $help = array();
-
-	/**
-	 * An array of elements to preprend the field
-	 *
-	 * @var array
-	 */
-	protected $prepend = array();
-
-	/**
-	 * An array of elements to append the field
-	 *
-	 * @var array
-	 */
-	protected $append = array();
-
-	/**
-	 * The field validations to be checked for errors
-	 *
-	 * @var array
-	 */
-	protected $validations = array();
-
-	/**
-	 * The group's element
-	 *
-	 * @var string
-	 */
-	protected $element = 'div';
-
-	/**
-	 * Whether a custom group is opened or not
-	 *
-	 * @var boolean
-	 */
-	public static $opened = false;
-
-	/**
-	 * The custom group that is open
-	 *
-	 * @var Former\Form\Group
-	 */
-	public static $openGroup = null;
-
-	////////////////////////////////////////////////////////////////////
-	/////////////////////////// CORE METHODS ///////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Creates a group
-	 *
-	 * @param string $label Its label
-	 */
-	public function __construct(Container $app, $label, $validations = null)
-	{
-		// Get special classes
-		$this->app = $app;
-		$this->addClass($this->app['former.framework']->getGroupClasses());
-
-		// Invisible if Nude
-		if ($this->app['former.framework']->is('Nude')) {
-			$this->element = '';
-		}
-
-		// Set group label
-		if ($label) {
-			$this->setLabel($label);
-		}
-
-		// Set validations used to override groups own conclusions
-		$this->validations = (array) $validations;
-	}
-
-	/**
-	 * Prints out the opening of the Control Group
-	 *
-	 * @return string A control group opening tag
-	 */
-	public function __toString()
-	{
-		return $this->open().$this->getFormattedLabel();
-	}
-
-	/**
-	 * Opens a group
-	 *
-	 * @return string Opening tag
-	 */
-	public function open()
-	{
-		if ($this->getErrors()) {
-			$this->state($this->app['former.framework']->errorState());
-		}
-
-		// Retrieve state and append it to classes
-		if ($this->state) {
-			$this->addClass($this->state);
-		}
-
-		// Required state
-		if ($this->app->bound('former.field') and $this->app['former.field']->isRequired()) {
-			$this->addClass($this->app['former']->getOption('required_class'));
-		}
-
-		return parent::open();
-	}
-
-	/**
-	 * Set the contents of the current group
-	 *
-	 * @param string $contents The group contents
-	 *
-	 * @return string A group
-	 */
-	public function contents($contents)
-	{
-		return $this->wrap($contents, $this->getFormattedLabel());
-	}
-
-	/**
-	 * Wrap a Field with the current group
-	 *
-	 * @param  \Former\Traits\Field $field A Field instance
-	 *
-	 * @return string        A group
-	 */
-	public function wrapField($field)
-	{
-		$label = $this->getLabel($field);
-		$field = $this->prependAppend($field);
-		$field .= $this->getHelp();
-
-		return $this->wrap($field, $label);
-	}
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////////// FIELD METHODS /////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Set the state of the group
-	 *
-	 * @param  string $state A Bootstrap state class
-	 */
-	public function state($state)
-	{
-		// Filter state
-		$state = $this->app['former.framework']->filterState($state);
-
-		$this->state = $state;
-	}
-
-	/**
-	 * Set a class on the Group
-	 *
-	 * @param string $class The class to add
-	 */
-	public function addGroupClass($class)
-	{
-		$this->addClass($class);
-	}
-
-	/**
-	 * Adds a label to the group
-	 *
-	 * @param  string $label A label
-	 */
-	public function setLabel($label)
-	{
-		if (!$label instanceof Element) {
-			$label = Helpers::translate($label);
-			$label = Element::create('label', $label)->for($label);
-		}
-
-		$this->label = $label;
-	}
-
-	/**
-	 * Get the formatted group label
-	 *
-	 * @return string|null
-	 */
-	public function getFormattedLabel()
-	{
-		if (!$this->label) {
-			return false;
-		}
-
-		return $this->label->addClass($this->app['former.framework']->getLabelClasses());
-	}
-
-	/**
-	 * Disables the control group for the current field
-	 */
-	public function raw()
-	{
-		$this->raw = true;
-	}
-
-	/**
-	 * Check if the current group is to be displayed or not
-	 *
-	 * @return boolean
-	 */
-	public function isRaw()
-	{
-		return (bool) $this->raw;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	///////////////////////////// HELP BLOCKS //////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Alias for inlineHelp
-	 *
-	 * @param  string $help       The help text
-	 * @param  array  $attributes Facultative attributes
-	 */
-	public function help($help, $attributes = array())
-	{
-		return $this->inlineHelp($help, $attributes);
-	}
-
-	/**
-	 * Add an inline help
-	 *
-	 * @param  string $help       The help text
-	 * @param  array  $attributes Facultative attributes
-	 */
-	public function inlineHelp($help, $attributes = array())
-	{
-		// If no help text, do nothing
-		if (!$help) {
-			return false;
-		}
-
-		$this->help['inline'] = $this->app['former.framework']->createHelp($help, $attributes);
-	}
-
-	/**
-	 * Add an block help
-	 *
-	 * @param  string $help       The help text
-	 * @param  array  $attributes Facultative attributes
-	 */
-	public function blockHelp($help, $attributes = array())
-	{
-		// Reserved method
-		if ($this->app['former.framework']->isnt('TwitterBootstrap') && $this->app['former.framework']->isnt('TwitterBootstrap3')) {
-			throw new BadMethodCallException('This method is only available on the Bootstrap framework');
-		}
-
-		// If no help text, do nothing
-		if (!$help) {
-			return false;
-		}
-
-		$this->help['block'] = $this->app['former.framework']->createBlockHelp($help, $attributes);
-	}
-
-	////////////////////////////////////////////////////////////////////
-	///////////////////////// PREPEND/APPEND METHODS ///////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Prepend elements to the field
-	 */
-	public function prepend()
-	{
-		$this->placeAround(func_get_args(), 'prepend');
-	}
-
-	/**
-	 * Append elements to the field
-	 */
-	public function append()
-	{
-		$this->placeAround(func_get_args(), 'append');
-	}
-
-	/**
-	 * Prepends an icon to a field
-	 *
-	 * @param string $icon       The icon to prepend
-	 * @param array  $attributes Its attributes
-	 */
-	public function prependIcon($icon, $attributes = array(), $iconSettings = array())
-	{
-		$icon = $this->app['former.framework']->createIcon($icon, $attributes, $iconSettings);
-
-		$this->prepend($icon);
-	}
-
-	/**
-	 * Append an icon to a field
-	 *
-	 * @param string $icon       The icon to prepend
-	 * @param array  $attributes Its attributes
-	 */
-	public function appendIcon($icon, $attributes = array(), $iconSettings = array())
-	{
-		$icon = $this->app['former.framework']->createIcon($icon, $attributes, $iconSettings);
-
-		$this->append($icon);
-	}
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////////////// HELPERS ///////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Get the errors for the group
-	 *
-	 * @return string
-	 */
-	public function getErrors()
-	{
-		$errors = '';
-
-		if (!self::$opened) {
-
-			// for non-custom groups, normal error handling applies
-			$errors = $this->app['former']->getErrors();
-		} elseif (!empty($this->validations)) {
-
-			// error handling only when validations specified for custom groups
-			foreach ($this->validations as $validation) {
-				$errors .= $this->app['former']->getErrors($validation);
-			}
-		}
-
-		return $errors;
-	}
-
-	/**
-	 * Wraps content in a group
-	 *
-	 * @param string $contents The content
-	 * @param string $label    The label to add
-	 *
-	 * @return string A group
-	 */
-	public function wrap($contents, $label = null)
-	{
-		$group = $this->open();
-		$group .= $label;
-		$group .= $this->app['former.framework']->wrapField($contents);
-		$group .= $this->close();
-
-		return $group;
-	}
-
-	/**
-	 * Prints out the current label
-	 *
-	 * @param  string $field The field to create a label for
-	 *
-	 * @return string        A <label> tag
-	 */
-	protected function getLabel($field = null)
-	{
-		// Don't create a label if none exist
-		if (!$field or !$this->label) {
-			return null;
-		}
-
-		// Wrap label in framework classes
-		$this->label->addClass($this->app['former.framework']->getLabelClasses());
-		$this->label = $this->app['former.framework']->createLabelOf($field, $this->label);
-		$this->label = $this->app['former.framework']->wrapLabel($this->label);
-
-		return $this->label;
-	}
-
-	/**
-	 * Prints out the current help
-	 *
-	 * @return string A .help-block or .help-inline
-	 */
-	protected function getHelp()
-	{
-		$inline = array_get($this->help, 'inline');
-		$block  = array_get($this->help, 'block');
-
-		// Replace help text with error if any found
-		$errors = $this->app['former']->getErrors();
-		if ($errors and $this->app['former']->getOption('error_messages')) {
-			$inline = $this->app['former.framework']->createHelp($errors);
-		}
-
-		return join(null, array($inline, $block));
-	}
-
-	/**
-	 * Format the field with prepended/appended elements
-	 *
-	 * @param  \Former\Traits\Field $field The field to format
-	 *
-	 * @return string        Field plus supplementary elements
-	 */
-	protected function prependAppend($field)
-	{
-		if (!$this->prepend and !$this->append) {
-			return $field->render();
-		}
-
-		return $this->app['former.framework']->prependAppend($field, $this->prepend, $this->append);
-	}
-
-	/**
-	 * Place elements around the field
-	 *
-	 * @param  array  $items An array of items to place
-	 * @param  string $place Where they should end up (prepend|append)
-	 */
-	protected function placeAround($items, $place)
-	{
-		// Iterate over the items and place them where they should
-		foreach ((array) $items as $item) {
-			$item             = $this->app['former.framework']->placeAround($item);
-			$this->{$place}[] = $item;
-		}
-	}
+    /**
+     * The Container
+     *
+     * @var Container
+     */
+    protected $app;
+
+    /**
+     * The current state of the group
+     *
+     * @var string
+     */
+    protected $state = null;
+
+    /**
+     * Whether the field should be displayed raw or not
+     *
+     * @var boolean
+     */
+    protected $raw = false;
+
+    /**
+     * The group label
+     *
+     * @var Element
+     */
+    protected $label;
+
+    /**
+     * The group help
+     *
+     * @var array
+     */
+    protected $help = array();
+
+    /**
+     * An array of elements to preprend the field
+     *
+     * @var array
+     */
+    protected $prepend = array();
+
+    /**
+     * An array of elements to append the field
+     *
+     * @var array
+     */
+    protected $append = array();
+
+    /**
+     * The field validations to be checked for errors
+     *
+     * @var array
+     */
+    protected $validations = array();
+
+    /**
+     * The group's element
+     *
+     * @var string
+     */
+    protected $element = 'div';
+
+    /**
+     * Whether a custom group is opened or not
+     *
+     * @var boolean
+     */
+    public static $opened = false;
+
+    /**
+     * The custom group that is open
+     *
+     * @var Former\Form\Group
+     */
+    public static $openGroup = null;
+
+    ////////////////////////////////////////////////////////////////////
+    /////////////////////////// CORE METHODS ///////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Creates a group
+     *
+     * @param string $label Its label
+     */
+    public function __construct(Container $app, $label, $validations = null)
+    {
+        // Get special classes
+        $this->app = $app;
+        $this->addClass($this->app['former.framework']->getGroupClasses());
+
+        // Invisible if Nude
+        if ($this->app['former.framework']->is('Nude')) {
+            $this->element = '';
+        }
+
+        // Set group label
+        if ($label) {
+            $this->setLabel($label);
+        }
+
+        // Set validations used to override groups own conclusions
+        $this->validations = (array) $validations;
+    }
+
+    /**
+     * Prints out the opening of the Control Group
+     *
+     * @return string A control group opening tag
+     */
+    public function __toString()
+    {
+        return $this->open().$this->getFormattedLabel();
+    }
+
+    /**
+     * Opens a group
+     *
+     * @return string Opening tag
+     */
+    public function open()
+    {
+        if ($this->getErrors()) {
+            $this->state($this->app['former.framework']->errorState());
+        }
+
+        // Retrieve state and append it to classes
+        if ($this->state) {
+            $this->addClass($this->state);
+        }
+
+        // Required state
+        if ($this->app->bound('former.field') and $this->app['former.field']->isRequired()) {
+            $this->addClass($this->app['former']->getOption('required_class'));
+        }
+
+        return parent::open();
+    }
+
+    /**
+     * Set the contents of the current group
+     *
+     * @param string $contents The group contents
+     *
+     * @return string A group
+     */
+    public function contents($contents)
+    {
+        return $this->wrap($contents, $this->getFormattedLabel());
+    }
+
+    /**
+     * Wrap a Field with the current group
+     *
+     * @param  \Former\Traits\Field $field A Field instance
+     *
+     * @return string        A group
+     */
+    public function wrapField($field)
+    {
+        $label = $this->getLabel($field);
+        $field = $this->prependAppend($field);
+        $field .= $this->getHelp();
+
+        return $this->wrap($field, $label);
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////////// FIELD METHODS /////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Set the state of the group
+     *
+     * @param  string $state A Bootstrap state class
+     */
+    public function state($state)
+    {
+        // Filter state
+        $state = $this->app['former.framework']->filterState($state);
+
+        $this->state = $state;
+    }
+
+    /**
+     * Set a class on the Group
+     *
+     * @param string $class The class to add
+     */
+    public function addGroupClass($class)
+    {
+        $this->addClass($class);
+    }
+
+    /**
+     * Adds a label to the group
+     *
+     * @param  string $label A label
+     */
+    public function setLabel($label)
+    {
+        if (!$label instanceof Element) {
+            $label = Helpers::translate($label);
+            $label = Element::create('label', $label)->for($label);
+        }
+
+        $this->label = $label;
+    }
+
+    /**
+     * Get the formatted group label
+     *
+     * @return string|null
+     */
+    public function getFormattedLabel()
+    {
+        if (!$this->label) {
+            return false;
+        }
+
+        return $this->label->addClass($this->app['former.framework']->getLabelClasses());
+    }
+
+    /**
+     * Disables the control group for the current field
+     */
+    public function raw()
+    {
+        $this->raw = true;
+    }
+
+    /**
+     * Check if the current group is to be displayed or not
+     *
+     * @return boolean
+     */
+    public function isRaw()
+    {
+        return (bool) $this->raw;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ///////////////////////////// HELP BLOCKS //////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Alias for inlineHelp
+     *
+     * @param  string $help       The help text
+     * @param  array  $attributes Facultative attributes
+     */
+    public function help($help, $attributes = array())
+    {
+        return $this->inlineHelp($help, $attributes);
+    }
+
+    /**
+     * Add an inline help
+     *
+     * @param  string $help       The help text
+     * @param  array  $attributes Facultative attributes
+     */
+    public function inlineHelp($help, $attributes = array())
+    {
+        // If no help text, do nothing
+        if (!$help) {
+            return false;
+        }
+
+        $this->help['inline'] = $this->app['former.framework']->createHelp($help, $attributes);
+    }
+
+    /**
+     * Add an block help
+     *
+     * @param  string $help       The help text
+     * @param  array  $attributes Facultative attributes
+     */
+    public function blockHelp($help, $attributes = array())
+    {
+        // Reserved method
+        if ($this->app['former.framework']->isnt('TwitterBootstrap') && $this->app['former.framework']->isnt('TwitterBootstrap3')) {
+            throw new BadMethodCallException('This method is only available on the Bootstrap framework');
+        }
+
+        // If no help text, do nothing
+        if (!$help) {
+            return false;
+        }
+
+        $this->help['block'] = $this->app['former.framework']->createBlockHelp($help, $attributes);
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ///////////////////////// PREPEND/APPEND METHODS ///////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Prepend elements to the field
+     */
+    public function prepend()
+    {
+        $this->placeAround(func_get_args(), 'prepend');
+    }
+
+    /**
+     * Append elements to the field
+     */
+    public function append()
+    {
+        $this->placeAround(func_get_args(), 'append');
+    }
+
+    /**
+     * Prepends an icon to a field
+     *
+     * @param string $icon       The icon to prepend
+     * @param array  $attributes Its attributes
+     */
+    public function prependIcon($icon, $attributes = array(), $iconSettings = array())
+    {
+        $icon = $this->app['former.framework']->createIcon($icon, $attributes, $iconSettings);
+
+        $this->prepend($icon);
+    }
+
+    /**
+     * Append an icon to a field
+     *
+     * @param string $icon       The icon to prepend
+     * @param array  $attributes Its attributes
+     */
+    public function appendIcon($icon, $attributes = array(), $iconSettings = array())
+    {
+        $icon = $this->app['former.framework']->createIcon($icon, $attributes, $iconSettings);
+
+        $this->append($icon);
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////////////// HELPERS ///////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Get the errors for the group
+     *
+     * @return string
+     */
+    public function getErrors()
+    {
+        $errors = '';
+
+        if (!self::$opened) {
+
+            // for non-custom groups, normal error handling applies
+            $errors = $this->app['former']->getErrors();
+        } elseif (!empty($this->validations)) {
+
+            // error handling only when validations specified for custom groups
+            foreach ($this->validations as $validation) {
+                $errors .= $this->app['former']->getErrors($validation);
+            }
+        }
+
+        return $errors;
+    }
+
+    /**
+     * Wraps content in a group
+     *
+     * @param string $contents The content
+     * @param string $label    The label to add
+     *
+     * @return string A group
+     */
+    public function wrap($contents, $label = null)
+    {
+        $group = $this->open();
+        $group .= $label;
+        $group .= $this->app['former.framework']->wrapField($contents);
+        $group .= $this->close();
+
+        return $group;
+    }
+
+    /**
+     * Prints out the current label
+     *
+     * @param  string $field The field to create a label for
+     *
+     * @return string        A <label> tag
+     */
+    protected function getLabel($field = null)
+    {
+        // Don't create a label if none exist
+        if (!$field or !$this->label) {
+            return null;
+        }
+
+        // Wrap label in framework classes
+        $this->label->addClass($this->app['former.framework']->getLabelClasses());
+        $this->label = $this->app['former.framework']->createLabelOf($field, $this->label);
+        $this->label = $this->app['former.framework']->wrapLabel($this->label);
+
+        return $this->label;
+    }
+
+    /**
+     * Prints out the current help
+     *
+     * @return string A .help-block or .help-inline
+     */
+    protected function getHelp()
+    {
+        $inline = array_get($this->help, 'inline');
+        $block  = array_get($this->help, 'block');
+
+        // Replace help text with error if any found
+        $errors = $this->app['former']->getErrors();
+        if ($errors and $this->app['former']->getOption('error_messages')) {
+            $inline = $this->app['former.framework']->createHelp($errors);
+        }
+
+        return join(null, array($inline, $block));
+    }
+
+    /**
+     * Format the field with prepended/appended elements
+     *
+     * @param  \Former\Traits\Field $field The field to format
+     *
+     * @return string        Field plus supplementary elements
+     */
+    protected function prependAppend($field)
+    {
+        if (!$this->prepend and !$this->append) {
+            return $field->render();
+        }
+
+        return $this->app['former.framework']->prependAppend($field, $this->prepend, $this->append);
+    }
+
+    /**
+     * Place elements around the field
+     *
+     * @param  array  $items An array of items to place
+     * @param  string $place Where they should end up (prepend|append)
+     */
+    protected function placeAround($items, $place)
+    {
+        // Iterate over the items and place them where they should
+        foreach ((array) $items as $item) {
+            $item             = $this->app['former.framework']->placeAround($item);
+            $this->{$place}[] = $item;
+        }
+    }
 }

src/Former/Form/Form.php

Indentation +403 added lines, -403 removed lines

@@ -11,407 +11,407 @@
  */
 class Form extends FormerObject
 {
-	/**
-	 * The IoC Container
-	 *
-	 * @var Container
-	 */
-	protected $app;
-
-	/**
-	 * The URL generator
-	 *
-	 * @var UrlGenerator
-	 */
-	protected $url;
-
-	/**
-	 * The Populator
-	 *
-	 * @var Populator
-	 */
-	protected $populator;
-
-	/**
-	 * The Form type
-	 *
-	 * @var string
-	 */
-	protected $type = null;
-
-	/**
-	 * The destination of the current form
-	 *
-	 * @var string
-	 */
-	protected $action;
-
-	/**
-	 * The form method
-	 *
-	 * @var string
-	 */
-	protected $method;
-
-	/**
-	 * Whether the form should be secured or not
-	 *
-	 * @var boolean
-	 */
-	protected $secure;
-
-	/**
-	 * The form element
-	 *
-	 * @var string
-	 */
-	protected $element = 'form';
-
-	/**
-	 * A list of injected properties
-	 *
-	 * @var array
-	 */
-	protected $injectedProperties = array('method', 'action');
-
-	/**
-	 * Whether a form is opened or not
-	 *
-	 * @var boolean
-	 */
-	protected static $opened = false;
-
-	////////////////////////////////////////////////////////////////////
-	/////////////////////////// CORE METHODS ///////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Build a new Form instance
-	 *
-	 * @param UrlGenerator $url
-	 */
-	public function __construct(Container $app, $url, Populator $populator)
-	{
-		$this->app       = $app;
-		$this->url       = $url;
-		$this->populator = $populator;
-
-		$this->app->singleton('former.form.framework', function($app) {
-			return clone $app['former.framework'];
-		});
-	}
-
-	/**
-	 * Opens up magically a form
-	 *
-	 * @param  string $type       The form type asked
-	 * @param  array  $parameters Parameters passed
-	 *
-	 * @return Form             A form opening tag
-	 */
-	public function openForm($type, $parameters)
-	{
-		$action     = array_get($parameters, 0);
-		$method     = array_get($parameters, 1, 'POST');
-		$attributes = array_get($parameters, 2, array());
-		$secure     = array_get($parameters, 3, null);
-
-		// Fetch errors if asked for
-		if ($this->app['former']->getOption('fetch_errors')) {
-			$this->app['former']->withErrors();
-		}
-
-		// Open the form
-		$this->action($action);
-		$this->attributes = $attributes;
-		$this->method     = strtoupper($method);
-		$this->secure     = $secure;
-
-		// Add any effect of the form type
-		$type       = Str::snake($type);
-		$this->type = $this->applyType($type);
-
-		// Add enctype
-		if (!array_key_exists('accept-charset', $attributes)) {
-			$this->attributes['accept-charset'] = 'utf-8';
-		}
-
-		// Add supplementary classes
-		if ($this->type !== 'raw') {
-			$this->addClass($this->app['former.form.framework']->getFormClasses($this->type));
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Closes a Form
-	 *
-	 * @return string A closing <form> tag
-	 */
-	public function close()
-	{
-		static::$opened = false;
-
-		// Add token if necessary
-		$closing = '</form>';
-		if ($this->method != 'GET') {
-			$closing = $this->app['former']->token().$closing;
-		}
-
-		return $closing;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	//////////////////////////// STATIC HELPERS ////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Whether a form is currently opened or not
-	 *
-	 * @return boolean
-	 */
-	public static function hasInstanceOpened()
-	{
-		return static::$opened;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	/////////////////////////////// SETTER /////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Change the form's action
-	 *
-	 * @param  string $action The new action
-	 *
-	 * @return $this
-	 */
-	public function action($action)
-	{
-		$this->action = $action ? $this->url->to($action, array(), $this->secure) : null;
-
-		return $this;
-	}
-
-	/**
-	 * Change the form's method
-	 *
-	 * @param  string $method The method to use
-	 *
-	 * @return $this
-	 */
-	public function method($method)
-	{
-		$this->method = strtoupper($method);
-
-		return $this;
-	}
-
-	/**
-	 * Whether the form should be secure
-	 *
-	 * @param  boolean $secure Secure or not
-	 *
-	 * @return $this
-	 */
-	public function secure($secure = true)
-	{
-		$this->secure = $secure;
-
-		return $this;
-	}
-
-	/**
-	 * Change the form's action and method to a route
-	 *
-	 * @param  string $name   The name of the route to use
-	 * @param  array  $params Any route parameters
-	 *
-	 * @return Form
-	 */
-	public function route($name, $params = array())
-	{
-		return $this->setRouteOrAction($name, $params, 'route');
-	}
-
-	/**
-	 * Change the form's action to a controller method
-	 *
-	 * @param  string $name   The controller and method
-	 * @param  array  $params Any method parameters
-	 *
-	 * @return Form
-	 */
-	public function controller($name, $params = array())
-	{
-		return $this->setRouteOrAction($name, $params, 'action');
-	}
-
-	/**
-	 * Outputs the current form opened
-	 *
-	 * @return string A <form> opening tag
-	 */
-	public function __toString()
-	{
-		// Mark the form as opened
-		static::$opened = true;
-
-		// Add name to attributes
-		$this->attributes['name'] = $this->name;
-
-		// Add spoof method
-		if (in_array($this->method, array('PUT', 'PATCH', 'DELETE'))) {
-			$spoof        = $this->app['former']->hidden('_method', $this->method);
-			$this->method = 'POST';
-		} else {
-			$spoof = null;
-		}
-
-		return $this->open().$spoof;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	////////////////////////// PUBLIC HELPERS //////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Alias for $this->app['former']->withRules
-	 */
-	public function rules()
-	{
-		call_user_func_array(array($this->app['former'], 'withRules'), func_get_args());
-
-		return $this;
-	}
-
-	/**
-	 * Populate a form with specific values
-	 *
-	 * @param array|object $values
-	 *
-	 * @return $this
-	 */
-	public function populate($values)
-	{
-		$this->populator->replace($values);
-
-		return $this;
-	}
-
-	/**
-	 * Get the Populator binded to the Form
-	 *
-	 * @return Populator
-	 */
-	public function getPopulator()
-	{
-		return $this->populator;
-	}
-
-	////////////////////////////////////////////////////////////////////
-	////////////////////////////// HELPERS /////////////////////////////
-	////////////////////////////////////////////////////////////////////
-
-	/**
-	 * Find the method of a route by its _uses or name
-	 *
-	 * @param  string $name
-	 *
-	 * @return string
-	 */
-	protected function findRouteMethod($name)
-	{
-		if (!$this->app->bound('router')) {
-			return;
-		}
-
-		// Get string by name
-		if (!Str::contains($name, '@')) {
-			$routes = $this->app['router']->getRoutes();
-			$route  = method_exists($routes, 'getByName') ? $routes->getByName($name) : $routes->get($name);
-			// Get string by uses
-		} else {
-			foreach ($this->app['router']->getRoutes() as $route) {
-				$routeUses = method_exists($route, 'getOption') ? $route->getOption('_uses') : array_get($route->getAction(), 'controller');
-				if ($action = $routeUses) {
-					if ($action == $name) {
-						break;
-					}
-				}
-			}
-		}
-
-		// Get method
-		$methods = method_exists($route, 'getMethods') ? $route->getMethods() : $route->methods();
-		$method  = array_get($methods, 0);
-
-		return $method;
-	}
-
-	/**
-	 * @param string $name
-	 * @param $params
-	 * @param string $type
-	 *
-	 * @return $this
-	 */
-	protected function setRouteOrAction($name, $params, $type)
-	{
-		// Set the form action
-		$this->action = $this->url->$type($name, $params);
-
-		// Set the proper method
-		if ($method = $this->findRouteMethod($name)) {
-			$this->method($method);
-		}
-
-		return $this;
-	}
-
-	/**
-	 * Apply various parameters according to form type
-	 *
-	 * @param  string $type The original form type provided
-	 *
-	 * @return string The final form type
-	 */
-	private function applyType($type)
-	{
-		// If classic form
-		if ($type == 'open') {
-			return $this->app['former']->getOption('default_form_type');
-		}
-
-		// Look for HTTPS form
-		if (Str::contains($type, 'secure')) {
-			$type         = str_replace('secure', '', $type);
-			$this->secure = true;
-		}
-
-		// Look for file form
-		if (Str::contains($type, 'for_files')) {
-			$type                        = str_replace('for_files', '', $type);
-			$this->attributes['enctype'] = 'multipart/form-data';
-		}
-
-		// Calculate form type
-		$type = str_replace('open', '', $type);
-		$type = trim($type, '_');
-
-		// If raw form
-		if ($type == 'raw') {
-			$this->app->bind('former.form.framework', function($app) {
-				return $app['former']->getFrameworkInstance('Nude');
-			});
-		}
-
-		// Use default form type if the one provided is invalid
-		if ($type !== 'raw' and !in_array($type, $this->app['former.form.framework']->availableTypes())) {
-			$type = $this->app['former']->getOption('default_form_type');
-		}
-
-		return $type;
-	}
+    /**
+     * The IoC Container
+     *
+     * @var Container
+     */
+    protected $app;
+
+    /**
+     * The URL generator
+     *
+     * @var UrlGenerator
+     */
+    protected $url;
+
+    /**
+     * The Populator
+     *
+     * @var Populator
+     */
+    protected $populator;
+
+    /**
+     * The Form type
+     *
+     * @var string
+     */
+    protected $type = null;
+
+    /**
+     * The destination of the current form
+     *
+     * @var string
+     */
+    protected $action;
+
+    /**
+     * The form method
+     *
+     * @var string
+     */
+    protected $method;
+
+    /**
+     * Whether the form should be secured or not
+     *
+     * @var boolean
+     */
+    protected $secure;
+
+    /**
+     * The form element
+     *
+     * @var string
+     */
+    protected $element = 'form';
+
+    /**
+     * A list of injected properties
+     *
+     * @var array
+     */
+    protected $injectedProperties = array('method', 'action');
+
+    /**
+     * Whether a form is opened or not
+     *
+     * @var boolean
+     */
+    protected static $opened = false;
+
+    ////////////////////////////////////////////////////////////////////
+    /////////////////////////// CORE METHODS ///////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Build a new Form instance
+     *
+     * @param UrlGenerator $url
+     */
+    public function __construct(Container $app, $url, Populator $populator)
+    {
+        $this->app       = $app;
+        $this->url       = $url;
+        $this->populator = $populator;
+
+        $this->app->singleton('former.form.framework', function($app) {
+            return clone $app['former.framework'];
+        });
+    }
+
+    /**
+     * Opens up magically a form
+     *
+     * @param  string $type       The form type asked
+     * @param  array  $parameters Parameters passed
+     *
+     * @return Form             A form opening tag
+     */
+    public function openForm($type, $parameters)
+    {
+        $action     = array_get($parameters, 0);
+        $method     = array_get($parameters, 1, 'POST');
+        $attributes = array_get($parameters, 2, array());
+        $secure     = array_get($parameters, 3, null);
+
+        // Fetch errors if asked for
+        if ($this->app['former']->getOption('fetch_errors')) {
+            $this->app['former']->withErrors();
+        }
+
+        // Open the form
+        $this->action($action);
+        $this->attributes = $attributes;
+        $this->method     = strtoupper($method);
+        $this->secure     = $secure;
+
+        // Add any effect of the form type
+        $type       = Str::snake($type);
+        $this->type = $this->applyType($type);
+
+        // Add enctype
+        if (!array_key_exists('accept-charset', $attributes)) {
+            $this->attributes['accept-charset'] = 'utf-8';
+        }
+
+        // Add supplementary classes
+        if ($this->type !== 'raw') {
+            $this->addClass($this->app['former.form.framework']->getFormClasses($this->type));
+        }
+
+        return $this;
+    }
+
+    /**
+     * Closes a Form
+     *
+     * @return string A closing <form> tag
+     */
+    public function close()
+    {
+        static::$opened = false;
+
+        // Add token if necessary
+        $closing = '</form>';
+        if ($this->method != 'GET') {
+            $closing = $this->app['former']->token().$closing;
+        }
+
+        return $closing;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    //////////////////////////// STATIC HELPERS ////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Whether a form is currently opened or not
+     *
+     * @return boolean
+     */
+    public static function hasInstanceOpened()
+    {
+        return static::$opened;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    /////////////////////////////// SETTER /////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Change the form's action
+     *
+     * @param  string $action The new action
+     *
+     * @return $this
+     */
+    public function action($action)
+    {
+        $this->action = $action ? $this->url->to($action, array(), $this->secure) : null;
+
+        return $this;
+    }
+
+    /**
+     * Change the form's method
+     *
+     * @param  string $method The method to use
+     *
+     * @return $this
+     */
+    public function method($method)
+    {
+        $this->method = strtoupper($method);
+
+        return $this;
+    }
+
+    /**
+     * Whether the form should be secure
+     *
+     * @param  boolean $secure Secure or not
+     *
+     * @return $this
+     */
+    public function secure($secure = true)
+    {
+        $this->secure = $secure;
+
+        return $this;
+    }
+
+    /**
+     * Change the form's action and method to a route
+     *
+     * @param  string $name   The name of the route to use
+     * @param  array  $params Any route parameters
+     *
+     * @return Form
+     */
+    public function route($name, $params = array())
+    {
+        return $this->setRouteOrAction($name, $params, 'route');
+    }
+
+    /**
+     * Change the form's action to a controller method
+     *
+     * @param  string $name   The controller and method
+     * @param  array  $params Any method parameters
+     *
+     * @return Form
+     */
+    public function controller($name, $params = array())
+    {
+        return $this->setRouteOrAction($name, $params, 'action');
+    }
+
+    /**
+     * Outputs the current form opened
+     *
+     * @return string A <form> opening tag
+     */
+    public function __toString()
+    {
+        // Mark the form as opened
+        static::$opened = true;
+
+        // Add name to attributes
+        $this->attributes['name'] = $this->name;
+
+        // Add spoof method
+        if (in_array($this->method, array('PUT', 'PATCH', 'DELETE'))) {
+            $spoof        = $this->app['former']->hidden('_method', $this->method);
+            $this->method = 'POST';
+        } else {
+            $spoof = null;
+        }
+
+        return $this->open().$spoof;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ////////////////////////// PUBLIC HELPERS //////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Alias for $this->app['former']->withRules
+     */
+    public function rules()
+    {
+        call_user_func_array(array($this->app['former'], 'withRules'), func_get_args());
+
+        return $this;
+    }
+
+    /**
+     * Populate a form with specific values
+     *
+     * @param array|object $values
+     *
+     * @return $this
+     */
+    public function populate($values)
+    {
+        $this->populator->replace($values);
+
+        return $this;
+    }
+
+    /**
+     * Get the Populator binded to the Form
+     *
+     * @return Populator
+     */
+    public function getPopulator()
+    {
+        return $this->populator;
+    }
+
+    ////////////////////////////////////////////////////////////////////
+    ////////////////////////////// HELPERS /////////////////////////////
+    ////////////////////////////////////////////////////////////////////
+
+    /**
+     * Find the method of a route by its _uses or name
+     *
+     * @param  string $name
+     *
+     * @return string
+     */
+    protected function findRouteMethod($name)
+    {
+        if (!$this->app->bound('router')) {
+            return;
+        }
+
+        // Get string by name
+        if (!Str::contains($name, '@')) {
+            $routes = $this->app['router']->getRoutes();
+            $route  = method_exists($routes, 'getByName') ? $routes->getByName($name) : $routes->get($name);
+            // Get string by uses
+        } else {
+            foreach ($this->app['router']->getRoutes() as $route) {
+                $routeUses = method_exists($route, 'getOption') ? $route->getOption('_uses') : array_get($route->getAction(), 'controller');
+                if ($action = $routeUses) {
+                    if ($action == $name) {
+                        break;
+                    }
+                }
+            }
+        }
+
+        // Get method
+        $methods = method_exists($route, 'getMethods') ? $route->getMethods() : $route->methods();
+        $method  = array_get($methods, 0);
+
+        return $method;
+    }
+
+    /**
+     * @param string $name
+     * @param $params
+     * @param string $type
+     *
+     * @return $this
+     */
+    protected function setRouteOrAction($name, $params, $type)
+    {
+        // Set the form action
+        $this->action = $this->url->$type($name, $params);
+
+        // Set the proper method
+        if ($method = $this->findRouteMethod($name)) {
+            $this->method($method);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Apply various parameters according to form type
+     *
+     * @param  string $type The original form type provided
+     *
+     * @return string The final form type
+     */
+    private function applyType($type)
+    {
+        // If classic form
+        if ($type == 'open') {
+            return $this->app['former']->getOption('default_form_type');
+        }
+
+        // Look for HTTPS form
+        if (Str::contains($type, 'secure')) {
+            $type         = str_replace('secure', '', $type);
+            $this->secure = true;
+        }
+
+        // Look for file form
+        if (Str::contains($type, 'for_files')) {
+            $type                        = str_replace('for_files', '', $type);
+            $this->attributes['enctype'] = 'multipart/form-data';
+        }
+
+        // Calculate form type
+        $type = str_replace('open', '', $type);
+        $type = trim($type, '_');
+
+        // If raw form
+        if ($type == 'raw') {
+            $this->app->bind('former.form.framework', function($app) {
+                return $app['former']->getFrameworkInstance('Nude');
+            });
+        }
+
+        // Use default form type if the one provided is invalid
+        if ($type !== 'raw' and !in_array($type, $this->app['former.form.framework']->availableTypes())) {
+            $type = $this->app['former']->getOption('default_form_type');
+        }
+
+        return $type;
+    }
 }