Same filename and directory in other branches
  1. 7.x modules/filter/filter.admin.inc

Admin page callbacks for the filter module.

File

modules/filter/filter.admin.inc
View source
<?php

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

/**
 * Menu callback; Displays a list of all input formats and which
 * one is the default.
 *
 * @ingroup forms
 * @see filter_admin_overview_submit()
 */
function filter_admin_overview() {

  // Overview of all formats.
  $formats = filter_formats();
  $error = FALSE;
  foreach ($formats as $id => $format) {
    $roles = array();
    foreach (user_roles() as $rid => $name) {

      // Prepare a roles array with roles that may access the filter.
      if (strstr($format->roles, ",{$rid},")) {
        $roles[] = $name;
      }
    }
    $default = $id == variable_get('filter_default_format', 1);
    $options[$id] = '';
    $form[$format->name]['id'] = array(
      '#value' => $id,
    );
    $form[$format->name]['roles'] = array(
      '#value' => $default ? t('All roles may use default format') : ($roles ? implode(', ', $roles) : t('No roles may use this format')),
    );
    $form[$format->name]['configure'] = array(
      '#value' => l(t('configure'), 'admin/settings/filters/' . $id),
    );
    $form[$format->name]['delete'] = array(
      '#value' => $default ? '' : l(t('delete'), 'admin/settings/filters/delete/' . $id),
    );
  }
  $form['default'] = array(
    '#type' => 'radios',
    '#options' => $options,
    '#default_value' => variable_get('filter_default_format', 1),
  );
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Set default format'),
  );
  return $form;
}
function filter_admin_overview_submit($form, &$form_state) {

  // Process form submission to set the default format.
  if (is_numeric($form_state['values']['default'])) {
    drupal_set_message(t('Default format updated.'));
    variable_set('filter_default_format', $form_state['values']['default']);
  }
}

/**
 * Theme the admin overview form.
 *
 * @ingroup themeable
 */
function theme_filter_admin_overview($form) {
  $rows = array();
  foreach ($form as $name => $element) {
    if (isset($element['roles']) && is_array($element['roles'])) {
      $rows[] = array(
        drupal_render($form['default'][$element['id']['#value']]),
        check_plain($name),
        drupal_render($element['roles']),
        drupal_render($element['configure']),
        drupal_render($element['delete']),
      );
      unset($form[$name]);
    }
  }
  $header = array(
    t('Default'),
    t('Name'),
    t('Roles'),
    array(
      'data' => t('Operations'),
      'colspan' => 2,
    ),
  );
  $output = theme('table', $header, $rows);
  $output .= drupal_render($form);
  return $output;
}

/**
 * Menu callback; Display a filter format form.
 */
function filter_admin_format_page($format = NULL) {
  if (!isset($format->name)) {
    drupal_set_title(t("Add input format"));
    $format = (object) array(
      'name' => '',
      'roles' => '',
      'format' => '',
    );
  }
  return drupal_get_form('filter_admin_format_form', $format);
}

/**
 * Generate a filter format form.
 *
 * @ingroup forms
 * @see filter_admin_format_form_validate()
 * @see filter_admin_format_form_submit()
 */
