Drupal 7 Module Development

Building an Admin Interface
A shortcut for system settings
The need to save configuration settings into persistent variables through a standard
form is pretty common. Thankfully, once again Drupal has provided us with some
magic to simplify this task. That magic is the system_settings_form() function.
When you pass a standard Form API form array through this function and return
the results, you get several benefits. Take a look at the following modified version
of user_warn_form():
/**
* Form builder; Build the User Warn 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',
'#default_value' => 'Administrative Warning',
'#title' => t('Warning e-mail subject'),
'#size' => 40,
'#maxlength' => 120,
'#required' => TRUE,
'#description' => t(
'The subject of the e-mail which will be sent to users.'),
);
// Textarea for the body of the e-mail.
$form['user_warn_e-mail_text'] = array(
'#type' => 'textarea',
'#rows' => 10,
'#columns' => 40,
'#default_value' => USER_WARN_MAIL_TEXT,
'#title' => t('Warning e-mail text'),
'#required' => TRUE,
'#description' => t(
'The text of the e-mail which will be sent to users.'),
);
// Checkbox to indicate whether admin should be sent a Bcc
// on e-mails.
$form['user_warn_bcc'] = array(
'#type' => 'checkbox',
'#default_value' => FALSE,
'#title' => t('BCC admin on all e-mails'),
[ 138 ]