README.txt 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. README.txt
  2. ==========
  3. A module containing helper functions for Drupal developers and
  4. inquisitive admins. This module can print a log of
  5. all database queries for each page request at the bottom of each page. The
  6. summary includes how many times each query was executed on a page, and how long
  7. each query took.
  8. It also offers
  9. - a block for running custom PHP on a page
  10. - a block for quickly accessing devel pages
  11. - a block for masquerading as other users (useful for testing)
  12. - reports memory usage at bottom of page
  13. - A mail-system class which redirects outbound email to files
  14. - more
  15. This module is safe to use on a production site. Just be sure to only grant
  16. 'access development information' permission to developers.
  17. Also a dpr() function is provided, which pretty prints arrays and strings.
  18. Useful during development. Many other nice functions like dpm(), dvm().
  19. AJAX developers in particular ought to install FirePHP Core from
  20. http://www.firephp.org/ and put it in the devel directory. You may
  21. use the devel-download drush command to download the library. If downloading by hand,
  22. your path to fb.php should look like devel/FirePHPCore/lib/FirePHPCore/fb.php.
  23. You can use svn checkout http://firephp.googlecode.com/svn/trunk/trunk/Libraries/FirePHPCore.
  24. Then you can log php variables to the Firebug console. Is quite useful.
  25. Included in this package is also:
  26. - devel_node_access module which prints out the node_access records for a given node. Also offers hook_node_access_explain for all node access modules to implement. Handy.
  27. - devel_generate.module which bulk creates nodes, users, comment, terms for development.
  28. Some nifty drush integration ships with devel and devel_generate. See drush help for details.
  29. DEVEL GENERATE EXTENSIONS
  30. =========================
  31. Devel Images Provider [http://drupal.org/project/devel_image_provider] allows to configure external providers for images.
  32. COMPATIBILITY NOTES
  33. ==================
  34. - Modules that use AHAH may have incompatibility with the query log and other
  35. footer info. Consider setting $GLOBALS['devel_shutdown'] = FALSE if you run into
  36. any issues.
  37. DRUSH UNIT TEST
  38. ==================
  39. See develDrushTest.php for an example of unit testing of the Drush integration.
  40. This uses Drush's own test framework, based on PHPUnit. To run the tests, use
  41. phpunit --bootstrap=/path/to/drush/tests/drush_testcase.inc. Note that we must name a file
  42. under /tests there.
  43. AUTHOR/MAINTAINER
  44. ======================
  45. -moshe weitzman <weitzman at tejasa DOT com>
  46. http://cyrve.com
  47. Hans Salvisberg <drupal at salvisberg DOT com>