12.2.3. Condition Commands

The available condition commands are explained below. You can see Filter Commands to learn what commands are and how they are used.

12.2.3.1. Greater than

Test if the subject value is greater than a number.

Options
Value:Enter a number. The subject value must be greater than this number for the condition to be met.

12.2.3.2. Less than

Test if the subject value is less than a number.

Options
Value:Enter a number. The subject value must be less than this number for the condition to be met.

12.2.3.3. Greater than or equal to

Test if the subject value is greater than or equal to a number.

Options
Value:Enter a number. The subject value must be greater than or equal to this number for the condition to be met.

12.2.3.4. Less than or equal to

Test if the subject value is less than or equal to a number.

Options
Value:Enter a number. The subject value must be less than or equal to this number for the condition to be met.

12.2.3.5. Equal to

Test if the subject value is equal to a number.

Options
Value:Enter a number. The subject value must be equal to this number for the condition to be met.

12.2.3.6. Not equal to

Test if the subject value is not equal to a number.

Options
Value:Enter a number. The subject value must not be equal to this number for the condition to be met.

12.2.3.7. Starts with

Test if the subject value starts with a specific text.

Options
Text:Enter a text. The subject value must start with this text for the condition to be met.
Case insensitive?:
 Check if the given text’s characters can be uppercase or lowercase. For example, let’s say you entered Mars as the text. If you check this, mars, MaRS, MarS, etc. are considered as the same as Mars. If you do not check this, they are considered as different from Mars.

12.2.3.8. Does not start with

Test if the subject value does not start with a specific text.

Options
Text:Enter a text. The subject value must not start with this text for the condition to be met.
Case insensitive?:
 Check if the given text’s characters can be uppercase or lowercase. For example, let’s say you entered Mars as the text. If you check this, mars, MaRS, MarS, etc. are considered as the same as Mars. If you do not check this, they are considered as different from Mars.

12.2.3.9. Ends with

Test if the subject value ends with a specific text.

Options
Text:Enter a text. The subject value must end with this text for the condition to be met.
Case insensitive?:
 Check if the given text’s characters can be uppercase or lowercase. For example, let’s say you entered Mars as the text. If you check this, mars, MaRS, MarS, etc. are considered as the same as Mars. If you do not check this, they are considered as different from Mars.

12.2.3.10. Does not end with

Test if the subject value does not end with a specific text.

Options
Text:Enter a text. The subject value must not end with this text for the condition to be met.
Case insensitive?:
 Check if the given text’s characters can be uppercase or lowercase. For example, let’s say you entered Mars as the text. If you check this, mars, MaRS, MarS, etc. are considered as the same as Mars. If you do not check this, they are considered as different from Mars.

12.2.3.11. Contains

Test if the subject value contains a specific text.

Options
Text:Enter a text. The subject value must contain this text for the condition to be met.
Case insensitive?:
 Check if the given text’s characters can be uppercase or lowercase. For example, let’s say you entered Mars as the text. If you check this, mars, MaRS, MarS, etc. are considered as the same as Mars. If you do not check this, they are considered as different from Mars.

12.2.3.12. Does not contain

Test if the subject value does not contain a specific text.

Options
Text:Enter a text. The subject value must not contain this text for the condition to be met.
Case insensitive?:
 Check if the given text’s characters can be uppercase or lowercase. For example, let’s say you entered Mars as the text. If you check this, mars, MaRS, MarS, etc. are considered as the same as Mars. If you do not check this, they are considered as different from Mars.

12.2.3.13. Is uppercase

Test if the subject value contains only uppercase letters. The condition is met only if the subject value’s all characters are uppercase.

12.2.3.14. Is not uppercase

Test if the subject value’s characters are not all uppercase letters. The condition is met if the subject value contains a lowercase letter.

12.2.3.15. Is lowercase

Test if the subject value contains only lowercase letters. The condition is met only if the subject value’s all characters are lowercase.

12.2.3.16. Is not lowercase

Test if the subject value’s characters are not all lowercase letters. The condition is met if the subject value contains an uppercase letter.

12.2.3.17. Matches regex

Test if the subject value matches a regular expression.

