README.txt 4.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. --------------------------------------------------------------------------------
  2. Rules
  3. --------------------------------------------------------------------------------
  4. Maintainers:
  5. * Wolfgang Ziegler (fago), nuppla@zites.net
  6. The Rules module allows site administrators to define conditionally executed
  7. actions based on occurring events (ECA-rules).
  8. Project homepage: http://drupal.org/project/rules
  9. Installation
  10. ------------
  11. *Before* starting, make sure that you have read at least the introduction - so
  12. you know at least the basic concepts. You can find it here:
  13. http://drupal.org/node/298480
  14. * Rules depends on the Entity API module, download and install it from
  15. http://drupal.org/project/entity
  16. * Copy the whole rules directory to your modules directory
  17. (e.g. DRUPAL_ROOT/sites/all/modules) and activate the Rules and Rules UI
  18. modules.
  19. * The administrative user interface can be found at admin/config/workflow/rules
  20. Documentation
  21. -------------
  22. * Check out the general docs at http://drupal.org/node/298476
  23. * Check out the developer targeted docs at http://drupal.org/node/878718
  24. Rules Scheduler
  25. ---------------
  26. * If you enable the Rules scheduler module, you get new actions that allow you
  27. to schedule the execution of Rules components.
  28. * Make sure that you have configured cron for your drupal installation as cron
  29. is used for scheduling the Rules components. For help see
  30. http://drupal.org/cron
  31. * If the Views module (http://drupal.org/project/views) is installed, the module
  32. displays the list of scheduled tasks in the UI.
  33. Upgrade from Rules 6.x-1.x to Rules 7.x-2.x
  34. --------------------------------------------
  35. * In order to upgrade Rules from 6.x-1.x to 7.x-2.x just run "update.php". This
  36. is going to make sure Rules 2.x is properly installed, but it will leave your
  37. Rules 1.x configurations untouched. Thus, your rules won't be upgraded yet.
  38. * To convert your Rules 1.x configurations to Rules 2.x go to
  39. 'admin/config/workflow/rules/upgrade'.
  40. * At this page, you may choose the Rules 1.x rules and rule sets to upgrade
  41. and whether the converted configurations should be immediately saved to
  42. your database or whether the configuration export should be generated.
  43. * Note that for importing an export the export needs to pass the
  44. configuration integrity check, what might be troublesome if the
  45. conversion was not 100% successful. In that case, try choosing the
  46. immediate saving method and correct the configuration after conversion.
  47. * A rule configuration might require multiple modules to be in place and
  48. upgraded to work properly. E.g. if you used an action provided
  49. by a third party module, make sure the module is in place and upgraded
  50. before you convert the rule.
  51. * If all required modules are installed and have been upgraded but the rule
  52. conversion still fails, the cause might be that a module has not yet
  53. upgraded its Rules integration or does not implement the Rules conversion
  54. functionality. In that case, file an issue for the module that provided
  55. the action or condition causing the conversion to fail.
  56. * Note that any rule configurations containing token replacements or PHP
  57. input evaluations might need some manual corrections in order to stay
  58. working. This is, as some used token replacements might not be available
  59. in Drupal 7 any more and the PHP code might need to be updated in order
  60. to be compatible with Drupal 7.
  61. * Once the upgrade was successful, you may delete the left over Rules 1.x
  62. configurations by going to 'admin/config/workflow/rules/upgrade/clear'.
  63. * The Rules Scheduler module also comes with an upgrade routine that is
  64. invoked as usual via "update.php". Its actions can be upgraded via the usual
  65. Rules upgrade tool, see above.
  66. However, there is currently no support for upgrading already scheduled
  67. tasks. That means, all previously on Drupal 6 scheduled tasks won't apply
  68. for Drupal 7. The Drupal 6 tasks are preserved in the database as long as
  69. you do not clear your Rules 1.x configuration though.
  70. * The Rules Forms module has not been updated to Drupal 7 and there are no
  71. plans to do so, as unfortuntely the module's design does not allow for
  72. automatic configuration updates.
  73. Thus, a possible future Rules 2.x Forms module is likely to work
  74. different, e.g. by working only for entity forms on the field level.