'fieldset',
'#title' => t('Status'),
'#collapsible' => FALSE,
);
if (variable_get('demo_reset_last', 0)) {
$reset_date = format_date(variable_get('demo_reset_last', 0));
}
else {
$reset_date = t('Never');
}
$form['status'][] = array(
'#value' => t('
Last reset: !date
', array('!date' => $reset_date)),
);
$fileconfig = demo_get_fileconfig();
$form['dump'] = array(
'#type' => 'fieldset',
'#title' => t('Dump settings'),
);
$form['dump']['demo_dump_path'] = array(
'#type' => 'textfield',
'#title' => t('Dump path'),
'#default_value' => $fileconfig['path'],
'#description' => t('Enter a writable directory where dump files of this demonstration site are stored, f.e. %files. The name of this site (e.g. %confpath) is automatically appended to this directory, if required.
Note: For security reasons you should store site dumps outside of the document root of your webspace!', array('%files' => file_directory_path() . '/demo', '%confpath' => $fileconfig['site'])),
'#required' => TRUE,
);
$form['#validate'][] = 'demo_admin_settings_validate';
return system_settings_form($form);
}
/**
* Form validation handler for demo_admin_settings().
*/
function demo_admin_settings_validate($form, &$form_state) {
if (!file_check_directory($form_state['values']['demo_dump_path'], FILE_CREATE_DIRECTORY)) {
form_set_error('demo_dump_path', t('The snapshot directory %directory could not be created.', array('%directory' => $form_state['values']['demo_dump_path'])));
}
}
/**
* Form builder to manage snapshots.
*/
function demo_manage_form() {
$form['dump'] = array(
'#type' => 'fieldset',
'#title' => t('Available snapshots'),
);
$form['dump'] += demo_get_dumps();
$form['delete'] = array(
'#type' => 'submit',
'#value' => t('Delete'),
'#submit' => array('demo_manage_delete_submit'),
);
return $form;
}
/**
* Delete button submit handler for demo_manage_form().
*/
function demo_manage_delete_submit($form, &$form_state) {
$form_state['redirect'] = 'admin/build/demo/delete/' . $form_state['values']['filename'];
}
/**
* Form builder to confirm deletion of a snapshot.
*/
function demo_delete_confirm(&$form_state, $filename) {
$fileconfig = demo_get_fileconfig($filename);
if (!file_exists($fileconfig['infofile'])) {
return drupal_access_denied();
}
$form['filename'] = array(
'#type' => 'value',
'#value' => $filename,
);
return confirm_form($form, t('Are you sure you want to delete the snapshot %title?', array('%title' => $filename)), 'admin/build/demo/manage', t('This action cannot be undone.'), t('Delete'));
}
/**
* Form submit handler for demo_delete_confirm().
*/
function demo_delete_confirm_submit($form, &$form_state) {
$files = demo_get_fileconfig($form_state['values']['filename']);
unlink($files['sqlfile']);
unlink($files['infofile']);
drupal_set_message(t('Snapshot %title has been deleted.', array('%title' => $form_state['values']['filename'])));
$form_state['redirect'] = 'admin/build/demo/manage';
}
/**
* Form builder to create a new snapshot.
*/
function demo_dump_form() {
$form['dump']['filename'] = array(
'#title' => t('File name'),
'#type' => 'textfield',
'#autocomplete_path' => 'demo/autocomplete',
'#required' => TRUE,
'#maxlength' => 128,
'#description' => t('Enter the snapshot file name without file extension. Allowed characters are a-z, 0-9, dashes ("-"), underscores ("_") and dots.'),
);
$form['dump']['description'] = array(
'#title' => t('Description'),
'#type' => 'textarea',
'#rows' => 2,
'#description' => t('Optionally enter a description for this snapshot here. If no description is given and a snapshot with the same filename already exists, the previous description is used.'),
);
$form['dump']['tables'] = array('#type' => 'value', '#value' => demo_enum_tables());
return confirm_form($form, t('Are you sure you want to create a new snapshot?'), 'admin/build/demo', t('If the above filename already exists, creating a new snapshot will overwrite the existing snapshot. This action cannot be undone.'), t('Create'), t('Cancel'));
}
/**
* Form submit handler for demo_dump_form().
*/
function demo_dump_form_submit($form, &$form_state) {
if ($fileconfig = _demo_dump($form_state['values'])) {
drupal_set_message(t('Successfully created snapshot %filename.', array('%filename' => $fileconfig['sqlfile'])));
}
$form_state['redirect'] = 'admin/build/demo/manage';
}
/**
* Create a new snapshot.
*
* @param $options
* A structured array of snapshot options:
* - filename: The base output filename, without extension.
* - default: Whether to set this dump as new default snapshot.
* - description: A description for the snapshot. If a snapshot with the same
* name already exists and this is left blank, the new snapshot will reuse
* the existing description.
* - tables: An array of tables to dump, keyed by table name (including table
* prefix, if any). The value is an array of dump options:
* - schema: Whether to dump the table schema.
* - data: Whether to dump the table data.
*/
function _demo_dump($options) {
// Increase PHP's max_execution_time for large dumps.
@set_time_limit(600);
// Generate the info file.
$info = demo_set_info($options);
if (!$info) {
return FALSE;
}
// Allow other modules to alter the dump options.
$fileconfig = demo_get_fileconfig($info['filename']);
drupal_alter('demo_dump', $options, $info, $fileconfig);
// Perform database dump.
if (!demo_dump_db($fileconfig['sqlfile'], $options)) {
return FALSE;
}
// Adjust file permissions.
if (function_exists('drupal_chmod')) {
drupal_chmod($fileconfig['infofile']);
drupal_chmod($fileconfig['sqlfile']);
}
else {
chmod($fileconfig['infofile'], 0664);
chmod($fileconfig['sqlfile'], 0664);
}
// Allow other modules to act on successful dumps.
module_invoke_all('demo_dump', $options, $info, $fileconfig);
return $fileconfig;
}
/**
* Form builder to reset site to a snapshot.
*/
function demo_reset_confirm() {
$form['dump'] = array(
'#type' => 'fieldset',
'#title' => t('Available snapshots'),
);
$form['dump'] += demo_get_dumps();
return confirm_form($form, t('Are you sure you want to reset the site?'), 'admin/build/demo', t('Resetting the site will overwrite all changes that have been made to this Drupal installation since the chosen snapshot.
THIS ACTION CANNOT BE UNDONE!
'), t('Reset'), t('Cancel'));
}
/**
* Form submit handler for demo_reset_confirm().
*/
function demo_reset_confirm_submit($form, &$form_state) {
// Reset site to chosen snapshot.
_demo_reset($form_state['values']['filename']);
$form_state['redirect'] = 'admin/build/demo';
}
/**
* Reset site using snapshot.
*
* @param $filename
* Base snapshot filename, without extension.
* @param $verbose
* Whether to output status messages.
*/
function _demo_reset($filename, $verbose = TRUE) {
// Load database specific functions.
if (!demo_load_include()) {
return FALSE;
}
// Increase PHP's max_execution_time for large dumps.
@set_time_limit(600);
$fileconfig = demo_get_fileconfig($filename);
if (!file_exists($fileconfig['sqlfile']) || !($fp = fopen($fileconfig['sqlfile'], 'r'))) {
if ($verbose) {
drupal_set_message(t('Unable to open dump file %filename.', array('%filename' => $fileconfig['sqlfile'])), 'error');
}
watchdog('demo', 'Unable to open dump file %filename.', array('%filename' => $fileconfig['sqlfile']), WATCHDOG_ERROR);
return FALSE;
}
// Load any database information in front of reset.
$info = demo_get_info($fileconfig['infofile']);
module_invoke_all('demo_reset_before', $filename, $info, $fileconfig);
// Temporarily disable foreign key checks for the time of import and before
// dropping existing tables. Foreign key checks should already be re-enabled
// as one of the last operations in the SQL dump file.
// @see demo_dump_db()
db_query("SET FOREIGN_KEY_CHECKS = 0;");
// Drop tables.
$is_version_1_0_dump = version_compare($info['version'], '1.1', '<');
$watchdog = db_prefix_tables('{watchdog}');
foreach (demo_enum_tables() as $table => $dump_options) {
// Skip watchdog, except for legacy dumps that included the watchdog table
if ($table != $watchdog || $is_version_1_0_dump) {
db_query("DROP TABLE $table");
}
}
// Load data from snapshot.
$success = TRUE;
$query = '';
$new_line = TRUE;
while (!feof($fp)) {
// Better performance on PHP 5.2.x when leaving out buffer size to
// fgets().
$data = fgets($fp);
if ($data === FALSE) {
break;
}
// Skip empty lines (including lines that start with a comment).
if ($new_line && ($data == "\n" || !strncmp($data, '--', 2) || !strncmp($data, '#', 1))) {
continue;
}
$query .= $data;
$len = strlen($data);
if ($data[$len - 1] == "\n") {
if ($data[$len - 2] == ';') {
// Reached the end of a query, now execute it.
if (!_db_query($query, FALSE)) {
$success = FALSE;
}
$query = '';
}
$new_line = TRUE;
}
else {
// Continue adding data from the same line.
$new_line = FALSE;
}
}
fclose($fp);
if ($success) {
if ($verbose) {
drupal_set_message(t('Successfully restored database from %filename.', array('%filename' => $fileconfig['sqlfile'])));
}
watchdog('demo', 'Successfully restored database from %filename.', array('%filename' => $fileconfig['sqlfile']), WATCHDOG_NOTICE);
// Allow other modules to act on successful resets.
module_invoke_all('demo_reset', $filename, $info, $fileconfig);
}
else {
if ($verbose) {
drupal_set_message(t('Failed restoring database from %filename.', array('%filename' => $fileconfig['sqlfile'])), 'error');
}
watchdog('demo', 'Failed restoring database from %filename.', array('%filename' => $fileconfig['sqlfile']), WATCHDOG_ERROR);
}
// Save request time of last reset, but not during re-installation via
// demo_profile.
if (!defined('MAINTENANCE_MODE') || MAINTENANCE_MODE !== 'install') {
variable_set('demo_reset_last', $_SERVER['REQUEST_TIME']);
}
return $success;
}
function demo_get_fileconfig($filename = 'demo_site') {
$fileconfig = array();
// Build dump path.
$fileconfig['path'] = variable_get('demo_dump_path', file_directory_path() . '/demo');
$fileconfig['dumppath'] = $fileconfig['path'];
// Append site name if it is not included in file_directory_path() and if not
// storing files in sites/all/files.
$fileconfig['site'] = str_replace('sites', '', conf_path());
if (strpos($fileconfig['path'], conf_path()) === FALSE && strpos($fileconfig['path'], '/all/') === FALSE) {
$fileconfig['dumppath'] .= $fileconfig['site'];
}
// Check if directory exists.
file_check_directory($fileconfig['path'], FILE_CREATE_DIRECTORY, 'path');
if (!file_check_directory($fileconfig['dumppath'], FILE_CREATE_DIRECTORY, 'path')) {
return FALSE;
}
// Protect dump files.
$htaccess = $fileconfig['path'] . "/.htaccess";
if (!is_file($htaccess)) {
$htaccess_lines = "# demo.module snapshots\n# Do not let the webserver serve anything under here!\n#\nDeny from all\n";
if (($fp = fopen($htaccess, 'w')) && fputs($fp, $htaccess_lines)) {
fclose($fp);
if (function_exists('drupal_chmod')) {
drupal_chmod($htaccess);
}
else {
chmod($htaccess, 0664);
}
}
}
// Build SQL filename.
$fileconfig['sql'] = $filename . '.sql';
$fileconfig['sqlfile'] = $fileconfig['dumppath'] . '/' . $fileconfig['sql'];
// Build info filename.
$fileconfig['info'] = $filename . '.info';
$fileconfig['infofile'] = $fileconfig['dumppath'] . '/' . $fileconfig['info'];
return $fileconfig;
}
/**
* Load database specific functions.
*/
function demo_load_include() {
global $db_type;
$engine = ($db_type == 'mysqli' ? 'mysql' : $db_type);
if (module_load_include('inc', 'demo', 'database_' . $engine . '_dump') === FALSE) {
drupal_set_message(t('@engine support not implemented yet.', array('@engine' => ucfirst($engine))), 'error');
return FALSE;
}
return TRUE;
}
function demo_get_dumps() {
$fileconfig = demo_get_fileconfig();
// Fetch list of available info files
$files = file_scan_directory($fileconfig['dumppath'], '.info$');
foreach ($files as $file => $object) {
$files[$file]->filemtime = filemtime($file);
$files[$file]->filesize = filesize(substr($file, 0, -4) . 'sql');
}
// Sort snapshots by date (ascending file modification time)
uasort($files, create_function('$a, $b', 'return ($a->filemtime < $b->filemtime);'));
$options = array();
// Forms API does not pass selected value of individual radio buttons,
// so we manually insert an internal form value here.
$options['filename'] = array(
'#type' => 'value',
'#required' => TRUE,
'#title' => t('Snapshot'),
);
foreach ($files as $filename => $file) {
// Build basic file info
$files[$filename] = (array) $file;
$info = demo_get_info($filename);
// Convert file info for Forms API
$option = array(
'#type' => 'radio',
'#name' => 'filename',
'#title' => check_plain($info['filename']) . ' (' . format_date($file->filemtime, 'small') . ', ' . format_size($file->filesize) . ')',
'#description' => '',
'#return_value' => $info['filename'],
'#file' => $file,
'#info' => $info,
'#attributes' => array('onclick' => "jQuery('.description', this.parentNode.parentNode).slideToggle();"),
);
if (!empty($info['description'])) {
$option['#description'] .= '' . $info['description'] . '
';
}
$targs = array(
'@info-file-url' => url('demo/download/' . $file->name . '/info'),
'@sql-file-url' => url('demo/download/' . $file->name . '/sql'),
);
$option['#description'] .= '' . t('Download: .info file, .sql file', $targs) . '
';
if (count($info['modules']) > 1) {
// Remove required core modules and obvious modules from module list.
$info['modules'] = array_diff($info['modules'], array('block', 'filter', 'node', 'system', 'user', 'demo'));
// Sort module list alphabetically.
sort($info['modules']);
$option['#description'] .= t('Modules: ') . implode(', ', $info['modules']);
}
$options[$info['filename']] = $option;
}
// Attach stylesheet to initially hide descriptions
drupal_add_js("$('div.form-item div.description', $('form')).hide();", 'inline', 'footer');
return $options;
}
function demo_get_info($filename, $field = NULL) {
$info = array();
if (file_exists($filename)) {
$info = parse_ini_file($filename);
if (isset($info['modules'])) {
$info['modules'] = explode(" ", $info['modules']);
}
else {
$info['modules'] = NULL;
}
if (!isset($info['version'])) {
$info['version'] = '1.0';
}
}
if (isset($field)) {
return isset($info[$field]) ? $info[$field] : NULL;
}
else {
return $info;
}
}
function demo_set_info($values = NULL) {
if (isset($values['filename']) && is_array($values)) {
// Check for valid filename
if (!preg_match('/^[-_\.a-zA-Z0-9]+$/', $values['filename'])) {
drupal_set_message(t('Dump filename %title must contain alphanumeric characters, dots, dashes and underscores only. Other characters, including blanks (spaces), are not allowed.', array('%title' => $values['filename'])), 'error');
return FALSE;
}
if (!empty($values['description'])) {
// parse_ini_file() doesn't allow certain characters in description
$s = array("\r\n", "\r", "\n", '"');
$r = array(' ', ' ', ' ', "'");
$values['description'] = str_replace($s, $r, $values['description']);
}
else {
// If new description is empty, try to use previous description.
$old_file = demo_get_fileconfig($values['filename']);
$old_description = demo_get_info($old_file['infofile'], 'description');
if (!empty($old_description)) {
$values['description'] = $old_description;
}
}
// Set values
$infos = array();
$infos['filename'] = $values['filename'];
$infos['description'] = '"' . $values['description'] . '"';
$infos['modules'] = implode(' ', module_list());
$infos['version'] = DEMO_DUMP_VERSION;
// Write information to .info file
$fileconfig = demo_get_fileconfig($values['filename']);
$infofile = fopen($fileconfig['infofile'], 'w');
foreach ($infos as $key => $info) {
fwrite($infofile, $key . ' = ' . $info . "\n");
}
fclose($infofile);
return $infos;
}
}
/**
* Returns a list of tables in the active database.
*
* Only returns tables whose prefix matches the configured one (or ones, if
* there are multiple).
*/
function demo_enum_tables() {
global $db_prefix;
$tables = array();
// Load database specific functions.
if (!demo_load_include()) {
return FALSE;
}
// Create a regex that matches the table prefix(es).
if (is_array($db_prefix)) {
$rx = '/^' . implode('|', array_filter($db_prefix)) . '/';
}
else if ($db_prefix != '') {
$rx = '/^' . $db_prefix . '/';
}
// Query the database engine for the table list.
$result = _demo_enum_tables();
while ($table = db_fetch_array($result)) {
$table = reset($table);
if (is_array($db_prefix)) {
// Check if table name matches a configured prefix.
if (preg_match($rx, $table, $matches)) {
$table_prefix = $matches[0];
$plain_table = substr($table, strlen($table_prefix));
if ($db_prefix[$plain_table] == $table_prefix || $db_prefix['default'] == $table_prefix) {
$tables[$table] = array('schema' => TRUE, 'data' => TRUE);
}
}
}
else if ($db_prefix != '') {
if (preg_match($rx, $table)) {
$tables[$table] = array('schema' => TRUE, 'data' => TRUE);
}
}
else {
$tables[$table] = array('schema' => TRUE, 'data' => TRUE);
}
}
// Apply default exclude list.
$excludes = array(
// Core
'{cache}',
'{cache_block}',
'{cache_content}',
'{cache_filter}',
'{cache_form}',
'{cache_menu}',
'{cache_page}',
'{cache_update}',
'{watchdog}',
// CTools
'{ctools_object_cache}',
// Drupal Administration Menu
'{cache_admin_menu}',
// Panels
'{panels_object_cache}',
// Views
'{cache_views}',
'{cache_views_data}',
'{views_object_cache}',
);
foreach (array_map('db_prefix_tables', $excludes) as $table) {
if (isset($tables[$table])) {
$tables[$table]['data'] = FALSE;
}
}
return $tables;
}
/**
* Retrieve a pipe delimited string of autocomplete suggestions for existing snapshots.
*/
function demo_autocomplete($string = '') {
$matches = array();
if ($string && $fileconfig = demo_get_fileconfig()) {
$string = preg_quote($string);
$files = file_scan_directory($fileconfig['dumppath'], $string . '.*\.info$');
foreach ($files as $file) {
$matches[$file->name] = check_plain($file->name);
}
}
drupal_json($matches);
}
/**
* Transfer (download) a snapshot file.
*
* @param $filename
* The snapshot filename to transfer.
* @param $type
* The file type, i.e. extension to transfer.
*
* @todo Allow to download an bundled archive of snapshot files.
*/
function demo_download($filename, $type) {
$fileconfig = demo_get_fileconfig($filename);
if (!isset($fileconfig[$type . 'file']) || !file_exists($fileconfig[$type . 'file'])) {
return MENU_NOT_FOUND;
}
// Force the client to re-download and trigger a file save download.
$headers = array(
'Cache-Control: private',
'Content-Type: application/octet-stream',
'Content-Length: ' . filesize($fileconfig[$type . 'file']),
'Content-Disposition: attachment, filename=' . $fileconfig[$type],
);
file_transfer($fileconfig[$type . 'file'], $headers);
}