You are here

Home » API reference » Private files download permission 7.2

README.txt in Private files download permission 7.2

Same filename and directory in other branches
  1. 8.2 README.txt
  2. 7 README.txt
  3. 3.x README.txt
Private files download permission
=================================

DESCRIPTION
----------------------------

Version 1.x provided "two useful features which Drupal itself is missing: a
simple permission to allow downloading of private files by role, plus the
ability to combine both public and private downloads".

Version 2.x removes the "global" permission and implements a per-directory
by-user and by-role filter instead, to let the administrator better tweak the
whole website and increment the overall security.

Idea and code (mostly for version 1.x) were inspired by
http://www.beacon9.ca/labs/drupal-7-private-files-module.
The 2.x development was partly sponsored by Cooperativa Italiana Artisti
(http://www.cita.coop).

INSTALLATION / CONFIGURATION
----------------------------

Browse to Configuration > Media > Private files download permission (url:
/admin/config/media/private-files-download-permission). Then add or edit each
directory path you want to put under control, associating users and roles which
are allowed to download from that location.
All directory paths are relative to your private file system path, but must
have a leading slash ('/'), as the private file system root itself could be put
under control.

E.g.:
Suppose your private file system path is /opt/private.
You could configure /opt/private (and all of its subdirectories) by adding a
'/' entry, while a '/test' entry would specifically refer to /opt/private/test
(and all of its subdirectories).

Please note that per-user checks may slow your site if there are plenty of
users. You can then bypass this feature by browsing to Configuration > Media >
Private files download permission > Preferences (url:
/admin/config/media/private-files-download-permission/preferences) and change
the setting accordingly.
Additional settings are available to cache users and/or log activities.

Also configure which users and roles have access to the module configuration
under People > Permissions (url: /admin/people/permissions).

File

README.txt
View source 
  1. Private files download permission

  2. =================================

  3. 

  4. DESCRIPTION

  5. ----------------------------

  6. 

  7. Version 1.x provided "two useful features which Drupal itself is missing: a

  8. simple permission to allow downloading of private files by role, plus the

  9. ability to combine both public and private downloads".

  10. 

  11. Version 2.x removes the "global" permission and implements a per-directory

  12. by-user and by-role filter instead, to let the administrator better tweak the

  13. whole website and increment the overall security.

  14. 

  15. Idea and code (mostly for version 1.x) were inspired by

  16. http://www.beacon9.ca/labs/drupal-7-private-files-module.

  17. The 2.x development was partly sponsored by Cooperativa Italiana Artisti

  18. (http://www.cita.coop).

  19. 

  20. INSTALLATION / CONFIGURATION

  21. ----------------------------

  22. 

  23. Browse to Configuration > Media > Private files download permission (url:

  24. /admin/config/media/private-files-download-permission). Then add or edit each

  25. directory path you want to put under control, associating users and roles which

  26. are allowed to download from that location.

  27. All directory paths are relative to your private file system path, but must

  28. have a leading slash ('/'), as the private file system root itself could be put

  29. under control.

  30. 

  31. E.g.:

  32. Suppose your private file system path is /opt/private.

  33. You could configure /opt/private (and all of its subdirectories) by adding a

  34. '/' entry, while a '/test' entry would specifically refer to /opt/private/test

  35. (and all of its subdirectories).

  36. 

  37. Please note that per-user checks may slow your site if there are plenty of

  38. users. You can then bypass this feature by browsing to Configuration > Media >

  39. Private files download permission > Preferences (url:

  40. /admin/config/media/private-files-download-permission/preferences) and change

  41. the setting accordingly.

  42. Additional settings are available to cache users and/or log activities.

  43. 

  44. Also configure which users and roles have access to the module configuration

  45. under People > Permissions (url: /admin/people/permissions).