function filter_admin_format_form(&$form_state, $format) {
  $default = $format->format == variable_get('filter_default_format', 1);
  if ($default) {
    $help = t('All roles for the default format must be enabled and cannot be changed.');
    $form['default_format'] = array(
      '#type' => 'hidden',
      '#value' => 1,
    );
  }
  $form['name'] = array(
    '#type' => 'textfield',
    '#title' => t('Name'),
    '#default_value' => $format->name,
    '#description' => t('Specify a unique name for this filter format.'),
    '#required' => TRUE,
  );

  // Add a row of checkboxes for form group.
  $form['roles'] = array(
    '#type' => 'fieldset',
    '#title' => t('Roles'),
    '#description' => $default ? $help : t('Choose which roles may use this filter format. Note that roles with the "administer filters" permission can always use all the filter formats.'),
    '#tree' => TRUE,
  );
  foreach (user_roles() as $rid => $name) {
    $checked = strstr($format->roles, ",{$rid},");
    $form['roles'][$rid] = array(
      '#type' => 'checkbox',
      '#title' => $name,
      '#default_value' => $default || $checked,
    );
    if ($default) {
      $form['roles'][$rid]['#disabled'] = TRUE;
    }
  }

  // Table with filters
  $all = filter_list_all();
  $enabled = filter_list_format($format->format);
  $form['filters'] = array(
    '#type' => 'fieldset',
    '#title' => t('Filters'),
    '#description' => t('Choose the filters that will be used in this filter format.'),
    '#tree' => TRUE,
  );
  foreach ($all as $id => $filter) {
    $form['filters'][$id] = array(
      '#type' => 'checkbox',
      '#title' => $filter->name,
      '#default_value' => isset($enabled[$id]),
      '#description' => module_invoke($filter->module, 'filter', 'description', $filter->delta),
    );
  }
  if (!empty($format->format)) {
    $form['format'] = array(
      '#type' => 'hidden',
      '#value' => $format->format,
    );

    // Composition tips (guidelines)
    $tips = _filter_tips($format->format, FALSE);
    $extra = '<p>' . l(t('More information about formatting options'), 'filter/tips') . '</p>';
    $tiplist = theme('filter_tips', $tips, FALSE, $extra);
    if (!$tiplist) {
      $tiplist = '<p>' . t('No guidelines available.') . '</p>';
    }
    $group = '<p>' . t('These are the guidelines that users will see for posting in this input format. They are automatically generated from the filter settings.') . '</p>';
    $group .= $tiplist;
    $form['tips'] = array(
      '#value' => '<h2>' . t('Formatting guidelines') . '</h2>' . $group,
    );
  }
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Save configuration'),
  );
  return $form;
}

/**
 * Validate filter format form submissions.
 */
function filter_admin_format_form_validate($form, &$form_state) {
  if (!isset($form_state['values']['format'])) {
    $name = trim($form_state['values']['name']);
    $result = db_fetch_object(db_query("SELECT format FROM {filter_formats} WHERE name='%s'", $name));
    if ($result) {
      form_set_error('name', t('Filter format names need to be unique. A format named %name already exists.', array(
        '%name' => $name,
      )));
    }
  }
}

/**
 * Process filter format form submissions.
 */
function filter_admin_format_form_submit($form, &$form_state) {
  $format = isset($form_state['values']['format']) ? $form_state['values']['format'] : NULL;
  $current = filter_list_format($format);
  $name = trim($form_state['values']['name']);
  $cache = TRUE;

  // Add a new filter format.
  if (!$format) {
    $new = TRUE;
    db_query("INSERT INTO {filter_formats} (name) VALUES ('%s')", $name);
    $format = db_result(db_query("SELECT MAX(format) AS format FROM {filter_formats}"));
    drupal_set_message(t('Added input format %format.', array(
      '%format' => $name,
    )));
  }
  else {
    drupal_set_message(t('The input format settings have been updated.'));
  }
  db_query("DELETE FROM {filters} WHERE format = %d", $format);
  foreach ($form_state['values']['filters'] as $id => $checked) {
    if ($checked) {
      list($module, $delta) = explode('/', $id);

      // Add new filters to the bottom.
      $weight = isset($current[$id]->weight) ? $current[$id]->weight : 10;
      db_query("INSERT INTO {filters} (format, module, delta, weight) VALUES (%d, '%s', %d, %d)", $format, $module, $delta, $weight);

      // Check if there are any 'no cache' filters.
      $cache &= !module_invoke($module, 'filter', 'no cache', $delta);
    }
  }

  // We store the roles as a string for ease of use.
  // We should always set all roles to TRUE when saving a default role.
  // We use leading and trailing comma's to allow easy substring matching.
  $roles = array();
  if (isset($form_state['values']['roles'])) {
    foreach ($form_state['values']['roles'] as $id => $checked) {
      if ($checked) {
        $roles[] = $id;
      }
    }
  }
  if (!empty($form_state['values']['default_format'])) {
    $roles = ',' . implode(',', array_keys(user_roles())) . ',';
  }
  else {
    $roles = ',' . implode(',', $roles) . ',';
  }
  db_query("UPDATE {filter_formats} SET cache = %d, name='%s', roles = '%s' WHERE format = %d", $cache, $name, $roles, $format);
  cache_clear_all($format . ':', 'cache_filter', TRUE);

  // If a new filter was added, return to the main list of filters. Otherwise, stay on edit filter page to show new changes.
  $return = 'admin/settings/filters';
  if (!empty($new)) {
    $return .= '/' . $format;
  }
  $form_state['redirect'] = $return;
  return;
}

