Message Settings: Conditions

The conditions tab allows you to control where and when a message is shown on your website. When users visit your site, the plugin will check the viewed content against your selection below and determine if this message should be shown.

Ahoy conditions

General

The Home Page - The message will be shown on your sites homepage.
A Search Result Page - The message will be shown on search results.
A 404 Error Page - The message will be shown on 404 error pages.

Posts

The Blog Index - The message will be shown on the blog index.
A post - The message will be shown whenever a user visits any post on your site.
A selected post - The message will be shown whenever a user visits a post that you have selected. You can select multiple posts.
A post with ID - The message will be shown whenever a user visits a post that has a specific ID. You can specify multiple post IDs.
A post with category - The message will be shown whenever a user visits a post that has a selected category. You can select multiple categories.
A post with tag - The message will be shown whenever a user visits a post that has a specific tag. You can select multiple tags.
A post with format - The message will be shown whenever a user visits a post that has a specific format. You can select multiple formats.

Media

A media - The message will be shown whenever a user views any media on your site
A selected media - The message will be shown whenever a user views a specific media you have selected.
A media with ID - The message will be shown whenever a user views a media that has a specific ID. You can specify multiple media IDs.

Custom Post Type

If you have a custom post type on your site, you will be able to apply the same conditions that are available to page/post conditions

User

Is logged in - The message will only be shown to logged in users
Has role - The message will only be shown to the role/roles you select
Has commented - The message will only be shown to users who have commented on your site. You can specify a more than/less than number of comments.
Has viewed X pages - The message will only be shown to users who have visited at least X pages on your site.
Has viewed selected pages - The message will only be shown to users who have visited a list of specific pages on your site. No specific order.
Time on site - The message will only be shown to users who have spent more/less than X minutes on your site

HTML

HTML element exists - The message will be shown whenever a user visits a page/post that contains an HTML element
HTML element has class - The message will be shown whenever a user visits a page/post that contains an HTML element with a class

URL

URL is - The message will be shown whenever a user is on a page/post with the designated URL
URL contains - The message will be shown whenever a user is on a page with a URL that contains specified text
URL begins with - The message will be shown whenever a user is on a page with a URL that begins with specified text
URL ends with - The message will be shown whenever a user is on a page with a URL that ends with specified text
URL regex search - The message will be shown whenever a user is on a page with a URL that matches a specified regex pattern
Query argument exists - The message will be shown whenever a user is on a page with a URL that contains specified query argument. In this example ?argument1=value, the argument that exists is "argument1"
Query argument is - The message will be shown whenever a user is on a page with a URL that contains specified query argument and value. In this example ?argument1=value, the argument is "argument1" and the value would be "value"

Referrer

Referrer URL is - The message will be shown whenever a user views a page/post on your website and came from another page on your site or another with a specific URL
Referrer contains - The message will be shown whenever a user is on a page with a referrer that contains specified text
Referrer URL begins with - The message will be shown whenever a user views a page/post on your website and came from another page on your site or another with a URL that begins with a specified text
Referrer URL ends with - The message will be shown whenever a user views a page/post on your website and came from another page on your site or another with a URL that ends with a specified text
Referrer regex search - The message will be shown whenever a user views a page/post on your website and came from another page on your site or another with a URL that matches a custom regex pattern
Referrer is search engine - The message will be shown whenever a user views a page/post on your website and came from another page on your site or another with a URL that is a known search engine.
Referrer is external URL - The message will be shown whenever a user arrives on your website from a designated external URL

Cookie

Cookie exists - The message will be shown whenever a user has a specific cookie set in their browser.
Cookie is - The message will be shown whenever a user has a specific cookie set in their browser and the value matches your specified value.

Browser

Is specific browser - The message will only be shown to users who have the selected browser
Version is - The message will only be shown to users using a specific version of a browser
Browser width - The message will only be shown to users using a browser within the designated browser size width
Browser height - The message will only be shown to users using a browser within the designated browser size height

Device

Device is mobile - The message will only be shown to users using a mobile device
Device is phone - The message will only be shown to users using a mobile phone
Device is tablet - The message will only be shown to users using a tablet
Device is brand - The message will only be shown to users using a device with a specific brand
Screen width - The message will only be shown to users using a device within the designated screen size width
Screen height - The message will only be shown to users using a device within the designated screen size height

Custom

Custom PHP function - The message will be shown whenever a custom PHP function of your choice returns true. Enter the function name without (), such as "my_function_name" or "StaticClass::function_name".
Custom JS function - The message will be shown whenever a custom JavaScript function of your choice returns true. Enter the function name without (), such as "my_function_name", "window.my_function_name" or "object.function_name".