| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091 |
- --------------------------------------------------------------------------------
- Rules
- --------------------------------------------------------------------------------
- Maintainers:
- * Wolfgang Ziegler (fago), nuppla@zites.net
- The Rules module allows site administrators to define conditionally executed
- actions based on occurring events (ECA-rules).
- Project homepage: https://www.drupal.org/project/rules
- Installation
- ------------
- *Before* starting, make sure that you have read at least the introduction - so
- you know at least the basic concepts. You can find it here:
- https://www.drupal.org/node/298480
- * Rules depends on the Entity API module, download and install it from
- https://www.drupal.org/project/entity
- * Copy the whole rules directory to your modules directory
- (e.g. DRUPAL_ROOT/sites/all/modules) and activate the Rules and Rules UI
- modules.
- * The administrative user interface can be found at admin/config/workflow/rules
- Documentation
- -------------
- * Check out the general docs at https://www.drupal.org/node/298476
- * Check out the developer targeted docs at https://www.drupal.org/node/878718
- Rules Scheduler
- ---------------
- * If you enable the Rules scheduler module, you get new actions that allow you
- to schedule the execution of Rules components.
- * Make sure that you have configured cron for your drupal installation as cron
- is used for scheduling the Rules components. For help see
- https://www.drupal.org/cron
- * If the Views module (https://www.drupal.org/project/views) is installed, the
- module displays the list of scheduled tasks in the UI.
- Upgrade from Rules 6.x-1.x to Rules 7.x-2.x
- --------------------------------------------
- * In order to upgrade Rules from 6.x-1.x to 7.x-2.x just run "update.php". This
- is going to make sure Rules 2.x is properly installed, but it will leave your
- Rules 1.x configurations untouched. Thus, your rules won't be upgraded yet.
- * To convert your Rules 1.x configurations to Rules 2.x go to
- 'admin/config/workflow/rules/upgrade'.
- * At this page, you may choose the Rules 1.x rules and rule sets to upgrade
- and whether the converted configurations should be immediately saved to
- your database or whether the configuration export should be generated.
- * Note that for importing an export the export needs to pass the
- configuration integrity check, what might be troublesome if the
- conversion was not 100% successful. In that case, try choosing the
- immediate saving method and correct the configuration after conversion.
- * A rule configuration might require multiple modules to be in place and
- upgraded to work properly. E.g. if you used an action provided
- by a third party module, make sure the module is in place and upgraded
- before you convert the rule.
- * If all required modules are installed and have been upgraded but the rule
- conversion still fails, the cause might be that a module has not yet
- upgraded its Rules integration or does not implement the Rules conversion
- functionality. In that case, file an issue for the module that provided
- the action or condition causing the conversion to fail.
- * Note that any rule configurations containing token replacements or PHP
- input evaluations might need some manual corrections in order to stay
- working. This is, as some used token replacements might not be available
- in Drupal 7 any more and the PHP code might need to be updated in order
- to be compatible with Drupal 7.
- * Once the upgrade was successful, you may delete the left over Rules 1.x
- configurations by going to 'admin/config/workflow/rules/upgrade/clear'.
- * The Rules Scheduler module also comes with an upgrade routine that is
- invoked as usual via "update.php". Its actions can be upgraded via the usual
- Rules upgrade tool, see above.
- However, there is currently no support for upgrading already scheduled
- tasks. That means, all previously on Drupal 6 scheduled tasks won't apply
- for Drupal 7. The Drupal 6 tasks are preserved in the database as long as
- you do not clear your Rules 1.x configuration though.
- * The Rules Forms module has not been updated to Drupal 7 and there are no
- plans to do so, as unfortunately the module's design does not allow for
- automatic configuration updates.
- Thus, a possible future Rules 2.x Forms module is likely to work
- different, e.g. by working only for entity forms on the field level.
|
