'. t('The upload module allows users to upload files to the site. The ability to upload files to a site is important for members of a community who want to share work. It is also useful to administrators who want to keep uploaded files connected to a node or page.') .'

'; $output .= '

'. t('Users with the upload files permission can upload attachments. You can choose which post types can take attachments on the content types settings page. Each user role can be customized for the file size of uploads, and the dimension of image files.') .'

'; $output .= t('

You can

', array('%admin-user-configure' => url('admin/user/configure'), '%admin-node-configure' => url('admin/node/configure'), '%admin-settings' => url('admin/settings'))); $output .= '

'. t('For more information please read the configuration and customization handbook Upload page.', array('%upload' => 'http://drupal.org/handbook/modules/upload/')) .'

'; return $output; case 'admin/modules#description': return t('Allows users to upload and attach files to content.'); case 'admin/settings/upload': return t('

Users with the upload files permission can upload attachments. You can choose which post types can take attachments on the content types settings page.

', array('%permissions' => url('admin/access'), '%types' => url('admin/settings/content-types'))); } } /** * Implementation of hook_perm(). */ function upload_perm() { return array('upload files', 'view uploaded files'); } /** * Implementation of hook_link(). */ function upload_link($type, $node = 0, $main = 0) { $links = array(); // Display a link with the number of attachments if ($main && $type == 'node' && is_array($node->files) && user_access('view uploaded files')) { $num_files = 0; foreach ($node->files as $file) { if ($file->list) { $num_files++; } } if ($num_files) { $links[] = l(format_plural($num_files, '1 attachment', '%count attachments'), "node/$node->nid", array('title' => t('Read full article to view attachments.')), NULL, 'attachments'); } } return $links; } /** * Implementation of hook_menu(). */ function upload_menu($may_cache) { $items = array(); if ($may_cache) { $items[] = array( 'path' => 'upload/js', 'callback' => 'upload_js', 'access' => user_access('upload files'), 'type' => MENU_CALLBACK ); } else { // Add handlers for previewing new uploads. if ($_SESSION['file_previews']) { foreach ($_SESSION['file_previews'] as $fid => $file) { $filename = file_create_filename($file->filename, file_create_path()); if (variable_get('file_downloads', FILE_DOWNLOADS_PUBLIC) == FILE_DOWNLOADS_PRIVATE) { // strip file_directory_path() from filename. @see file_create_url if (strpos($filename, file_directory_path()) !== false) { $filename = trim(substr($filename, strlen(file_directory_path())), '\\/'); } $filename = 'system/files/' . $filename; } $items[] = array( 'path' => $filename, 'title' => t('file download'), 'callback' => 'upload_download', 'access' => user_access('view uploaded files'), 'type' => MENU_CALLBACK ); $_SESSION['file_previews'][$fid]->_filename = $filename; } } } return $items; } function upload_settings() { $form['settings_general'] = array('#type' => 'fieldset', '#title' => t('General settings')); $form['settings_general']['upload_max_resolution'] = array( '#type' => 'textfield', '#title' => t('Maximum resolution for uploaded images'), '#default_value' => variable_get('upload_max_resolution', 0), '#size' => 15, '#maxlength' => 10, '#description' => t('The maximum allowed image size expressed as WIDTHxHEIGHT (e.g. 640x480). Set to 0 for no restriction.') ); $form['settings_general']['upload_list_default'] = array('#type' => 'select', '#title' => t('List files by default'), '#default_value' => variable_get('upload_list_default',1), '#options' => array( 0 => t('No'), 1 => t('Yes') ), '#description' => t('Set whether files attached to nodes are listed or not in the node view by default.'), ); $roles = user_roles(0, 'upload files'); foreach ($roles as $rid => $role) { $form["settings_role_$rid"] = array('#type' => 'fieldset', '#title' => t('Settings for %role', array('%role' => theme('placeholder', $role))), '#collapsible' => TRUE, '#collapsed' => TRUE); $form["settings_role_$rid"]["upload_extensions_$rid"] = array( '#type' => 'textfield', '#title' => t('Permitted file extensions'), '#default_value' => variable_get("upload_extensions_$rid", "jpg jpeg gif png txt html doc xls pdf ppt pps"), '#maxlength' => 255, '#description' => t('Extensions that users in this role can upload. Separate extensions with a space and do not include the leading dot.') ); $form["settings_role_$rid"]["upload_uploadsize_$rid"] = array( '#type' => 'textfield', '#title' => t('Maximum file size per upload'), '#default_value' => variable_get("upload_uploadsize_$rid", 1), '#size' => 5, '#maxlength' => 5, '#description' => t('The maximum size of a file a user can upload (in megabytes).') ); $form["settings_role_$rid"]["upload_usersize_$rid"] = array( '#type' => 'textfield', '#title' => t('Total file size per user'), '#default_value' => variable_get("upload_usersize_$rid", 10), '#size' => 5, '#maxlength' => 5, '#description' => t('The maximum size of all files a user can have on the site (in megabytes).') ); } return $form; } function upload_download() { foreach ($_SESSION['file_previews'] as $file) { if ($file->_filename == $_GET['q']) { file_transfer($file->filepath, array('Content-Type: '. mime_header_encode($file->filemime), 'Content-Length: '. $file->filesize)); } } } function upload_file_download($file) { if (user_access('view uploaded files')) { $file = file_create_path($file); $result = db_query("SELECT f.* FROM {files} f WHERE filepath = '%s'", $file); if ($file = db_fetch_object($result)) { $node = node_load($file->nid); if (node_access('view', $node)) { $name = mime_header_encode($file->filename); $type = mime_header_encode($file->filemime); // Serve images and text inline for the browser to display rather than download. $disposition = ereg('^(text/|image/)', $file->filemime) ? 'inline' : 'attachment'; return array('Content-Type: '. $type .'; name='. $name, 'Content-Length: '. $file->filesize, 'Content-Disposition: '. $disposition .'; filename='. $name); } else { return -1; } } } else { return -1; } } /** * Save new uploads and attach them to the node object. * append file_previews to the node object as well. */ function _upload_prepare(&$node) { // Clean up old file previews if a post didn't get the user to this page. // i.e. the user left the edit page, because they didn't want to upload anything. if(count($_POST) == 0) { if (is_array($_SESSION['file_previews']) && count($_SESSION['file_previews'])) { foreach($_SESSION['file_previews'] as $fid => $file) { file_delete($file->filepath); } unset($_SESSION['file_previews']); } } // $_SESSION['file_submitted'] tracks the fid of the file submitted this page request. // form_builder sets the value of file->list to 0 for checkboxes added to a form after // it has been submitted. Since unchecked checkboxes have no return value and do not // get a key in _POST form_builder has no way of knowing the difference between a check // box that wasn't present on the last form build, and a checkbox that is unchecked. unset($_SESSION['file_submitted']); // Save new file uploads to tmp dir. if (($file = file_check_upload()) && user_access('upload files')) { global $user; // Scale image uploads. $file = _upload_image($file); $key = 'upload_'. count($_SESSION['file_previews']); $file->fid = $key; $file->source = $key; $file->list = variable_get('upload_list_default',1); $_SESSION['file_previews'][$key] = $file; // Store the uploaded fid for this page request in case of submit without // preview or attach. See earlier notes. $_SESSION['file_submitted'] = $key; } // Attach file previews to node object. if (is_array($_SESSION['file_previews']) && count($_SESSION['file_previews'])) { foreach($_SESSION['file_previews'] as $fid => $file) { $node->files[$fid] = $file; } } } function upload_form_alter($form_id, &$form) { if (isset($form['type'])) { if ($form['type']['#value'] .'_node_settings' == $form_id) { $form['workflow']['upload_'. $form['type']['#value']] = array( '#type' => 'radios', '#title' => t('Attachments'), '#default_value' => variable_get('upload_'. $form['type']['#value'], 1), '#options' => array(t('Disabled'), t('Enabled')), ); } $node = $form['#node']; if ($form['type']['#value'] .'_node_form' == $form_id && variable_get("upload_$node->type", TRUE) && user_access('upload files')) { drupal_add_js('misc/progress.js'); drupal_add_js('misc/upload.js'); $form['attachments'] = array( '#type' => 'fieldset', '#title' => t('File attachments'), '#collapsible' => TRUE, '#collapsed' => empty($node->files), '#description' => t('Changes made to the attachments are not permanent until you save this post. The first "listed" file will be included in RSS feeds.'), '#prefix' => '
', '#suffix' => '
', '#weight' => 30, ); $form['attachments'] += _upload_form($node); $form['#attributes']['enctype'] = 'multipart/form-data'; } } } function _upload_validate(&$node) { // Accumulator for disk space quotas. $filesize = 0; // Check if node->files exists, and if it contains something. if (is_array($node->files)) { // Update existing files with form data. foreach($node->files as $fid => $file) { // Convert file to object for compatability $file = (object)$file; // Validate new uploads. if (strpos($fid, 'upload') !== false && !$file->remove) { global $user; // Bypass validation for uid = 1. if ($user->uid != 1) { //Update filesize accumulator. $filesize += $file->filesize; // Validate file against all users roles. // Only denies an upload when all roles prevent it. $total_usersize = upload_space_used($user->uid) + $filesize; $error = array(); foreach ($user->roles as $rid => $name) { $extensions = variable_get("upload_extensions_$rid", 'jpg jpeg gif png txt html doc xls pdf ppt pps'); $uploadsize = variable_get("upload_uploadsize_$rid", 1) * 1024 * 1024; $usersize = variable_get("upload_usersize_$rid", 1) * 1024 * 1024; $regex = '/\.('. ereg_replace(' +', '|', preg_quote($extensions)) .')$/i'; if (!preg_match($regex, $file->filename)) { $error['extension']++; } if ($uploadsize && $file->filesize > $uploadsize) { $error['uploadsize']++; } if ($usersize && $total_usersize + $file->filesize > $usersize) { $error['usersize']++; } } $user_roles = count($user->roles); $valid = TRUE; if ($error['extension'] == $user_roles) { form_set_error('upload', t('The selected file %name can not be attached to this post, because it is only possible to attach files with the following extensions: %files-allowed.', array('%name' => theme('placeholder', $file->filename), '%files-allowed' => theme('placeholder', $extensions)))); $valid = FALSE; } elseif ($error['uploadsize'] == $user_roles) { form_set_error('upload', t('The selected file %name can not be attached to this post, because it exceeded the maximum filesize of %maxsize.', array('%name' => theme('placeholder', $file->filename), '%maxsize' => theme('placeholder', format_size($uploadsize))))); $valid = FALSE; } elseif ($error['usersize'] == $user_roles) { form_set_error('upload', t('The selected file %name can not be attached to this post, because the disk quota of %quota has been reached.', array('%name' => theme('placeholder', $file->filename), '%quota' => theme('placeholder', format_size($usersize))))); $valid = FALSE; } if (!$valid) { unset($node->files[$fid], $_SESSION['file_previews'][$fid]); file_delete($file->filepath); } } } } } } /** * Implementation of hook_nodeapi(). */ function upload_nodeapi(&$node, $op, $arg) { switch ($op) { case 'load': if (variable_get("upload_$node->type", 1) == 1) { $output['files'] = upload_load($node); } return $output; break; case 'prepare': _upload_prepare($node); break; case 'validate': _upload_validate($node); break; case 'view': if (is_array($node->files) && user_access('view uploaded files')) { $header = array(t('Attachment'), t('Size')); $rows = array(); $previews = array(); // Build list of attached files foreach ($node->files as $key => $file) { if ($file->list) { $rows[] = array( ''. check_plain($file->description ? $file->description : $file->filename) .'', format_size($file->filesize) ); // We save the list of files still in preview for later if (strpos($file->fid, 'upload') !== false) { $previews[] = $file; } } } // URLs to files being previewed are actually Drupal paths. When Clean // URLs are disabled, the two do not match. We perform an automatic // replacement from temporary to permanent URLs. That way, the author // can use the final URL in the body before having actually saved (to // place inline images for example). if (!variable_get('clean_url', 0)) { foreach ($previews as $file) { $old = file_create_filename($file->filename, file_create_path()); $new = url($old); $node->body = str_replace($old, $new, $node->body); $node->teaser = str_replace($old, $new, $node->teaser); } } $teaser = $arg; // Add the attachments list if (count($rows) && !$teaser) { $node->body .= theme('table', $header, $rows, array('id' => 'attachments')); } } break; case 'insert': case 'update': if (user_access('upload files')) { upload_save($node); } break; case 'delete': upload_delete($node); break; case 'delete revision': upload_delete_revision($node); break; case 'search result': return is_array($node->files) ? format_plural(count($node->files), '1 attachment', '%count attachments') : null; case 'rss item': if (is_array($node->files)) { $files = array(); foreach ($node->files as $file) { if ($file->list) { $files[] = $file; } } if (count($files) > 0) { // RSS only allows one enclosure per item $file = array_shift($files); return array(array('key' => 'enclosure', 'attributes' => array('url' => file_create_url($file->filepath), 'length' => $file->filesize, 'type' => $file->filemime))); } } return array(); } } /** * Determine how much disk space is occupied by a user's uploaded files. * * @param $uid * The integer user id of a user. * @return * The amount of disk space used by the user in bytes. */ function upload_space_used($uid) { return db_result(db_query('SELECT SUM(filesize) FROM {files} f INNER JOIN {node} n ON f.nid = n.nid WHERE n.uid = %d', $uid)); } /** * Determine how much disk space is occupied by uploaded files. * * @return * The amount of disk space used by uploaded files in bytes. */ function upload_total_space_used() { return db_result(db_query('SELECT SUM(filesize) FROM {files}')); } function upload_save($node) { if (!is_array($node->files)) { return; } foreach ($node->files as $fid => $file) { // Convert file to object for compatability $file = (object)$file; // Remove file. Process removals first since no further processing // will be required. if ($file->remove) { // Remove file previews... if (strpos($file->fid, 'upload') !== false) { file_delete($file->filepath); } // Remove managed files. else { db_query('DELETE FROM {file_revisions} WHERE fid = %d AND vid = %d', $fid, $node->vid); // Only delete a file if it isn't used by any revision $count = db_result(db_query('SELECT COUNT(fid) FROM {file_revisions} WHERE fid = %d', $fid)); if ($count < 1) { db_query('DELETE FROM {files} WHERE fid = %d', $fid); file_delete($file->filepath); } } } // New file upload elseif (strpos($file->fid, 'upload') !== false) { if ($file = file_save_upload($file, $file->filename)) { // Track the file which was submitted last, in case of a direct submission // without preview or attach. See notes in upload_prepare. if ($_SESSION['file_submitted'] == $file->fid) { $file->list = variable_get('upload_list_default',1); } $file->fid = db_next_id('{files}_fid'); db_query("INSERT INTO {files} (fid, nid, filename, filepath, filemime, filesize) VALUES (%d, %d, '%s', '%s', '%s', %d)", $file->fid, $node->nid, $file->filename, $file->filepath, $file->filemime, $file->filesize); db_query("INSERT INTO {file_revisions} (fid, vid, list, description) VALUES (%d, %d, %d, '%s')", $file->fid, $node->vid, $file->list, $file->description); } unset($_SESSION['file_previews'][$fid]); } // Create a new revision, as needed elseif ($node->old_vid && is_numeric($fid)) { db_query("INSERT INTO {file_revisions} (fid, vid, list, description) VALUES (%d, %d, %d, '%s')", $file->fid, $node->vid, $file->list, $file->description); } // Update existing revision else { db_query("UPDATE {file_revisions} SET list = %d, description = '%s' WHERE fid = %d AND vid = %d", $file->list, $file->description, $file->fid, $node->vid); } } } function upload_delete($node) { $files = array(); $result = db_query('SELECT * FROM {files} WHERE nid = %d', $node->nid); while ($file = db_fetch_object($result)) { $files[$file->fid] = $file; } foreach ($files as $fid => $file) { // Delete all file revision information associated with the node db_query('DELETE FROM {file_revisions} WHERE fid = %d', $fid); file_delete($file->filepath); } // Delete all files associated with the node db_query('DELETE FROM {files} WHERE nid = %d', $node->nid); } function upload_delete_revision($node) { if (is_array($node->files)) { foreach ($node->files as $file) { // Check if the file will be used after this revision is deleted $count = db_result(db_query('SELECT COUNT(fid) FROM {file_revisions} WHERE fid = %d', $file->fid)); // if the file won't be used, delete it if ($count < 2) { db_query('DELETE FROM {files} WHERE fid = %d', $file->fid); file_delete($file->filepath); } } } // delete the revision db_query('DELETE FROM {file_revisions} WHERE vid = %d', $node->vid); } function _upload_form($node) { $form['#theme'] = 'upload_form_new'; if (is_array($node->files) && count($node->files)) { $form['files']['#theme'] = 'upload_form_current'; $form['files']['#tree'] = TRUE; foreach ($node->files as $key => $file) { $description = "". file_create_url((strpos($file->fid,'upload') === false ? $file->filepath : file_create_filename($file->filename, file_create_path()))) .""; $form['files'][$key]['description'] = array('#type' => 'textfield', '#default_value' => (strlen($file->description)) ? $file->description : $file->filename, '#maxlength' => 256, '#description' => $description ); $form['files'][$key]['size'] = array('#type' => 'markup', '#value' => format_size($file->filesize)); $form['files'][$key]['remove'] = array('#type' => 'checkbox', '#default_value' => $file->remove); $form['files'][$key]['list'] = array('#type' => 'checkbox', '#default_value' => $file->list); $form['files'][$key]['filename'] = array('#type' => 'value', '#value' => $file->filename); $form['files'][$key]['filepath'] = array('#type' => 'value', '#value' => $file->filepath); $form['files'][$key]['filemime'] = array('#type' => 'value', '#value' => $file->filemime); $form['files'][$key]['filesize'] = array('#type' => 'value', '#value' => $file->filesize); $form['files'][$key]['fid'] = array('#type' => 'value', '#value' => $file->fid); } } if (user_access('upload files')) { $form['new']['upload'] = array('#type' => 'file', '#title' => t('Attach new file'), '#size' => 40); $form['new']['fileop'] = array('#type' => 'button', '#value' => t('Attach'), '#name'=> 'fileop', '#attributes' => array('id' => 'fileop')); // The class triggers the js upload behaviour. $form['fileop'] = array('#type' => 'hidden', '#value' => url('upload/js', NULL, NULL, TRUE), '#attributes' => array('class' => 'upload')); } // Needed for JS $form['current']['vid'] = array('#type' => 'hidden', '#value' => $node->vid); return $form; } function theme_upload_form_new($form) { $output .= '
' . "\n"; $output .= '
' . "\n"; $output .= form_render($form) . "\n"; $output .= "
\n"; $output .= "
\n"; return $output; } function theme_upload_form_current(&$form) { $header = array(t('Delete'), t('List'), t('Description'), t('Size')); foreach (element_children($form) as $key) { $row = array(); $row[] = form_render($form[$key]['remove']); $row[] = form_render($form[$key]['list']); $row[] = form_render($form[$key]['description']); $row[] = form_render($form[$key]['size']); $rows[] = $row; } $output = theme('table', $header, $rows); $output .= form_render($form); return $output; } function upload_load($node) { $files = array(); if ($node->vid) { $result = db_query('SELECT * FROM {files} f INNER JOIN {file_revisions} r ON f.fid = r.fid WHERE r.vid = %d ORDER BY f.fid DESC', $node->vid); while ($file = db_fetch_object($result)) { $files[$file->fid] = $file; } } return $files; } /** * Check an upload, if it is an image, make sure it fits within the * maximum dimensions allowed. */ function _upload_image($file) { $info = image_get_info($file->filepath); if ($info) { list($width, $height) = explode('x', variable_get('upload_max_resolution', 0)); if ($width && $height) { $result = image_scale($file->filepath, $file->filepath, $width, $height); if ($result) { $file->filesize = filesize($file->filepath); drupal_set_message(t('The image was resized to fit within the maximum allowed resolution of %resolution pixels.', array('%resolution' => theme('placeholder', variable_get('upload_max_resolution', 0))))); } } } return $file; } /** * Menu-callback for JavaScript-based uploads. */ function upload_js() { // We only do the upload.module part of the node validation process. $node = (object)$_POST['edit']; // Load existing node files. $node->files = upload_load($node); // Handle new uploads, and merge tmp files into node-files. _upload_prepare($node); _upload_validate($node); $form = _upload_form($node); foreach (module_implements('form_alter') as $module) { $function = $module .'_form_alter'; $function('upload_js', $form); } $form = form_builder('upload_js', $form); $output = theme('status_messages') . form_render($form); // We send the updated file attachments form. print drupal_to_js(array('status' => TRUE, 'data' => $output)); exit; }