hierarchical_select.admin.inc in Hierarchical Select 5.3

Module settings and configuration administration UI.

File

hierarchical_select.admin.inc

<?php

/**
 * @file
 * Module settings and configuration administration UI.
 */

/**
 * Form definition; admin settings.
 */
function hierarchical_select_admin_settings() {
  $form['description'] = array(
    '#value' => t('All settings below will be used as site-wide defaults.'),
    '#prefix' => '<div>',
    '#suffix' => '</div>',
  );
  $form['hierarchical_select_animation_delay'] = array(
    '#type' => 'textfield',
    '#title' => t('Animation delay'),
    '#description' => t('The delay that will be used for the "drop in/out" effect when a
      hierarchical select is being updated (in milliseconds).'),
    '#size' => 5,
    '#maxlength' => 5,
    '#default_value' => variable_get('hierarchical_select_animation_delay', 400),
  );
  $form['hierarchical_select_level_labels_style'] = array(
    '#type' => 'select',
    '#title' => t('Level labels style'),
    '#description' => t('The style that will be used for level labels. This is not supported by
      all browsers! If you want a consistent interface, choose to use no
      style.'),
    '#options' => array(
      'none' => t('No style'),
      'bold' => t('Bold'),
      'inversed' => t('Inversed'),
      'underlined' => t('Underlined'),
    ),
    '#default_value' => variable_get('hierarchical_select_level_labels_style', 'none'),
  );
  $form['hierarchical_select_js_cache_system'] = array(
    '#type' => 'radios',
    '#title' => t('Cache in a HTML 5 client-side database'),
    '#description' => t('This feature only works in browsers that support the
      <a href="!spec-url">HTML 5 client-side database storage specification
      </a>.</br>
      After enabling this, you will notice (in supporting browsers) that
      refreshing the hierarchical select will not require a request to the
      server when a part is being requested that has been requested before.', array(
      '!spec-url' => url('http://www.whatwg.org/specs/web-apps/current-work/multipage/section-sql.html'),
    )),
    '#options' => array(
      0 => t('Disabled'),
      1 => t('Enabled'),
    ),
    '#default_value' => variable_get('hierarchical_select_js_cache_system', 0),
  );
  return system_settings_form($form);
}

/**
 * Menu callback; a table that lists all Hierarchical Select configs.
 */
function hierarchical_select_admin_configs() {
  $header = array(
    t('Hierarchy type'),
    t('Hierarchy'),
    t('Entity type'),
    t('Entity'),
    t('Context type'),
    t('Context'),
    t('Actions'),
  );

  // Retrieve all information items
  $info_items = array();
  foreach (module_implements('hierarchical_select_config_info') as $module) {
    $info_items = array_merge_recursive($info_items, module_invoke($module, 'hierarchical_select_config_info'));
  }

  // Process the retrieved information into rows.
  $rows = array();
  foreach ($info_items as $id => $item) {
    $config_id = $item['config_id'];
    $rows[$id] = array(
      $item['hierarchy type'],
      check_plain($item['hierarchy']),
      $item['entity type'],
      $item['entity'],
      $item['context type'],
      $item['context'],
      theme('links', array(
        array(
          'title' => t('Edit'),
          'href' => $item['edit link'],
          'fragment' => "hierarchical-select-config-form-{$config_id}",
        ),
        array(
          'title' => t('Export'),
          'href' => "admin/settings/hierarchical_select/export/{$config_id}",
        ),
        array(
          'title' => t('Import'),
          'href' => "admin/settings/hierarchical_select/import/{$config_id}",
        ),
      )),
    );
  }
  return theme('table', $header, $rows, array(), t('Overview of all Hierarchical Select configurations.'));
}

/**
 * Menu callback; a table that lists all Hierarchical Select implementations
 * and the features they support.
 */
function hierarchical_select_admin_implementations() {
  $output = '';
  $header = array(
    t('Implementation (module)'),
    t('Hierarchy type'),
    t('Entity type'),
    t('Create new items'),
    t('Entity count'),
  );

  // Retrieve all information items
  $rows = array();
  foreach (module_implements('hierarchical_select_root_level') as $module) {
    $filename = db_result(db_query("SELECT filename FROM {system} WHERE type = 'module' AND name = '%s'", $module));
    $module_info = _module_parse_info_file(dirname($filename) . "/{$module}.info");

    // Try to extract the hierarchy type from the optional hook_hierarchical_select_config_info().
    $hierarchy_type = $entity_type = t('unknown');
    if (module_hook($module, 'hierarchical_select_implementation_info')) {
      $implementation = module_invoke($module, 'hierarchical_select_implementation_info');
      $hierarchy_type = $implementation['hierarchy type'];
      $entity_type = $implementation['entity type'];
    }
    $rows[] = array(
      $module_info['name'],
      $hierarchy_type,
      $entity_type,
      module_hook($module, 'hierarchical_select_create_item') ? t('Yes') : t('No'),
      module_hook($module, 'hierarchical_select_entity_count') ? t('Yes') : t('No'),
    );
  }
  $output .= '<p>';
  $output .= t('
    The table below allows you to find out <strong>which Hierarchical Select
    features are supported</strong> by the implementations of the Hierarchical
    Select API.<br />
    It is <strong>not a reflection of some settings</strong>.
  ');
  $output .= '</p>';
  $output .= theme('table', $header, $rows, array(), t('Overview of all installed Hierarchical Select implementations.'));
  return $output;
}

/**
 * Form definition; config export form.
 */
function hierarchical_select_admin_export($config_id) {
  $config = hierarchical_select_common_config_get($config_id);
  $code = _hierarchical_select_create_export_code($config);
  drupal_add_css(drupal_get_path('module', 'hierarchical_select') . '/hierarchical_select.css');
  drupal_add_js('$(document).ready(function() { $(".hierarchical-select-code").focus(); });', 'inline');
  $lines = substr_count($code, "\n") + 1;
  $form['config'] = array(
    '#type' => 'textarea',
    '#title' => t('Hierarchical Select configuration %config_id', array(
      '%config_id' => $config_id,
    )),
    '#default_value' => $code,
    '#rows' => $lines,
    '#attributes' => array(
      'class' => 'hierarchical-select-config-code',
    ),
  );
  return $form;
}

/**
 * Form definition; config import form.
 */
function hierarchical_select_admin_import($config_id) {
  drupal_add_css(drupal_get_path('module', 'hierarchical_select') . '/hierarchical_select.css');
  drupal_add_js('$(document).ready(function() { $(".hierarchical-select-code").focus(); });', 'inline');
  $form['config'] = array(
    '#type' => 'textarea',
    '#title' => t('Import Hierarchical Select configuration code'),
    '#cols' => 60,
    '#rows' => 15,
    '#description' => t('Copy and paste the results of an exported
      Hierarchical Select configuration here.<br />This will override the
      current Hierarchical Select configuration for %config_id.', array(
      '%config_id' => $config_id,
    )),
    '#attributes' => array(
      'class' => 'hierarchical-select-config-code',
    ),
  );
  $form['interpreted_config'] = array(
    '#type' => 'value',
    '#value' => NULL,
  );
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t("Import"),
  );
  $form['#redirect'] = NULL;
  return $form;
}

