Rules with User Input

    

%s    (percent sign and lower case 's')
If you enter the string '%s' in a Rules Condition,  Gravity will prompt the user for a text string when the rule is run. The text will be substituted into the rule condition.
This is useful for running rules manually. However, it can also be used in a rule that is "enabled" to apply to incoming articles automatically. If enabled, Gravity will display the text entry dialog when you retrieve headers (which you might find annoying after a while).

·       If '%s' is entered as a Regular Expression, the user input will be treated as a PCRE

·       %s can be used with From or Subject (or both with Headers).·      You can combine %s with other rule conditions, as:
From contains "%s" And Subject does not contain "gravity"
The  “User-Specified Word in Subject” uses "%s", which can be enabled or run manually if you want to see it in action (it marks articles as important).
Example
We will make the rule Action to discard (delete) articles. Make a rule with a Condition like this:
Subject contains reg. expr. "%s"   

Be careful when discarding (deleting) articles. If you make a typing or rule mistake, Gravity deletes what it is told without warning!

If we run this rule manually, Gravity will open a text box that asks for input, after which the rule will delete (discard) all articles with the Subject containing the input text.

  
If you are ON-line, and use %s in a "BODY Contains" rule condition, Gravity will try to fetch the articles, including bodies, from the server. The bodies are not saved after the rule finishes. Be aware that this can be a server intensive operation for large groups.
If you are OFF-line, Gravity will warn that you are offline and do nothing if you proceed.
You should NOT use a "BODY Contains .." condition in binary groups.