function hook_file_download_access_alter

Alter the access rules applied to a file download.

Entities that implement file management set the access rules for their individual files. Module may use this hook to create custom access rules for file downloads.

Parameters

$grants: An array of grants gathered by hook_file_download_access(). The array is keyed by the module that defines the entity type's access control; the values are Boolean grant responses for each module.

array $file_item: The array of information about the file to alter access for.

$entity_type: The type of $entity; for example, 'node' or 'user'.

$entity: The $entity to which $file is referenced.

See also

hook_file_download_access().

File

modules/file/file.api.php, line 55

Code

function hook_file_download_access_alter(&$grants, $file_item, $entity_type, $entity) {
    // For our example module, we always enforce the rules set by node module.
    if (isset($grants['node'])) {
        $grants = array(
            'node' => $grants['node'],
        );
    }
}