You are here

function file_entity_mass_update in File Entity (fieldable files) 7.2

Same name and namespace in other branches
  1. 7.3 file_entity.admin.inc \file_entity_mass_update()

Make mass update of files.

Change all files in the $files array to update them with the field values in $updates.

IMPORTANT NOTE: This function is intended to work when called from a form submit handler. Calling it outside of the form submission process may not work correctly.

Parameters

array $files: Array of file fids to update.

array $updates: Array of key/value pairs with file field names and the value to update that field to.

1 string reference to 'file_entity_mass_update'
file_entity_file_operations in ./file_entity.module
Implements hook_file_operations().

File

./file_entity.admin.inc, line 182

Code

function file_entity_mass_update(array $files, array $updates) {

  // We use batch processing to prevent timeout when updating a large number
  // of files.
  if (count($files) > 10) {
    $batch = array(
      'operations' => array(
        array(
          '_file_entity_mass_update_batch_process',
          array(
            $files,
            $updates,
          ),
        ),
      ),
      'finished' => '_file_entity_mass_update_batch_finished',
      'title' => t('Processing'),
      // We use a single multi-pass operation, so the default
      // 'Remaining x of y operations' message will be confusing here.
      'progress_message' => '',
      'error_message' => t('The update has encountered an error.'),
      // The operations do not live in the .module file, so we need to
      // tell the batch engine which file to load before calling them.
      'file' => drupal_get_path('module', 'file_entity') . '/file_entity.admin.inc',
    );
    batch_set($batch);
  }
  else {
    foreach ($files as $fid) {
      _file_entity_mass_update_helper($fid, $updates);
    }
    drupal_set_message(t('The update has been performed.'));
  }
}