The Rules Throttle module allows an administrator to insert a "throttle" delay
action into a rule set. The delay can be specified by the administrator in
millionths of a second, up to a theoretical maximum of 2,000 seconds [1].
The action also provides three return values:
- A microtime( ) timestamp from before the delay begins;
- A microtime( ) timestamp from after the delay completes
- A calculation of the duration of the delay.
These values are available to subsequent rules actions.
Although the delay can be implemented for any number of reasons, the original
idea for the module was to help an administrator buffer or throttle rules' use
of resources, especially when those rules/actions depend on outside services,
like API's, where usage limits may be imposed. Examples of this include API's
such as 3rd party geocoders, weather providers, financial data, email services,
which often restrict the number of API calls your site can make during a given
period of time. On high volume sites, this can cause inconsistent results when
working with large data sets. This module allows you to "throttle" those API
calls to help keep within those usage limits.
[1] The Rules Throttle module delay feature relies entirely on the PHP "usleep"
function. That function accepts a single parameter (time in microseconds),
which is provided as an integer. In general, PHP integers have a maximum value
of about two billion, which equates to 2,000 seconds.
This module is a port from a Drupal 7
sandbox project of the same name
available as a zip file from that page. There is no history to import.
Dependencies
- Rules
Installation
- Install this module using the official Backdrop CMS instructions at
https://backdropcms.org/guide/modules.
Usage
- Click to edit your Rule
- Under Actions click '+Add action'
- Scroll down to 'System' and select 'Throttle rules processing'
- Enter the number of millionths of a second
- If required, modify the variable names and/or labels
Issues
Bugs and Feature requests should be reported in the Issue Queue:
https://github.com/backdrop-contrib/rules_throttle/issues.
Current Maintainers
Credits
- Ported to Backdrop CMS by
Martin Price - System Horizons. - Originally written for Drupal by
Joe Weirather.
License
This project is GPL v2 software.
See the LICENSE.txt file in this directory for complete text.