Formularios Básicos - Drupla

Buen día a todos, primeramente me llamo Dario Garcia, llevo trabajando con drupal aproximadamente 6 meses, anteriormente habia tratado con algunos otros CMS, pero sin entrar en polemica me decidi a usar Drupal, en esta ocasión tratare un tema que fuen bastante ineteresante para mi, el manejo de formularios, se que exitsten módulos como webform, dedicados al manejo de formularios, mas sin embargo existen diversas razones para conocer el funcionamiento de la api de formularios de Drupal:

• Mayor control
• Uso de formularios personalizados
• Formularios complejos
• etc

El objetivo de este articulo es servir como guia breve para crear un formulario personalizado usando la api de drupal, cabe destacar que este miniarticulo, es para la version 4.7

Comenzare con un preintroducción y describiendo un caso sencillo para su posterior explicación

0 . - Tener 2 cuadros de texto
Primeramente se debe crear un nodo, contenido nuevo, y en el tipo de entrada especificar php, en el contenido introduciremos el código que generara dos campos de texto llamados nombre y email.
<?php$form['name'] = array(  '#type' => 'textfield',  '#title' => t('Nombre'), '#default_value' => $object['nombre'],  '#size' => 50,  '#maxlength' => 128,);$form['email'] = array(  '#type' => 'textfield',  '#title' => t('Email'), '#default_value' => $object['email'],  '#size' => 50,  '#maxlength' => 128,); $form['submit'] = array( '#type' => 'submit',  '#value' => t('Enviar'),   '#weight' => 19,);  $output = drupal_get_form('contacto', $form);  return $output;?>

Si funciono de manera correcta, tendrán un formulario simple con dos cuadros de texto llamados, nombre y email.
Tomemos el primero de ellos para explicar brevemente el cometido de cada una
$form['name'] = array(  '#type' => 'textfield',  '#title' => t('Nombre'),  '#size' => 50,  '#maxlength' => 128,);
$form['name']   
Es el nombre del cuadro de texto y tiene las siguientes propiedades:
  '#type' => 'textfield',   
Especificando que se trata de un cuadro de texto
'#title' => t('Nombre'),  
EL titulo que en XHTML seria la etiqueta label
  '#size' => 50,   
El tamaño del cuedro de texto
'#maxlength' => 128,   
El numeromáximo de caracteres que admite

Las api de dupal para formularios puede consultarse enhttp://api.drupal.org/api/4.7/file/developer/topics/forms_api_reference....

y finalmente las lineas:
  $output = drupal_get_form('contacto', $form);  return $output;  
en etas se llama a la funcion drupal_get_form que viene a ser la que genera los formularios, como parametros lleva El array con formularios "$form" y el nombre del formulario,en este caso "contacto".

Este documento lo hice en base a mi experiencia personal, si lo consideran util haganmelo saber para seguir escribiendo miniarticulos, sobre manejo de formularios, aclaro que no soy experto en la materia y unicamente quisiera describir mi experiencia.