Drupal 7 Module Development

variable_set('user_warn_e-mail_subject',
$form_state['values']['user_warn_e-mail_subject']);
variable_set('user_warn_e-mail_text',
$form_state['values']['user_warn_e-mail_text']);
variable_set('user_warn_bcc',
$form_state['values']['user_warn_bcc']);
Chapter 5
}
drupal_set_message(t('The settings have been saved'));
After all that, our submit function is pretty simple. We are saving our submitted data
using variable_set(), then setting a simple message indicating that the values
have been saved successfully. Our needs for validation are handled by Drupal's
built-in form validation, so we don't even need a validate function for this data.
The function drupal_set_message() sets a simple message that
is displayed in a specific area at the top of a Drupal page. For more
details see http://api.drupal.org/api/function/drupal_
set_message/7.
After a form is submitted, it will reload the form submission page. Since we have
saved new data in our persistent variables through the submit function, and since the
form is pre-loaded with default data based on the data in those variables, we should
now be able to submit new data for these items and see them reflected after the form
has been submitted.
If you want Drupal to redirect to a different page after form
submission, you can set $form_state['redirect'] to the desired
path in your submit function. If this isn't working, check whether you
have specified for $form_state to be passed by reference by adding
an ampersand to it in your function signature.
Form API provides us with a great deal of power with a pretty small amount of
work, but Drupal offers some shortcuts which make common forms even easier.
[ 137 ]