/**
 * Menu callback; confirm deletion of a format.
 *
 * @ingroup forms
 * @see filter_admin_delete_submit()
 */
function filter_admin_delete() {
  $format = arg(4);
  $format = db_fetch_object(db_query('SELECT * FROM {filter_formats} WHERE format = %d', $format));
  if ($format) {
    if ($format->format != variable_get('filter_default_format', 1)) {
      $form['format'] = array(
        '#type' => 'hidden',
        '#value' => $format->format,
      );
      $form['name'] = array(
        '#type' => 'hidden',
        '#value' => $format->name,
      );
      return confirm_form($form, t('Are you sure you want to delete the input format %format?', array(
        '%format' => $format->name,
      )), 'admin/settings/filters', t('If you have any content left in this input format, it will be switched to the default input format. This action cannot be undone.'), t('Delete'), t('Cancel'));
    }
    else {
      drupal_set_message(t('The default format cannot be deleted.'));
      drupal_goto('admin/settings/filters');
    }
  }
  else {
    drupal_not_found();
  }
}

/**
 * Process filter delete form submission.
 */
function filter_admin_delete_submit($form, &$form_state) {
  db_query("DELETE FROM {filter_formats} WHERE format = %d", $form_state['values']['format']);
  db_query("DELETE FROM {filters} WHERE format = %d", $form_state['values']['format']);
  $default = variable_get('filter_default_format', 1);

  // Replace existing instances of the deleted format with the default format.
  db_query("UPDATE {node_revisions} SET format = %d WHERE format = %d", $default, $form_state['values']['format']);
  db_query("UPDATE {comments} SET format = %d WHERE format = %d", $default, $form_state['values']['format']);
  db_query("UPDATE {boxes} SET format = %d WHERE format = %d", $default, $form_state['values']['format']);
  cache_clear_all($form_state['values']['format'] . ':', 'cache_filter', TRUE);
  drupal_set_message(t('Deleted input format %format.', array(
    '%format' => $form_state['values']['name'],
  )));
  $form_state['redirect'] = 'admin/settings/filters';
  return;
}

/**
 * Menu callback; display settings defined by a format's filters.
 */
function filter_admin_configure_page($format) {
  drupal_set_title(t("Configure %format", array(
    '%format' => $format->name,
  )));
  return drupal_get_form('filter_admin_configure', $format);
}

/**
 * Build a form to change the settings for a format's filters.
 *
 * @ingroup forms
 */
function filter_admin_configure(&$form_state, $format) {
  $list = filter_list_format($format->format);
  $form = array();
  foreach ($list as $filter) {
    $form_module = module_invoke($filter->module, 'filter', 'settings', $filter->delta, $format->format);
    if (isset($form_module) && is_array($form_module)) {
      $form = array_merge($form, $form_module);
    }
  }
  if (!empty($form)) {
    $form = system_settings_form($form);
  }
  else {
    $form['error'] = array(
      '#value' => t('No settings are available.'),
    );
  }
  $form['format'] = array(
    '#type' => 'hidden',
    '#value' => $format->format,
  );
  $form['#submit'][] = 'filter_admin_configure_submit';
  return $form;
}