/**
 * Validate callback; config import form.
 */
function hierarchical_select_admin_import_validate($form_id, $form_values, $form) {
  ob_start();
  eval($form_values['config']);
  ob_end_clean();
  form_set_value($form['interpreted_config'], serialize($config));
  if (empty($form_values['config'])) {
    form_error($form['config'], t('You did not enter anything.'));
  }
  elseif ($config == NULL) {
    form_error($form['config'], t('There is a syntax error in the Hierarchical Select configuration you entered.'));
  }
  elseif (!isset($config['config_id']) || empty($config['config_id'])) {
    form_error($form['config'], t('Unable to import this configuration, because no Hierarchical Select <em>config id</em> is set.'));
  }
}

/**
 * Submit callback; config import form.
 */
function hierarchical_select_admin_import_submit($form_id, $form_values) {
  $config = unserialize($form_values['interpreted_config']);
  $config_id = $config['config_id'];
  hierarchical_select_common_config_set($config_id, $config);
  drupal_set_message(t('Hierarchical Select configuration for %config_id imported!', array(
    '%config_id' => $config_id,
  )));
}

//----------------------------------------------------------------------------

// Private functions.

/**
 * Given a config array, create the export code for it.
 *
 * @param $config
 *   A Hierarchical Select config array, as described in API.txt
 * @return
 *   The code as it would appear in an editor.
 */
