Form API 3

Form APITil All Are One

1Thursday, September 20, 2007

The Olden Days

• HTML

• Helper Functions

• Duplicate Work

• Weak Security


Node Forms

Baby Jesus


Form API Basics

• Structured Data

• Workflow

• Best Practices

• Render to HTML


Form API Basicsfunction my_form() { $form = array();

$form['foo'] = array( '#type' => 'textarea', '#title' => t('Your foo'), ); $form['submit'] = array( '#type' => 'submit', '#value' => t('Submit yo foo'), );

return $form;}


Form API Basics


Behind The Scenes• drupal_get_form(‘my_form’)

• my_form()

• $_POST, XSS, XSRF

• my_form_validate()

• my_form_submit()

• drupal_render()


Stupid Form Tricks

• hook_forms()Map form IDs

• hook_elements()Add new form elements

• hook_form_alter()Change any form


New In Drupal 6


IM IN UR FORMZRENAMIN UR BUTTONZ


•Button Handlers

•$op is dead

•Image buttons!

•Buttons renamable

•AHAH


WANT MAHFORM STATE


•Form State

•Input Values

•Workflow

•Storage

•No Globals


#MULTISTEP!?!11!DO NOT WANT


•All Forms

•Just Set ‘rebuild’

•Forms Cached

•Handlers In Control

•Validation, too!


FORMZ CAT IZ BORED.WE HAZ EXAMPLE


Multiple Buttonsfunction my_form() { ... $form['submit'] = array( '#type' => 'submit', '#title' => t('Your foo'), ); $form['delete'] = array( '#type' => 'submit', '#value' => t('Preview'), '#submit' => array('delete_submit'), '#validate' => array('delete_validate'), );

return $form;}


Multiple Buttons

function delete_validate(&$form_state) { $values = $form_state['values']; if (empty($values['foo'])) { form_set_error('title', t('No! Bad!'); }}

function delete_submit(&$form_state) { $values = $form_state['values']; // Delete Yo Stuff! $form_state['redirect'] = '<front>';}


Multiple Buttons

function my_button_handler(&$form_state) { $button = $form_state['clicked_button']; if ($button['#my_special_flag']) { // Do custom stuff here }}


function my_form($form_state) { if (empty($form_state[‘step’]) { $form_state[‘step’] = 1; }

switch ($form_state[‘step’]) { case 1: ... case 2: ... case 3: ... }}

Multi-page Form


function my_form_submit($form_state) { $values = $form_state[‘values’]; $form_state[‘step’] = $values[‘step’]++;

if ($form_state[‘step’] < 3) { $form_state[‘rebuild’] = TRUE; }}

Multi-page Form


Here’s Where ItStarts To Rock


Conditional CAPTCHA

function my_form_alter(&$form, $form_id, $form_state) { $form['#validate'][] = 'captcha_validate'; if ($form_state['needs_captcha']) { // Add a captcha form! }}


Conditional CAPTCHAfunction captcha_validate(&$form_state) { $values = $form_state['values']; if (!empty($values['captcha'])) { if (captcha_failed($values['captcha'])) { form_set_error('title', t('No! Bad spammer!')); } } elseif (is_spammy($values)) { $form_state['needs_captcha'] = TRUE; $form_state['rebuild'] = TRUE; } }}


And Then theEwoks Danced


Form API 3

Technology

Transcript of Form API 3