{"id":25209877,"url":"https://github.com/backdrop-contrib/rules_throttle","last_synced_at":"2025-04-05T05:24:16.573Z","repository":{"id":135065299,"uuid":"464439485","full_name":"backdrop-contrib/rules_throttle","owner":"backdrop-contrib","description":"Provides a delay action to rules, to help reduce resource usage in Backdrop CMS","archived":false,"fork":false,"pushed_at":"2024-07-27T19:02:57.000Z","size":16,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":9,"default_branch":"1.x-1.x","last_synced_at":"2025-02-10T13:18:45.961Z","etag":null,"topics":["backdrop","backdropcms","cms","delay","performance","rules","throttle","throttling"],"latest_commit_sha":null,"homepage":"https://backdropcms.org/project/rules_throttle","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/backdrop-contrib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-28T10:37:27.000Z","updated_at":"2025-01-23T09:38:41.000Z","dependencies_parsed_at":"2023-04-11T02:31:46.816Z","dependency_job_id":null,"html_url":"https://github.com/backdrop-contrib/rules_throttle","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Frules_throttle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Frules_throttle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Frules_throttle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backdrop-contrib%2Frules_throttle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/backdrop-contrib","download_url":"https://codeload.github.com/backdrop-contrib/rules_throttle/tar.gz/refs/heads/1.x-1.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247290688,"owners_count":20914722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backdrop","backdropcms","cms","delay","performance","rules","throttle","throttling"],"created_at":"2025-02-10T13:18:47.852Z","updated_at":"2025-04-05T05:24:16.540Z","avatar_url":"https://github.com/backdrop-contrib.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Rules Throttle\n======================\n\nThe Rules Throttle module allows an administrator to insert a \"throttle\" delay\naction into a rule set. The delay can be specified by the administrator in\nmillionths of a second, up to a theoretical maximum of 2,000 seconds [1].\n\nThe action also provides three return values:\n1. A microtime( ) timestamp from before the delay begins;\n2. A microtime( ) timestamp from after the delay completes\n3. A calculation of the duration of the delay.\n\nThese values are available to subsequent rules actions.\n\nAlthough the delay can be implemented for any number of reasons, the original\nidea for the module was to help an administrator buffer or throttle rules' use\nof resources, especially when those rules/actions depend on outside services,\nlike API's, where usage limits may be imposed. Examples of this include API's\nsuch as 3rd party geocoders, weather providers, financial data, email services,\nwhich often restrict the number of API calls your site can make during a given\nperiod of time. On high volume sites, this can cause inconsistent results when\nworking with large data sets. This module allows you to \"throttle\" those API\ncalls to help keep within those usage limits.\n\n\n[1] The Rules Throttle module delay feature relies entirely on the PHP \"usleep\"\nfunction. That function accepts a single parameter (time in microseconds),\nwhich is provided as an integer. In general, PHP integers have a maximum value\nof about two billion, which equates to 2,000 seconds.\n\nThis module is a port from a Drupal 7\n[sandbox project of the same name](https://www.drupal.org/sandbox/jweirather/2603990)\navailable as a zip file from that page. There is no history to import.\n\nDependencies\n------------\n\n- Rules\n\nInstallation\n------------\n\n- Install this module using the official Backdrop CMS instructions at\n  https://backdropcms.org/guide/modules.\n\nUsage\n-----\n\n1. Click to edit your Rule\n2. Under Actions click '+Add action'\n3. Scroll down to 'System' and select 'Throttle rules processing'\n4. Enter the number of millionths of a second\n5. If required, modify the variable names and/or labels\n\n\nIssues\n------\n\nBugs and Feature requests should be reported in the Issue Queue:\nhttps://github.com/backdrop-contrib/rules_throttle/issues.\n\nCurrent Maintainers\n-------------------\n\n- [Martin Price](https://github.com/yorkshire-pudding) - [System Horizons](https://www.systemhorizons.co.uk)\n\n\nCredits\n-------\n\n- Ported to Backdrop CMS by\n  [Martin Price](https://github.com/yorkshire-pudding) - [System Horizons](https://www.systemhorizons.co.uk).\n- Originally written for Drupal by\n  [Joe Weirather](https://github.com/jweirather).\n\nLicense\n-------\n\nThis project is GPL v2 software.\nSee the LICENSE.txt file in this directory for complete text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackdrop-contrib%2Frules_throttle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbackdrop-contrib%2Frules_throttle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackdrop-contrib%2Frules_throttle/lists"}