Drupal 7 Module Development

Building an Admin Interface
Other parameters can be passed into drupal_get_form() in addition to the form
ID. These extra parameters simply get passed through to the callback function for
its own use. We will see how this works later in the chapter.
In Drupal 6, drupal_get_form() returned a fully rendered HTML
form. This has been changed in Drupal 7 in order to allow more flexibility
in theming and easier form manipulation. drupal_get_form() now
returns an unrendered form array which must be passed to drupal_
render() for final output. In the preceding example the menu system
handles the change transparently, but other code converted from Drupal 6
may need to be changed.
Building a form callback function
For the User Warn module we need a form that allows the site administrator to enter
the following items:
• A subject line for our outgoing e-mail
• The text of our outgoing e-mail
• A checkbox indicating whether or not the administrator should be sent a
Bcc on outgoing e-mails
• A submit button
Our menu definition specified user_warn_form as the page arguments, so we need
to create that function and define our form within it.
This function takes two parameters—$form and $form_state. We will
not be using these parameters in the context of just displaying a form. But,
for more information on their usage see the Form API Quickstart Guide.
/**
* Form builder; Create and display the User Warn configuration
* settings form.
*/
function user_warn_form($form, &$form_state) {
// Text field for the e-mail subject.
$form['user_warn_e-mail_subject'] = array(
'#type' => 'textfield',
'#title' => t('Warning e-mail subject'),
'#description' => t('The subject of the e-mail which will be sent
to users.'),
[ 128 ]