Title Pinger Commands

This set of commands allows you to set keywords which can be triggered by the monitor notifications sent to tag certain roles. All available commands can be viewed using: !m help titlepinger

Positive and negative keywords explained

To setup a title pinger you need to provide at least one positive or negative keyword. The positive keywords are identified using a + and the negative keywords are identified using a -. A positive keyword is a word which the title of the item will need to contain in order to trigger the ping. A negative keyword is the opposite; meaning that if the title of the item contains a negative keyword, it will not trigger the ping.

If you have added a ping with multiple positive keywords then the title of the item will need to contain all of those keywords in order to trigger the ping. However, if your added ping also contains negative keywords then the title of the item will only need to contain one of those negative keywords in order to not trigger the ping.

Keywords are not case sensitive so you can add all of your keywords in lowercase.

Adding a title pinger

To add a title pinger you need to use the pinger title add command.

This command requires at least one positive or negative keyword and a role mention OR the ID of the role you would like the bot to mention when the title pinger is triggered. Example:

!m pinger title add +ps5 -headset @ps5-usa

!m pinger title add +ps5 -headset #1234567891011121314

In this example we have setup a title pinger containing one positive keyword (ps5) and one negative keyword (headset).

For this title pinger to be triggered the title of the item will need to contain the word ps5 and it cannot contain the word headset.

If this title pinger is triggered your bot will send another message where it will mention the Discord role ps5-usawith ID 1234567891011121314. This will result in all users with said role to receive a ping.

You can add a title pinger which will ping a role for every single item by adding the postive keyword "all". Example: !m pinger title add +all @important-alerts OR !m pinger title add +all #1234567891011121314 In order for this title pinger to function you MUST set the stores you wish it to work for after you have added it.

Removing a title pinger

Use this command to remove a previously added title pinger.

To remove a title pinger you need to use the pinger title remove command and the ID of the title pinger you would like to remove.

You can find the ID of a title pinger once it is triggered as the ID will be included with the role mention; or you can view all of your title pinger using the command Title Pinger Commands

!m pinger title remove 1

Setting a store for a title pinger

Use this command to set a store for a title pinger.

Setting a store for a title pinger means that the title pinger will only be active for the set stores; this is useful in situations where you only want to have certain title pingers for certain stores in order to avoid unnecessary pings.

If a title pinger does not have any stores set, then it will be active for all stores.

This command requires the name of the store and the ID of the title pinger you wish to set the store for. Example:

!m pinger title store set 1 target

The same title pinger can have more than one store. The same command can be used multiple times to add multiple stores.

Stores can also be set for scrapers exclusively by simply adding `scraper` to the store name. Example: !m pinger title store set 1 targetscraper

You can also set Shopify sites for any title pinger using the Shopify store URL instead of a store name. Example: !m pinger title store set 1 https://jyw-tmgc.com/

Excluding a store from a title pinger

Use this command to exclude a store from a title pinger.

Excluding a store from a title pinger means that the title pinger will not be active for the excluded stores; this is useful in situations where you don't want to have certain title pingers for certain stores in order to avoid unnecessary pings.

If a title pinger does not have any stores excluded, then it will be active for all stores or set stores.

This command requires the name of the store and the ID of the title pinger you wish to exclude the store for. Example:

!m pinger title store exclude 1 target

The same title pinger can have more than one store excluded. The same command can be used multiple times to exclude multiple stores.

Stores can also be excluded for scrapers exclusively by simply adding `scraper` to the store name. Example: !m pinger title store exclude 1 targetscraper

You can also exclude Shopify sites for any title pinger using the Shopify store URL instead of a store name. Example: !m pinger title store exclude 1 https://jyw-tmgc.com/

Removing a store from a title pinger

Use this command to remove a set store or an excluded store from a title pinger.

This command requires the name of the store and the ID of the title pinger you wish to remove the store for. Example:

!m pinger title store remove 1 target

View added title pingers

You can view a list of all the title pinger you have added using the pinger title running command. Example:

!m pinger title running

Toggle title pingers

You can toggle all of your added title pingers on or off using the pinger title toggle command. Example:

!m pinger title toggle