You are here

contact.admin.inc in Contact 6.2

Same filename and directory in other branches
  1. 7.2 contact.admin.inc

Admin page callbacks for the contact module.

File

contact.admin.inc
View source
<?php

/**
 * @file
 * Admin page callbacks for the contact module.
 */

/**
 * Categories/list tab.
 */
function contact_category_list() {
  $header = array(
    t('Category'),
    t('Recipients'),
    t('Selected'),
    array(
      'data' => t('Operations'),
      'colspan' => 2,
    ),
  );
  $rows = array();

  // Get all the contact categories from the database.
  $query = db_query('SELECT cid, category, recipients, selected FROM {contact} ORDER BY weight, category');

  // Loop through the categories and add them to the table.
  while ($category = db_fetch_object($query)) {
    $rows[] = array(
      check_plain($category->category),
      check_plain($category->recipients),
      $category->selected ? t('Yes') : t('No'),
      l(t('Edit'), 'admin/build/contact/edit/' . $category->cid),
      l(t('Delete'), 'admin/build/contact/delete/' . $category->cid),
    );
  }
  if (!$rows) {
    $rows[] = array(
      array(
        'data' => t('No categories available.'),
        'colspan' => 5,
      ),
    );
  }
  return theme('table', $header, $rows);
}

/**
 * Category edit page.
 */
function contact_category_edit_form($form_state, array $category = array()) {

  // If this is a new category, add the default values.
  $category += array(
    'category' => '',
    'recipients' => '',
    'reply' => '',
    'weight' => 0,
    'selected' => 0,
    'cid' => NULL,
  );
  $form['category'] = array(
    '#type' => 'textfield',
    '#title' => t('Category'),
    '#maxlength' => 255,
    '#default_value' => $category['category'],
    '#description' => t("Example: 'website feedback' or 'product information'."),
    '#required' => TRUE,
  );
  $form['recipients'] = array(
    '#type' => 'textarea',
    '#title' => t('Recipients'),
    '#default_value' => $category['recipients'],
    '#description' => t("Example: 'webmaster@example.com' or 'sales@example.com,support@example.com' . To specify multiple recipients, separate each e-mail address with a comma."),
    '#required' => TRUE,
  );
  $form['reply'] = array(
    '#type' => 'textarea',
    '#title' => t('Auto-reply'),
    '#default_value' => $category['reply'],
    '#description' => t('Optional auto-reply. Leave empty if you do not want to send the user an auto-reply message.'),
  );
  $form['weight'] = array(
    '#type' => 'weight',
    '#title' => t('Weight'),
    '#default_value' => $category['weight'],
    '#description' => t('When listing categories, those with lighter (smaller) weights get listed before categories with heavier (larger) weights. Categories with equal weights are sorted alphabetically.'),
  );
  $form['selected'] = array(
    '#type' => 'select',
    '#title' => t('Selected'),
    '#options' => array(
      0 => t('No'),
      1 => t('Yes'),
    ),
    '#default_value' => $category['selected'],
    '#description' => t('Set this to <em>Yes</em> if you would like this category to be selected by default.'),
  );
  $form['cid'] = array(
    '#type' => 'value',
    '#value' => $category['cid'],
  );

  //$form['actions'] = array(

  //  '#type' => 'container',
  //  '#attributes' => array('class' => array('form-actions')),

  //);
  $form['actions']['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Save'),
  );
  return $form;
}

/**
 * Validate the contact category edit page form submission.
 */
function contact_category_edit_form_validate($form, &$form_state) {

  // Validate and each e-mail recipient.
  $recipients = explode(',', $form_state['values']['recipients']);
  foreach ($recipients as &$recipient) {
    $recipient = trim($recipient);
    if (!valid_email_address($recipient)) {
      form_set_error('recipients', t('%recipient is an invalid e-mail address.', array(
        '%recipient' => $recipient,
      )));
    }
  }
  $form_state['values']['recipients'] = implode(',', $recipients);
}

/**
 * Process the contact category edit page form submission.
 */
function contact_category_edit_form_submit($form, &$form_state) {
  if ($form_state['values']['selected']) {

    // Unselect all other contact categories.
    db_query('UPDATE {contact} SET selected = 0');
  }
  if (empty($form_state['values']['cid'])) {
    drupal_write_record('contact', $form_state['values']);
  }
  else {
    drupal_write_record('contact', $form_state['values'], array(
      'cid',
    ));
  }
  drupal_set_message(t('Category %category has been saved.', array(
    '%category' => $form_state['values']['category'],
  )));
  watchdog('contact', 'Category %category has been saved.', array(
    '%category' => $form_state['values']['category'],
  ), WATCHDOG_NOTICE, l(t('Edit'), 'admin/build/contact/edit/' . $form_state['values']['cid']));
  $form_state['redirect'] = 'admin/build/contact';
}

/**
 * Form builder for deleting a contact category.
 *
 * @see contact_category_delete_form_submit()
 */
function contact_category_delete_form($form_state, array $contact) {
  $form['contact'] = array(
    '#type' => 'value',
    '#value' => $contact,
  );
  return confirm_form($form, t('Are you sure you want to delete %category?', array(
    '%category' => $contact['category'],
  )), 'admin/build/contact', t('This action cannot be undone.'), t('Delete'), t('Cancel'));
}

/**
 * Submit handler for the confirm delete category form.
 *
 * @see contact_category_delete_form()
 */
function contact_category_delete_form_submit($form, &$form_state) {
  $contact = $form['contact']['#value'];
  db_query("DELETE FROM {contact} WHERE cid = %d", $contact['cid']);
  drupal_set_message(t('Category %category has been deleted.', array(
    '%category' => $contact['category'],
  )));
  watchdog('contact', 'Category %category has been deleted.', array(
    '%category' => $contact['category'],
  ), WATCHDOG_NOTICE);
  $form_state['redirect'] = 'admin/build/contact';
}

Functions

Namesort descending Description
contact_category_delete_form Form builder for deleting a contact category.
contact_category_delete_form_submit Submit handler for the confirm delete category form.
contact_category_edit_form Category edit page.
contact_category_edit_form_submit Process the contact category edit page form submission.
contact_category_edit_form_validate Validate the contact category edit page form submission.
contact_category_list Categories/list tab.