An Explanation of the Filtering Logic

In order to understand how the keyword and tag filtering works we’ve set up this page that explains each step that the plugin takes in order to filter out the content based on your settings.

NOTE: The keyword filtering is done with exact matches for words and phrases supplied in the settings. Keyword Filtering currently does not carry out fuzzy matches. For example, if you look for the word 'weather', the add-on will check for the presence or absence of the word 'weather'. It will not match 'atmospheric conditions' or 'wind speed'.

The Logic

Here are the steps, in order, based on the settings shown in the below screenshot:

  1. Combine the keywords from the individual feed sources with the ones in the general settings. (all 3 kinds: all, any, none).
  2. Take the “all” keywords, and check the content and title for each one. If one is not found in either field, the item is rejected; otherwise, continue.
  3. Take the “any” keywords, and check the content and title for each one. If none are found in either field, the item is rejected; otherwise, continue.
  4. Take the “not” keywords, and check the content and title for each one. If one is found in either field, the item is rejected; otherwise, continue.
  5. Import the item.

An Example

Let’s say you have a feed item with the content  “The quick brown fox jumped over a lazy dog”, and with tags “test” and “example”.

Rules:

  1. The content should have any keywords from this list: “fox”, “dog”
  2. The item should have any tags from this list: “font”, “example”

Flow:

  1. Does the content match the keywords?  –  Yes (“fox” and “dog” found)
  2. Does the tag list match the rules?  –  Yes (“example” found)
  3. Match – item is imported

Rules:

  1. The content should have any keywords from this list: “fox”, “dog”
  2. The item should have any tags from this list: “animals”, “typography”

Flow:

  1. Does the content match the keywords?  –  Yes (“fox” and “dog” found)
  2. Does the tag list match the rules?  –  No
  3. No Match – item not imported

Rules:

  1. The content should have any keywords from this list: “fast”, “cat”
  2. The item should have any tags from this list: “font”, “animals”

Flow:

  1. Does the content match the keywords?  –  No
  2. No Match – item not imported (In this case, no search is done for the tag list since the first filtering found no match.)

In conclusion, all the filtering keywords and tags you enter into the settings must be true in order for the feed item to be imported. So if you set keywords and tags, both must be true for the import to be successful.

Still need help? Contact Us Contact Us