Form

The Form helper file contains functions that assist in working with form elements.

openForm

Open form tag.

form_helper::openForm('users/action'); // <form action="http://www.example.com/users/action" method="post">

openMultiForm

Open multitype form tag.

form_helper::openMultiForm('users/action'); // <form action="http://www.example.com/users/action" method="post" enctype="multipart/form-data">

closeForm

Close form tag.

form_helper::closeForm(); // </form>

text

Text input tag.

form_helper::text('first_name'); // <input type="text" name="first_name" value="" />
form_helper::text('first_name', 'John', array('style' => 'border:1px solid red')); // <input type="text" name="first_name" value="John" style="border:1px solid red" />

hidden

Hidden input tag.

form_helper::hidden('first_name'); // <input type="hidden" name="first_name" value="" />
form_helper::hidden('first_name', 'John'); // <input type="hidden" name="first_name" value="John" />

number

Number input tag.

form_helper::hidden('age'); // <input type="number" name="age" value="" />
form_helper::hidden('age', 50); // <input type="number" name="age" value="50" />

password

Password input tag.

form_helper::password('pass'); // <input type="password" name="pass" value="" />
form_helper::password('pass', 'sample', array('style' => 'border:1px solid red')); // <input type="password" name="pass" value="sample" style="border:1px solid red" />

upload

Upload input tag.

form_helper::upload('my_file'); // <input type="file" name="my_file" value="" />
form_helper::upload('my_file', '', array('id' => 'my_file')); // <input type="file" name="my_file" id="my_file" />

submit

Submit input tag.

form_helper::submit('continue'); // <input type="submit" name="continue" value="" />
form_helper::submit('continue', 'Next', array('style' => 'border:1px solid red')); // <input type="submit" name="continue" value="Next" style="border:1px solid red" />

checkbox

Checkbox tag.

form_helper::checkbox('color[]', 'Blue', true); // <input type="checkbox" checked="checked" name="color[]" value="Blue" />
form_helper::checkbox('color[]', 'Red'); // <input type="checkbox" name="color[]" value="Red" />
form_helper::checkbox('color[]', 'Black', false, array('id' => 'my_color')); // <input type="checkbox" name="color[]" value="Red" id="my_color" />

radio

Radio tag.

form_helper::radio('color', 'Blue', true); // <input type="radio" checked="checked" name="color" value="Blue" />
form_helper::radio('color', 'Red'); // <input type="radio" name="color" value="Red" />
form_helper::radio('color', 'Black', false, array('id' => 'my_color')); // <input type="radio" name="color" value="Red" id="my_color" />

select

Select tag.

form_helper::select('color', array('red' => 'Red', 'blue' => 'Blue', 'black' => 'Black'), 'black', array('id' => 'my_color'));
// <select id="my_color" name="color"><option value="red">Red</option><option value="blue">Blue</option><option value="black" selected="selected">Black</option></select>

textarea

Text area tag.

form_helper::textarea('about'); // <input type="text" name="about" value="" />
form_helper::textarea('about', 'About me', array('style' => 'border:1px solid red')); // <input type="text" name="about" value="About me" style="border:1px solid red" />

label

Label tag.

form_helper::label('color', 'Color'); // <label for="color">Color</label>

captcha

Display captcha element.

form_helper::captcha('my_captcha'); // display default system captcha

getTotalErrors

Get total number of errors if form validation was being performed.

form_helper::getTotalErrors();

error

Get field error message if any.

form_helper::error('first_name');

errors

Get form errors if any.

form_helper::errors();

setValue

Permits you to set the value of an input form or text area after it was submitted.

form_helper::text('first_name', form_helper::setValue('first_name', 'John')); // John is the default value

setSelect

Permits you to set the value of a select tag.

form_helper::select('color', array('red' => 'Red', 'black' => 'Black'), form_helper::setSelect('color', 'black'), array('id' => 'my_color')); // Black is the default value

setRadio

Permits you to set the value of a radio tags.

form_helper::radio('color', 'Red', form_helper::setRadio('color', 'red', 'black')); // tag value is 'red' but default value is 'black'

setCheckbox

Permits you to set the value of a checkbox tag.

form_helper::checkbox('color[red]', 'Red', form_helper::setCheckbox('color', 'red', array('black', 'blue'))); // 'red' is the tag value, 'black' and 'blue' are default checked values