function _hierarchical_select_create_export_code($config) {
  $output = '';
  $output .= "\$config = array(\n";
  $output .= "  'config_id'       => '" . $config['config_id'] . "',\n";
  $output .= "  'save_lineage'    => " . $config['save_lineage'] . ",\n";
  $output .= "  'enforce_deepest' => " . $config['enforce_deepest'] . ",\n";
  $output .= "  'entity_count'    => " . $config['entity_count'] . ",\n";
  $output .= "  'require_entity'  => " . $config['require_entity'] . ",\n";
  $output .= "  'resizable'       => " . $config['resizable'] . ",\n";
  $output .= "  'level_labels' => array(\n";
  $output .= "    'status' => " . $config['level_labels']['status'] . ",\n";
  $output .= "    'labels' => array(\n";
  if (isset($config['level_labels']['labels'])) {
    foreach ($config['level_labels']['labels'] as $depth => $label) {
      $label = str_replace("'", "\\'", $label);
      $output .= "      {$depth} => '{$label}',\n";
    }
  }
  $output .= "    ),\n";
  $output .= "  ),\n";
  $output .= "  'dropbox' => array(\n";
  $output .= "    'status'    => " . $config['dropbox']['status'] . ",\n";
  $output .= "    'title'     => '" . str_replace("'", "\\'", $config['dropbox']['title']) . "',\n";
  $output .= "    'limit'     => " . $config['dropbox']['limit'] . ",\n";
  $output .= "    'reset_hs'  => " . $config['dropbox']['reset_hs'] . ",\n";
  $output .= "  ),\n";
  $output .= "  'editability' => array(\n";
  $output .= "    'status' => " . $config['editability']['status'] . ",\n";
  $output .= "    'item_types' => array(\n";
  if (isset($config['editability']['item_types'])) {
    foreach ($config['editability']['item_types'] as $depth => $item_type) {
      $item_type = str_replace("'", "\\'", $item_type);
      $output .= "      {$depth} => '{$item_type}',\n";
    }
  }
  $output .= "    ),\n";
  $output .= "    'allowed_levels' => array(\n";
  if (isset($config['editability']['allowed_levels'])) {
    foreach ($config['editability']['allowed_levels'] as $depth => $allowed_level) {
      $output .= "      {$depth} => {$allowed_level},\n";
    }
  }
  $output .= "    ),\n";
  $output .= "    'allow_new_levels' => " . $config['editability']['allow_new_levels'] . ",\n";
  $output .= "    'max_levels'       => " . $config['editability']['max_levels'] . ",\n";
  $output .= "  ),\n";
  $output .= ");\n";
  return $output;
}

Functions

Name	Description
hierarchical_select_admin_configs	Menu callback; a table that lists all Hierarchical Select configs.
hierarchical_select_admin_export	Form definition; config export form.
hierarchical_select_admin_implementations	Menu callback; a table that lists all Hierarchical Select implementations and the features they support.
hierarchical_select_admin_import	Form definition; config import form.
hierarchical_select_admin_import_submit	Submit callback; config import form.
hierarchical_select_admin_import_validate	Validate callback; config import form.
hierarchical_select_admin_settings	Form definition; admin settings.
_hierarchical_select_create_export_code	Given a config array, create the export code for it.