Drupal 7 Module Development

Building an Admin Interface
}
return confirm_form(
$form,
t(
'Are you sure you want to send a warning e-mail to this user?'),
'user/' . $uid,
t('This action can not be undone.'),
t('Send e-mail'),
t('Cancel')
);
The confirm_form() function allows developers to easily create confirmation forms
associated with specific actions. It takes seven arguments, which seems intimidating
but they are actually pretty intuitive.
The first argument contains additional form elements that we want merged into the
resulting confirmation form. As we saw earlier, we have created a value element
containing a user account object. We need this to be passed on to the form's submit
function, so we set it to be added with all the other elements that confirm_form()
creates on its own.
The second argument specifies the question you want to ask when the user is
presented with the confirmation option. This is pretty straightforward and we
have an appropriate message there.
The third argument indicates what URL the user should be sent to if the user cancels
the form. Usually this will be an internal Drupal path without leading or trailing
slashes. Typically site administrators will get to this page from a user profile page,
so it is appropriate that when this form is canceled the administrators are returned
to this profile page.
The final three arguments specify various captions used in the form. They are the
additional description text to be displayed above the confirm button, the text of
confirm button, and the text of the cancel link. All of these messages are optional,
and Drupal will use sensible defaults if you don't change them here explicitly.
The code above displays the following:
[ 140 ]