Root definitions

HistoryJSONConfig

Permalink

Aggregates an Author's submission and comment history. Rule can be triggered on count/percent of total (for either or both comment/sub totals) as well as comment OP total.

Available data for Action templating:

Copy
1 2 3 4 5 6 7 activityTotal => Total number of activities submissionTotal => Total number of submissions commentTotal => Total number of comments opTotal => Total number of comments as OP thresholdSummary => A text summary of the first Criteria triggered with totals/percentages criteria => The ThresholdCriteria object window => A text summary of the range of Activities considered (# of Items if number, time range if Duration)

Properties

authorIs

anyOf [Array<anyOf [AuthorCriteria, NamedCriteria<AuthorCriteria>, string]>, FilterOptionsJson<AuthorCriteria>]

If present then these Author criteria are checked before running the Check. If criteria fails then the Check will fail.

condition

string

  • If OR then any set of Criteria that pass will trigger the Rule
  • If AND then all Criteria sets must pass to trigger the Rule

Valid values: AND, OR

criteria Required

Array<HistoryCriteria>

A list threshold-window values to test activities against.

Min items: 1
exclude

Array<anyOf [SubredditCriteria, string]>

If present, activities will be counted only if they are NOT found in this list of Subreddits

Each value in the list can be either:

  • string (name of subreddit)
  • regular expression to run on the subreddit name
  • SubredditState

EX ["mealtimevideos","askscience", "/onlyfans*\/i", {"over18": true}]

Note: This affects post-window retrieval activities. So that:

  • activityTotal is number of activities retrieved from window -- NOT post-filtering
  • all comparisons using percentages will compare post-filtering results against activity count from window
  • -- to run this rule where all activities are only from include/exclude filtering instead use include/exclude in window
include

Array<anyOf [SubredditCriteria, string]>

If present, activities will be counted only if they are found in this list of Subreddits.

Each value in the list can be either:

  • string (name of subreddit)
  • regular expression to run on the subreddit name
  • SubredditState

EX ["mealtimevideos","askscience", "/onlyfans*\/i", {"over18": true}]

Note: This affects post-window retrieval activities. So that:

  • activityTotal is number of activities retrieved from window -- NOT post-filtering
  • all comparisons using percentages will compare post-filtering results against activity count from window
  • -- to run this rule where all activities are only from include/exclude filtering instead use include/exclude in window
itemIs

anyOf [Array<anyOf [SubmissionState, CommentState, NamedCriteria<TypedActivityState>, string]>, FilterOptionsJson<TypedActivityState>]

A list of criteria to test the state of the Activity against before running the check.

If any set of criteria passes the Check will be run. If the criteria fails then the Check will fail.

  • @examples [[{"over_18": true, "removed': false}]]
kind Required

string

The kind of rule to run

Valid values: history

name

string

An optional, but highly recommended, friendly name for this rule. If not present will default to kind.

Can only contain letters, numbers, underscore, spaces, and dashes

name is used to reference Rule result data during Action content templating. See CommentAction or ReportAction for more details.

Pattern: ^[a-zA-Z]([\w -]*[\w])?$
Loading...

Editor and Validator