Filters are a very powerful and flexible tool which may significantly ease the task of extracting useful information from the sea of data that is RSS feeds. Filters are applied to articles based on regular expression matches against specified fields. After the match had been found, configured actions are taken. Matching is case-insensitive, PCRE pattern syntax is used.
Filters are loaded in user-specified order and applied sequentially. It is possible to reorder filters using drag and drop. If no manual sorting is specified, filters are sorted alphabetically according to user configured caption. If no caption is specified for any filter, loading order is not guaranteed.
Each filter object may contain an arbitrary amount of regular expression rules and actions. Each expression may have inverse flag set, which inverts matching result. On top of that, filter may also have an inverse flag, which inverts the final matching.
/
) when writing regular
expressions.Filter matching is performed during feed processing.
Some actions may be applied only when the article is initially imported from the feed. Other actions may be applied every time article is seen in the originating feed. It is suggested to only rely on filters applying to articles imported after the filter had been created - they will not retroactively apply to your article database.
Several actions are available:
Delete article
- do not import article from the feed,
does not actually delete anything from the databaseMark as read
- imports article automatically marked as
readSet starred
- sets article starred automatically on
importAssign tags
- assigns a comma-separated list of custom
tags on importPublish article
- sets article published automatically
on importModify score
(Scoring) - modifies
article overall score based on the parameter, a signed integer number.
Final article score is calculated after all filters had been applied and
is a sum of all matched scoring actions.Assign label
- assigns specified label to the article
on importStop / Do nothing
- stops further filter processing for
this article, no following filters will be checked nor rules
applied.Invoke plugin
- runs a plugin action when filter is
matchedIgnore tags
- a comma-separated list of tags which will
be skipped on article importAfter all matching filters had been computed for the article, it is
either imported with modifications as specified by the rules, or dropped
if Delete article
action has been found.
Filter test dialog may not give entirely accurate results, especially
for complex filters. It is suggested to test filters using
Feed debugger
if you feel that some filter is somehow
misfiring on a specific feed.
It’s a design limitation. All actions for an article are applied together, once. Click here for a detailed explanation.