Understand 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.

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

wpra-keyword-filtering-1

  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.

Let’s say, you have an 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.