ds.tools.inc in Display Suite 6.3
Same filename and directory in other branches
Tools for Display suite like export & import.
File
includes/ds.tools.incView source
<?php
/**
* @file
* Tools for Display suite like export & import.
*/
/**
* Import functionality.
*/
function ds_import($form_state) {
$form = array();
$form['import'] = array(
'#title' => t('Import display settings'),
'#description' => t('Paste data to import field settings. Do not include the function declaration from the export. Note: only display settings can be imported here. <strong>Warning: existing data will be overwritten!</strong>'),
'#type' => 'textarea',
'#cols' => 60,
'#default_value' => '',
'#required' => TRUE,
'#rows' => 10,
);
$form['submit'] = array(
'#type' => 'submit',
'#value' => t('Import'),
);
return $form;
}
/**
* Import submit function.
*/
function ds_import_submit($form_id, &$form_state) {
$error = FALSE;
ob_start();
eval($form_state['values']['import']);
ob_end_clean();
// Validate the data. $data variable comes from the eval() function above.
if (!is_array($data)) {
$error = TRUE;
drupal_set_message(t('Data string is not an array.'), 'error');
}
// All ok, let's import.
if ($error == FALSE) {
ds_import_data($data, TRUE, TRUE);
}
}
/**
* Import data function.
*
* @param array $data A complete data array with settings.
* @param boolean $dsm Whether to output drupal messages.
* @param boolean $override Whether to override existing settings or not.
* @param string $revert_module The module to revert.
* @param string $revert_type The object type to revert.
* @param string $revert_build_mode The build mode to revert.
*/
function ds_import_data($data, $dsm = TRUE, $override = TRUE, $revert_module = '', $revert_type = '', $revert_build_mode = '') {
foreach ($data as $module => $value) {
foreach ($value as $type => $settings) {
if ($dsm) {
drupal_set_message(t('Saved display settings for @module and @type', array(
'@module' => $module,
'@type' => $type,
)));
}
foreach ($settings as $build_mode => $setting) {
$old_settings = ds_get_settings($module, $type, $build_mode);
// Override no matter what. This comes from the import settings screen.
if ($override) {
$settings[$build_mode]['status'] = DS_SETTINGS_UI;
}
else {
if (isset($old_settings['status']) && $old_settings['status'] == DS_SETTINGS_OVERRIDDEN) {
if ($module == $revert_module && $type == $revert_type && $build_mode == $revert_build_mode) {
$settings[$build_mode]['status'] = DS_SETTINGS_DEFAULT;
}
else {
$settings[$build_mode] = $old_settings;
}
}
else {
$settings[$build_mode]['status'] = DS_SETTINGS_DEFAULT;
}
}
// Remove old settings.
db_query("DELETE FROM {ds_settings} WHERE build_mode = '%s' AND module = '%s' AND type = '%s'", $build_mode, $module, $type);
// Get settings.
$store = $settings[$build_mode];
// Iterate over fields and ditch those which are hidden.
// This is for sites have upgraded but haven't re-exported their settings.
foreach ($store['fields'] as $field_key => $field_value) {
if ($field_value['region'] == 'disabled') {
unset($store['fields'][$field_key]);
}
}
// Save new settings.
$record = new stdClass();
$record->module = $module;
$record->type = $type;
$record->build_mode = $build_mode;
$record->settings = serialize($store);
drupal_write_record('ds_settings', $record);
}
// Act on saving these settings.
module_invoke_all('ds_settings_import', $module, $type, $settings);
}
}
}
/**
* Export functionality.
*/
function ds_export(&$form_state) {
$form = array();
$options = array();
$ds_variables = array();
$step = isset($form_state['storage']['step']) ? $form_state['storage']['step'] + 1 : 1;
switch ($step) {
// Show selection form.
case 1:
foreach (module_implements('ds_api') as $module) {
$api_info = ds_api_info($module);
$module = $api_info['module'];
// Content types.
foreach ($api_info['types']() as $tkey => $type) {
$global_exclude = variable_get($module . '_type_' . $tkey, FALSE);
// Views displays is special case.
if ($module == 'vd') {
if ($global_exclude == TRUE) {
continue;
}
}
$options[$module . '-' . $type->type] = check_plain($type->name);
if ($global_exclude == TRUE) {
$ds_variables[] = $module . '_type_' . $tkey;
}
}
// Plugins.
$plugins = variable_get($module . '_plugin_settings', array());
if (!empty($plugins)) {
$ds_variables[] = $module . '_plugin_settings';
}
// Build modes
$build_modes = variable_get($module . '_build_modes', array());
if (!empty($build_modes)) {
$ds_variables[] = $module . '_build_modes';
}
// Build modes exclude.
$ds_variables[] = $module . '_buildmodes_exclude';
}
if (!empty($options)) {
$form['#prefix'] = t('Select one or more types to export.');
$form['types'] = array(
'#title' => 'Types',
'#type' => 'checkboxes',
'#options' => $options,
'#required' => TRUE,
);
$form['module'] = array(
'#title' => t('Module'),
'#type' => 'textfield',
'#description' => t('Fill in a name for your module (optional)'),
);
}
else {
$form['info'] = array(
'#type' => 'item',
'#value' => t('No object types found to export.'),
);
}
break;
// Show export.
case 2:
$export = ds_export_build($form_state['values']['types']);
if (!empty($export['exclude']['fields'])) {
drupal_set_message(t('Following fields were not included in the export because they are default fields: %fields', array(
'%fields' => implode(', ', $export['exclude']['fields']),
)));
}
if (!empty($export['ds'])) {
$module_name = !empty($form_state['values']['module']) ? $form_state['values']['module'] : 'YOURMODULENAME';
$form['export_hooks'] = array(
'#title' => t('Display suite hooks'),
'#description' => t('These are the hooks you need to implement for default data. You are free to return all data in this hook, this is just a suggestion.'),
'#type' => 'textarea',
'#cols' => 60,
'#rows' => 8,
'#value' => "<?php\n",
);
$form['export_data'] = array(
'#title' => t('Display suite export data'),
'#description' => t('You can paste this data into @module_name/@module_name.ds_default.inc. If you only want to store this data to import later, omit the function declaration.', array(
'@module_name' => $module_name,
)),
'#value' => "<?php\n/**\n * @file\n * Display suite default settings.\n */\n",
'#type' => 'textarea',
'#cols' => 60,
'#rows' => 15,
);
// Display settings.
if (isset($export['ds']['settings'])) {
$export_value = ds_var_export($export['ds']['settings']);
$form['export_hooks']['#value'] .= "\n/**\n * Implementation of hook_ds_default_settings().\n */\nfunction " . $module_name . "_ds_default_settings() {\n include_once('" . $module_name . ".ds_default.inc');\n return _" . $module_name . "_ds_default_settings();\n}\n";
$form['export_data']['#value'] .= "\nfunction _" . $module_name . "_ds_default_settings() {\n \$data = " . $export_value . ";\n return \$data;\n}\n";
}
// Fields.
if (isset($export['ds']['fields'])) {
if (!empty($export['ds']['fields'])) {
$export_value = ds_var_export($export['ds']['fields']);
$form['export_hooks']['#value'] .= "\n/**\n * Implementation of hook_ds_fields().\n */\nfunction " . $module_name . "_ds_fields() {\n include_once('" . $module_name . ".ds_default.inc');\n return _" . $module_name . "_ds_fields();\n}\n";
$form['export_data']['#value'] .= "\nfunction _" . $module_name . "_ds_fields() {\n \$data = " . $export_value . ";\n return \$data;\n}\n";
}
}
}
else {
$form['info'] = array(
'#type' => 'item',
'#value' => t('No settings found to export.'),
);
}
break;
}
if ($step == 1 && !empty($options)) {
$form['submit'] = array(
'#type' => 'submit',
'#value' => t('Export'),
);
if (!empty($ds_variables)) {
$form['other'] = array(
'#type' => 'item',
'#value' => t('Other variables you might consider to have in code (likely your install file): %variables. You can look this up in your database or use <a href="http://drupal.org/project/variable_dump">http://drupal.org/project/variable_dump</a> to create variable exports.', array(
'%variables' => implode(', ', $ds_variables),
)),
);
}
}
$form['step'] = array(
'#type' => 'value',
'#value' => $step,
);
return $form;
}
/**
* Build the export variable.
*/
function ds_export_build($values) {
$return = array();
foreach ($values as $otype => $value) {
if ($otype === $value) {
list($module, $type) = explode('-', $value);
// Display settings.
$settings = array();
$records = db_query("SELECT * FROM {ds_settings} WHERE module = '%s' AND type = '%s'", $module, $type);
while ($row = db_fetch_object($records)) {
$settings[$row->build_mode] = unserialize($row->settings);
}
if (!empty($settings)) {
foreach ($settings as $build_mode => $setting) {
$settings[$build_mode]['status'] = DS_SETTINGS_DEFAULT;
}
$return['ds']['settings'][$module][$type] = $settings;
}
// Fields.
$fields = variable_get($module . '_fields', array());
if (!empty($fields)) {
// We don't export overridden fields, unset them if necessary.
foreach ($fields as $key => $field) {
if ($field['status'] == DS_FIELD_STATUS_OVERRIDDEN) {
unset($fields[$key]);
$return['exclude']['fields'][] = $field['title'];
}
elseif ($field['status'] == DS_FIELD_STATUS_CUSTOM) {
$fields[$key]['status'] = DS_FIELD_STATUS_DEFAULT;
}
}
if (!empty($fields)) {
$return['ds']['fields'][$module] = $fields;
}
}
}
}
return $return;
}
/**
* Export submit function.
*/
function ds_export_submit($form, &$form_state) {
$form_state['rebuild'] = TRUE;
$form_state['storage']['step'] = $form_state['values']['step'];
}
/**
* Revert form.
*
* @param string $module The name of the module.
* @param string $object_type The object type name.
* @param string $build_mode The build mode.
*/
function ds_revert_form($form_state, $module = '', $type = '', $build_mode = '') {
$display_settings = ds_get_settings($module, $type, $build_mode);
if (!empty($display_settings) && isset($display_settings['status']) && $display_settings['status'] == DS_SETTINGS_OVERRIDDEN) {
$question = t('Are you sure you want to revert the display settings for %module, %type and %build_mode. This will bring back the default settings and any changes you have done will be lost.', array(
'%module' => $module,
'%type' => $type,
'%build_mode' => $build_mode,
));
$path = DS_PATH_LAYOUT;
$form['#module'] = $module;
$form['#object_type'] = $type;
$form['#build_mode'] = $build_mode;
$form['#path'] = $path;
return confirm_form($form, $question, $path);
}
else {
drupal_set_message(t('Variables not found.'));
drupal_goto(DS_PATH_BASE);
}
}
/**
* Revert form submit.
*/
function ds_revert_form_submit($form, &$form_state) {
drupal_set_message(t('Display settings for %module, %type and %build_mode have been reverted.', array(
'%module' => $form['#module'],
'%type' => $form['#object_type'],
'%build_mode' => $form['#build_mode'],
)));
ds_import_default_data($form['#module'], $form['#object_type'], $form['#build_mode']);
$form_state['redirect'] = $form['#path'];
}
/**
* Nice var exporter, based on Views.
*/
function ds_var_export($var, $prefix = ' ', $init = TRUE, $indent = ' ') {
if (is_array($var)) {
if (empty($var)) {
$output = 'array()';
}
else {
$prefix .= ' ';
$old = $indent;
$indent .= ' ';
$output = "array(\n";
foreach ($var as $key => $value) {
$output .= "{$indent}'{$key}' => " . ds_var_export($value, $prefix, FALSE, $indent) . ",\n";
}
$indent = $old;
$output .= "{$indent})";
}
}
elseif (is_bool($var)) {
$output = $var ? 'TRUE' : 'FALSE';
}
elseif (is_string($var) && strpos($var, "\n") !== FALSE) {
// Replace line breaks in strings with a token for replacement
// at the very end. This protects multi-line strings from
// unintentional indentation.
$var = str_replace("\n", "***BREAK***", $var);
$output = var_export($var, TRUE);
}
else {
$output = var_export($var, TRUE);
}
if ($init) {
$output = str_replace("***BREAK***", "\n", $output);
}
return $output;
}Functions
Name |
Description |
|---|---|
| ds_export | Export functionality. |
| ds_export_build | Build the export variable. |
| ds_export_submit | Export submit function. |
| ds_import | Import functionality. |
| ds_import_data | Import data function. |
| ds_import_submit | Import submit function. |
| ds_revert_form | Revert form. |
| ds_revert_form_submit | Revert form submit. |
| ds_var_export | Nice var exporter, based on Views. |