/**
 * Clear the filter's cache when configuration settings are saved.
 */
function filter_admin_configure_submit($form, &$form_state) {
  cache_clear_all($form_state['values']['format'] . ':', 'cache_filter', TRUE);
}

/**
 * Menu callback; display form for ordering filters for a format.
 */
function filter_admin_order_page($format) {
  drupal_set_title(t("Rearrange %format", array(
    '%format' => $format->name,
  )));
  return drupal_get_form('filter_admin_order', $format);
}

/**
 * Build the form for ordering filters for a format.
 *
 * @ingroup forms
 * @see theme_filter_admin_order()
 * @see filter_admin_order_submit()
 */
function filter_admin_order(&$form_state, $format = NULL) {

  // Get list (with forced refresh).
  $filters = filter_list_format($format->format);
  $form['weights'] = array(
    '#tree' => TRUE,
  );
  foreach ($filters as $id => $filter) {
    $form['names'][$id] = array(
      '#value' => $filter->name,
    );
    $form['weights'][$id] = array(
      '#type' => 'weight',
      '#default_value' => $filter->weight,
    );
  }
  $form['format'] = array(
    '#type' => 'hidden',
    '#value' => $format->format,
  );
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Save configuration'),
  );
  return $form;
}

/**
 * Theme filter order configuration form.
 *
 * @ingroup themeable
 */
function theme_filter_admin_order($form) {
  $header = array(
    t('Name'),
    t('Weight'),
  );
  $rows = array();
  foreach (element_children($form['names']) as $id) {

    // Don't take form control structures.
    if (is_array($form['names'][$id])) {
      $form['weights'][$id]['#attributes']['class'] = 'filter-order-weight';
      $rows[] = array(
        'data' => array(
          drupal_render($form['names'][$id]),
          drupal_render($form['weights'][$id]),
        ),
        'class' => 'draggable',
      );
    }
  }
  $output = theme('table', $header, $rows, array(
    'id' => 'filter-order',
  ));
  $output .= drupal_render($form);
  drupal_add_tabledrag('filter-order', 'order', 'sibling', 'filter-order-weight', NULL, NULL, FALSE);
  return $output;
}

/**
 * Process filter order configuration form submission.
 */
function filter_admin_order_submit($form, &$form_state) {
  foreach ($form_state['values']['weights'] as $id => $weight) {
    list($module, $delta) = explode('/', $id);
    db_query("UPDATE {filters} SET weight = %d WHERE format = %d AND module = '%s' AND delta = %d", $weight, $form_state['values']['format'], $module, $delta);
  }
  drupal_set_message(t('The filter ordering has been saved.'));
  cache_clear_all($form_state['values']['format'] . ':', 'cache_filter', TRUE);
}

Functions

Namesort descending Description
filter_admin_configure Build a form to change the settings for a format's filters.
filter_admin_configure_page Menu callback; display settings defined by a format's filters.
filter_admin_configure_submit Clear the filter's cache when configuration settings are saved.
filter_admin_delete Menu callback; confirm deletion of a format.
filter_admin_delete_submit Process filter delete form submission.
filter_admin_format_form Generate a filter format form.
filter_admin_format_form_submit Process filter format form submissions.
filter_admin_format_form_validate Validate filter format form submissions.
filter_admin_format_page Menu callback; Display a filter format form.
filter_admin_order Build the form for ordering filters for a format.
filter_admin_order_page Menu callback; display form for ordering filters for a format.
filter_admin_order_submit Process filter order configuration form submission.
filter_admin_overview Menu callback; Displays a list of all input formats and which one is the default.
filter_admin_overview_submit
theme_filter_admin_order Theme filter order configuration form.
theme_filter_admin_overview Theme the admin overview form.