You are here

bulk_export.module in Chaos Tool Suite (ctools) 7

Same filename and directory in other branches
  1. 6 bulk_export/bulk_export.module

Perform bulk exports.

File

bulk_export/bulk_export.module
View source
<?php

/**
 * @file
 * Perform bulk exports.
 */

/**
 * Implements hook_permission().
 */
function bulk_export_permission() {
  return array(
    'use bulk exporter' => array(
      'title' => t('Access Bulk Exporter'),
      'description' => t('Export various system objects into code.'),
    ),
  );
}

/**
 * Implements hook_menu().
 */
function bulk_export_menu() {
  $items['admin/structure/bulk-export'] = array(
    'title' => 'Bulk Exporter',
    'description' => 'Bulk-export multiple CTools-handled data objects to code.',
    'access arguments' => array(
      'use bulk exporter',
    ),
    'page callback' => 'bulk_export_export',
  );
  $items['admin/structure/bulk-export/results'] = array(
    'access arguments' => array(
      'use bulk exporter',
    ),
    'page callback' => 'bulk_export_export',
    'type' => MENU_CALLBACK,
  );
  return $items;
}

/**
 * FAPI gateway to the bulk exporter.
 *
 * @param $cli
 *   Whether this function is called from command line.
 * @param $options
 *   A collection of options, only passed in by drush_ctools_export().
 */
function bulk_export_export($cli = FALSE, $options = array()) {
  ctools_include('export');
  $form = array();
  $schemas = ctools_export_get_schemas(TRUE);
  $exportables = $export_tables = array();
  foreach ($schemas as $table => $schema) {
    if (!empty($schema['export']['list callback']) && function_exists($schema['export']['list callback'])) {
      $exportables[$table] = $schema['export']['list callback']();
    }
    else {
      $exportables[$table] = ctools_export_default_list($table, $schema);
    }
    natcasesort($exportables[$table]);
    $export_tables[$table] = $schema['module'];
  }
  if ($exportables) {
    $form_state = array(
      're_render' => FALSE,
      'no_redirect' => TRUE,
      'exportables' => $exportables,
      'export_tables' => $export_tables,
      'name' => '',
      'code' => '',
      'module' => '',
    );

    // If called from drush_ctools_export, get the module name and
    // select all exportables and call the submit function directly.
    if ($cli) {
      $module_name = $options['name'];
      $form_state['values']['name'] = $module_name;
      if (isset($options['selections'])) {
        $exportables = $options['selections'];
      }
      $form_state['values']['tables'] = array();
      foreach ($exportables as $table => $names) {
        if (!empty($names)) {
          $form_state['values']['tables'][] = $table;
          $form_state['values'][$table] = array();
          foreach ($names as $name => $title) {
            $form_state['values'][$table][$name] = $name;
          }
        }
      }
      $output = bulk_export_export_form_submit($form, $form_state);
    }
    else {
      $output = drupal_build_form('bulk_export_export_form', $form_state);
      $module_name = $form_state['module'];
    }
    if (!empty($form_state['submitted']) || $cli) {
      drupal_set_title(t('Bulk export results'));
      $output = '';
      $module_code = '';
      $api_code = array();
      $dependencies = $file_data = array();
      foreach ($form_state['code'] as $module => $api_info) {
        if ($module == 'general') {
          $module_code .= $api_info;
        }
        else {
          foreach ($api_info as $api => $info) {
            $api_hook = ctools_plugin_api_get_hook($module, $api);
            if (empty($api_code[$api_hook])) {
              $api_code[$api_hook] = '';
            }
            $api_code[$api_hook] .= "  if (\$module == '{$module}' && \$api == '{$api}') {\n";
            $api_code[$api_hook] .= "    return array('version' => {$info['version']});\n";
            $api_code[$api_hook] .= "  }\n";
            $dependencies[$module] = TRUE;
            $file = $module_name . '.' . $api . '.inc';
            $code = "<?php\n\n";
            $code .= "/**\n";
            $code .= " * @file\n";
            $code .= " * Bulk export of {$api} objects generated by Bulk export module.\n";
            $code .= " */\n\n";
            $code .= $info['code'];
            if ($cli) {
              $file_data[$file] = $code;
            }
            else {
              $export_form = drupal_get_form('ctools_export_form', $code, t('Place this in @file', array(
                '@file' => $file,
              )));
              $output .= drupal_render($export_form);
            }
          }
        }
      }

      // Add hook_ctools_plugin_api at the top of the module code, if there is any.
      if ($api_code) {
        foreach ($api_code as $api_hook => $text) {
          $api = "\n/**\n";
          $api .= " * Implements hook_{$api_hook}().\n";
          $api .= " */\n";
          $api .= "function {$module_name}_{$api_hook}(\$module, \$api) {\n";
          $api .= $text;
          $api .= "}\n";
          $module_code = $api . $module_code;
        }
      }
      if ($module_code) {
        $module = "<?php\n\n";
        $module .= "/**\n";
        $module .= " * @file\n";
        $module .= " * Bulk export of objects generated by Bulk export module.\n";
        $module .= " */\n";
        $module .= $module_code;
        if ($cli) {
          $file_data[$module_name . '.module'] = $module;
        }
        else {
          $export_form = drupal_get_form('ctools_export_form', $module, t('Place this in @file', array(
            '@file' => $form_state['module'] . '.module',
          )));
          $output = drupal_render($export_form) . $output;
        }
      }
      $info = strtr("name = @module export module\n", array(
        '@module' => $form_state['module'],
      ));
      $info .= strtr("description = Export objects from CTools\n", array(
        '@module' => $form_state['values']['name'],
      ));
      foreach ($dependencies as $module => $junk) {
        $info .= "dependencies[] = {$module}\n";
      }
      $info .= "package = Chaos tool suite\n";
      $info .= "core = 7.x\n";
      if ($cli) {
        $file_data[$module_name . '.info'] = $info;
      }
      else {
        $export_form = drupal_get_form('ctools_export_form', $info, t('Place this in @file', array(
          '@file' => $form_state['module'] . '.info',
        )));
        $output = drupal_render($export_form) . $output;
      }
    }
    if ($cli) {
      return $file_data;
    }
    else {
      return $output;
    }
  }
  else {
    return t('There are no objects to be exported at this time.');
  }
}

