You are here

README.txt in Users Export 7.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 7 README.txt
# @codingStandardsIgnoreFile

CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Requirements
 * Installation
 * Configuration
 * Troubleshooting
 * Maintainers


INTRODUCTION
------------

Provides a turn-key solution for exporting users in several different formats
included Excel, CSV, JSON, tab-delimitted, and XML.


REQUIREMENTS
------------

No special requirements


INSTALLATION
------------

Install as you would normally install a contributed Drupal module. See:
https://drupal.org/documentation/install/modules-themes/modules-7 for further
information.


CONFIGURATION
-------------

 * The functions of this module are given to users with the correct permissions.
   You can enable per-file-format permissions to user roles.

 * Per https://www.drupal.org/node/2824163, if the default export path defined
   by this module is in conflict for your website, you can alter it using
   [1]hook_menu_alter in a custom module. See users_export.api.php for an
   example.

   - Exporting:

     Visit admin/people/export, adjust your settings and click Download File.


   - Searching (views integration)

     If the views module is enabled this module ships with a view for searching
     users found at admin/people/find

   - API:
     Refer to users_export.api.php for api functions and hooks.


TROUBLESHOOTING
---------------

Large user counts will try to consume a good deal of memory and may exceed the 
PHP maximum execution time. In the advanced settings on the export form, you may
attempt to increase both of these values, but their efficacy is dependent upon
the security settings of your server.
You may have to alter these values at the server level if you continue to have
export problems with large numbers of users.

To test this you should enable the test mode and you will get a file of 10
users. If this works, but when unchecked, the export fails, you are most likely
running into limits of either memory or time.

MAINTAINERS
-----------

Current maintainers:
  * Aaron Klump (aklump) - https://www.drupal.org/user/142422

This project has been sponsored by:
 * Loft Studios

Contact:
 * In the Loft Studios
  * Aaron Klump - Developer
  * PO Box 29294 Bellingham, WA 98228-1294
  * aim: theloft101
  * skype: intheloftstudios
  * d.o: aklump
  * [2]http://www.InTheLoftStudios.com

References

 1. https://api.drupal.org/api/drupal/modules%21system%21system.api.php/function/hook_menu_alter/7.x
 2. http://www.InTheLoftStudios.com/

File

README.txt
View source
  1. # @codingStandardsIgnoreFile
  2. CONTENTS OF THIS FILE
  3. ---------------------
  4. * Introduction
  5. * Requirements
  6. * Installation
  7. * Configuration
  8. * Troubleshooting
  9. * Maintainers
  10. INTRODUCTION
  11. ------------
  12. Provides a turn-key solution for exporting users in several different formats
  13. included Excel, CSV, JSON, tab-delimitted, and XML.
  14. REQUIREMENTS
  15. ------------
  16. No special requirements
  17. INSTALLATION
  18. ------------
  19. Install as you would normally install a contributed Drupal module. See:
  20. https://drupal.org/documentation/install/modules-themes/modules-7 for further
  21. information.
  22. CONFIGURATION
  23. -------------
  24. * The functions of this module are given to users with the correct permissions.
  25. You can enable per-file-format permissions to user roles.
  26. * Per https://www.drupal.org/node/2824163, if the default export path defined
  27. by this module is in conflict for your website, you can alter it using
  28. [1]hook_menu_alter in a custom module. See users_export.api.php for an
  29. example.
  30. - Exporting:
  31. Visit admin/people/export, adjust your settings and click Download File.
  32. - Searching (views integration)
  33. If the views module is enabled this module ships with a view for searching
  34. users found at admin/people/find
  35. - API:
  36. Refer to users_export.api.php for api functions and hooks.
  37. TROUBLESHOOTING
  38. ---------------
  39. Large user counts will try to consume a good deal of memory and may exceed the
  40. PHP maximum execution time. In the advanced settings on the export form, you may
  41. attempt to increase both of these values, but their efficacy is dependent upon
  42. the security settings of your server.
  43. You may have to alter these values at the server level if you continue to have
  44. export problems with large numbers of users.
  45. To test this you should enable the test mode and you will get a file of 10
  46. users. If this works, but when unchecked, the export fails, you are most likely
  47. running into limits of either memory or time.
  48. MAINTAINERS
  49. -----------
  50. Current maintainers:
  51. * Aaron Klump (aklump) - https://www.drupal.org/user/142422
  52. This project has been sponsored by:
  53. * Loft Studios
  54. Contact:
  55. * In the Loft Studios
  56. * Aaron Klump - Developer
  57. * PO Box 29294 Bellingham, WA 98228-1294
  58. * aim: theloft101
  59. * skype: intheloftstudios
  60. * d.o: aklump
  61. * [2]http://www.InTheLoftStudios.com
  62. References
  63. 1. https://api.drupal.org/api/drupal/modules%21system%21system.api.php/function/hook_menu_alter/7.x
  64. 2. http://www.InTheLoftStudios.com/