Options
Regular expression:
 Enter the regular expression that the subject must match. The condition is met only if the subject matches this regular expression. See Find and Replace Setting’s Find input’s description to learn how the regex should be entered.

12.2.3.18. Does not match regex

Test if the subject value does not match a regular expression.

Options
Regular expression:
 Enter the regular expression that the subject must not match. The condition is met only if the subject does not match this regular expression. See Find and Replace Setting’s Find input’s description to learn how the regex should be entered.

12.2.3.19. Exists

Test if the subject element exists in the HTML. The condition is met only if the subject element exists in the HTML.

12.2.3.20. Does not exist

Test if the subject element does not exist in the HTML. The condition is met only if the subject element does not exist in the HTML.

12.2.3.21. Is older than

Test if the subject date is older than the specified number of hours.

Options
Hours:The date must be older than this many hours when compared to the current time. You can enter decimals. The value can be negative as well. For the condition to be met, the following condition should be satisfied: \(now - (subject\ date) > hours\)

12.2.3.22. Is older than fixed date

Test if the subject date is older than the specified fixed date.

Options
Date:The date must be older than this date. Enter a date formatted as Y-m-d H:i:s, i.e. (year)-(month)-(day) (hour):(minute):(second). For example: 2020-05-27 13:37:15. You can also enter any time value supported by DateTime. If the date is not a fixed date, then the time of your server is used as now, not the time of WordPress. It is recommended to enter a fixed date for reliability. For the condition to be met, the following condition should be satisfied: \((subject\ date) < (date\ given\ by\ you)\)

12.2.3.23. Is newer than

Test if the subject date is newer than the specified number of hours.

Options
Hours:The date must be newer than this many hours when compared to the current time. You can enter decimals. The value can be negative as well. For the condition to be met, the following condition should be satisfied: \(now - (subject\ date) < hours\)

12.2.3.24. Is newer than fixed date

Test if the subject date is newer than the specified fixed date.

Options
Date:The date must be newer than this date. Enter a date formatted as Y-m-d H:i:s, i.e. (year)-(month)-(day) (hour):(minute):(second). For example: 2020-05-27 13:37:15. You can also enter any time value supported by DateTime. If the date is not a fixed date, then the time of your server is used as now, not the time of WordPress. It is recommended to enter a fixed date for reliability. For the condition to be met, the following condition should be satisfied: \((subject\ date) > (date\ given\ by\ you)\)

12.2.3.25. Is crawling

Test if the plugin currently crawls a post. The condition is met only if the plugin crawls a post.

12.2.3.26. Is recrawling

Test if the plugin currently recrawls a post. The condition is met only if the plugin recrawls a post.

12.2.3.27. Is first page

Test if the plugin currently crawls or recrawls the first page of the target post. The condition is met only if it is the target post’s first page.

12.2.3.28. Is error

Test if there was an error. The condition is met only if there was an error when crawling the target page. The type of the error is not important for this command. Any error satisfies the condition.

Important

When there is an error, the plugin stops crawling the target page. Using this command is meaningful only after the request is finished and not after that. So, this command is of no use after the post or category data is ready or when interacting with the target page’s source code, because the plugin would not have executed them if there was an error.

12.2.3.29. Is HTML error

Test if there was an HTML error. The condition is met only if there was an error, and the error was an HTML error. An HTML error occurs when the target page’s source code cannot be parsed by the plugin. This rarely happens, if not ever.

Important

When there is an error, the plugin stops crawling the target page. Using this command is meaningful only after the request is finished and not after that. So, this command is of no use after the post or category data is ready or when interacting with the target page’s source code, because the plugin would not have executed them if there was an error.

12.2.3.30. Is request error

Test if there was a request error. The condition is met only if there was an error, and the error was a request error. A request error occurs when the plugin cannot connect to the target URL. This might happen for a number of reasons. For example, the target site might be down or your site might not be able to connect to the target site.

Important

When there is an error, the plugin stops crawling the target page. Using this command is meaningful only after the request is finished and not after that. So, this command is of no use after the post or category data is ready or when interacting with the target page’s source code, because the plugin would not have executed them if there was an error.