/**
 * FAPI definition for the bulk exporter form.
 */
function bulk_export_export_form($form, &$form_state) {
  $files = system_rebuild_module_data();
  $form['additional_settings'] = array(
    '#type' => 'vertical_tabs',
  );
  $options = $tables = array();
  foreach ($form_state['exportables'] as $table => $list) {
    if (empty($list)) {
      continue;
    }
    foreach ($list as $id => $title) {
      $options[$table][$id] = array(
        $title,
      );
      $options[$table][$id]['#attributes'] = array(
        'class' => array(
          'bulk-selection',
        ),
      );
    }
    $module = $form_state['export_tables'][$table];
    $header = array(
      $table,
    );
    $module_name = $files[$module]->info['name'];
    $tables[] = $table;
    if (!isset($form[$module_name])) {
      $form[$files[$module]->info['name']] = array(
        '#type' => 'fieldset',
        '#group' => 'additional_settings',
        '#title' => $module_name,
      );
    }
    $form[$module_name]['tables'][$table] = array(
      '#prefix' => '<div class="export-container">',
      '#suffix' => '</div>',
      '#type' => 'tableselect',
      '#header' => $header,
      '#options' => $options[$table],
    );
  }
  $form['tables'] = array(
    '#type' => 'value',
    '#value' => $tables,
  );
  $form['name'] = array(
    '#type' => 'textfield',
    '#title' => t('Module name'),
    '#description' => t('Enter the module name to export code to.'),
  );
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Export'),
  );
  $form['#action'] = url('admin/structure/bulk-export/results');
  $form['#attached']['css'][] = drupal_get_path('module', 'bulk_export') . '/bulk_export.css';
  $form['#attached']['js'][] = drupal_get_path('module', 'bulk_export') . '/bulk_export.js';
  return $form;
}

/**
 * Process the bulk export submit form and make the results available.
 */
function bulk_export_export_form_submit($form, &$form_state) {
  $code = array();
  $name = empty($form_state['values']['name']) ? 'foo' : $form_state['values']['name'];
  $tables = $form_state['values']['tables'];
  foreach ($tables as $table) {
    $names = array_keys(array_filter($form_state['values'][$table]));
    if ($names) {
      natcasesort($names);
      ctools_export_to_hook_code($code, $table, $names, $name);
    }
  }
  $form_state['code'] = $code;
  $form_state['module'] = $name;
}

Functions

Namesort descending Description
bulk_export_export FAPI gateway to the bulk exporter.
bulk_export_export_form FAPI definition for the bulk exporter form.
bulk_export_export_form_submit Process the bulk export submit form and make the results available.
bulk_export_menu Implements hook_menu().
bulk_export_permission Implements hook_permission().