Do I need to use drupal_mail after the hook_form_contact_site_form_alter?

Question

I have added on field in my site wide contact form through this code :

    function cstm_form_contact_site_form_alter(&$form, &$form_state, $form_id) {

    // Add a phone number field to the contact form.
    $form['phone'] = array(
    '#type' => 'textfield',
    '#maxlength' => 20,
    '#title' => t('Your phone'),
    );

    // Define the order of the top level elements on the form (include those from contact_site_form().
    $order = array('name', 'mail', 'phone', 'subject', 'cid', 'message', 'copy', 'actions');

    // Order the elements by changing their #weight property.
    foreach($order as $key => $field) {
    $form[$field]['#weight'] = $key;
    }
    }

Now Do I need to add drupal_mail with phone number into it or Drupal will consider it automatically ? As I am new to drupal I don't know much about it.

Answer 1

You should use hook_mail_alter().

hook_mail_alter() allows you to modify the email cleanly before it is sent. The Contact module passes the entire form state to drupal_mail(), so you have access to it in this alter hook via the params key.

A quick example. I haven't tested it:

function my_module_mail_alter(&$message) {
  if ($message['id'] == 'contact_page_mail') {
    $phone = $message['params']['phone'];

    $message['body'][] = "Phone number: " . check_plain($phone);
  }
}

Let me know if that works.

Answer 2

I think what you are looking for is already answered here

Also if you are looking for basic tutorial you can check below links

http://www.blog.yamandi.com/how-use-drupalmail-function-tutorial

http://www.chrisfree.me/2010/01/override-drupal-contact-form

http://www.panda-os.com/2013/02/drupal-email-system/#.VD5-TPmSxws

And If you want to theme the outgoing mails with the help of custom templates, you should use the HTML Mail module.

Lets you theme your messages the same way you theme the rest of your website.

It works well with other modules, like Print, Mail mime, etc.

You have to install the Mail System module in order to use HTML mail.