You are here

Home » API reference » Private files download permission 8.2

README.txt in Private files download permission 8.2

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

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

Version 7.x-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 7.x-2.x removed 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 7.x-1.x) were inspired by
http://www.beacon9.ca/labs/drupal-7-private-files-module.
The 7.x-2.x development was partly sponsored by Cooperativa Italiana Artisti
(http://www.cita.coop).
The Drupal 8 port was rewritten from scratch, but many thanks to Paris Liakos
and Andrey Kovtun for their precious help and hints.

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 > Settings (url:
/admin/config/media/private-files-download-permission/settings) 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 7.x-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 7.x-2.x removed 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 7.x-1.x) were inspired by

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

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

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

  19. The Drupal 8 port was rewritten from scratch, but many thanks to Paris Liakos

  20. and Andrey Kovtun for their precious help and hints.

  21. 

  22. INSTALLATION / CONFIGURATION

  23. ----------------------------

  24. 

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

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

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

  28. are allowed to download from that location.

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

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

  31. under control.

  32. 

  33. E.g.:

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

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

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

  37. (and all of its subdirectories).

  38. 

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

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

  41. Private files download permission > Settings (url:

  42. /admin/config/media/private-files-download-permission/settings) and change the

  43. setting accordingly.

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

  45. 

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

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