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. A check for “any” keywords is made. If none of the keywords are found, the item is not imported, and no further checks are made.
  2. A check for “none” keywords is made. If at least one of the keywords is found, the item is not imported, and no further checks are made.
  3. A check for “any” tags is made. If none of the tags are found, the item is not imported, and no further checks are made.
  4. A check for “none” tags is made. If at least one of the tags is found, the item is not imported, and no further checks are made.
  5. The item is determined to be a match.

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.