Twitter configuration
You will need to authenticate with Twitter to capture the tweets for your wall. If you have a paid wall, you will also be able to review all the tweets after the event.
Search
Enter the search terms you want confwall to look for. This will be the exact same set of terms you would use if you were searching twitter directly.
Always make sure to use the test your search link as your wall will only show tweets once it's in a live state.
Search tips
- If your term has a space in it:
"my awesome event"
- If you want search for tweets that contain ALL your terms:
#myevent 2015
- If you want have multiple searches, use
OR
:"my awesome event" OR #myevent
- If you have a conference site, make sure to include it:
#myevent OR myevent.org
- If you want to show all the tweets from a specific twitter account (like @confwall):
from:confwall
Blacklist
The blacklist field can be updated at any time and affects all the new tweets appearing on your wall. You do not need to refresh your wall for the update to take effect.
Each blacklist should be on a single line, and blacklist tests are automatically case insensitive.
Note that confwall will automatically block tweets that either consist of only a single @reply, a single #hashtag or a tweet that is entirely @replies and #hashtags - i.e. does not contain any text. This is to prevent spammers from trying to "hashbomb" your wall.
Simple text
Single words can be blacklisted, such as profanity, and these are individually checked against the text of the tweet. Note that this is case-insensitive, so "rude" is the same as "Rude" and the text of the tweet need only contain this text.
So blocking "rude word" will block:
- "My tweet contains rude words"
- "This tweet has a rude word"
But it will not block:
- "Here is a word that is rude"
Blocking users
If there are specific users that are causing abuse on your wall, you can list their twitter handles (without the @ symbol) with the prefix users:
, as so:
users: baddie, rude_person, nasty_user, spamyFella
users: otherUser, GerryMcBaddie
You can list multiple users on a single line, or just multiple lines (as shown above).
Blocking by tweet URL
For convenience, you can block tweets using the URL to the tweet itself on a single line in the blacklist.
The tweet URL looks like this:
https://twitter.com/<username>/status/<tweet_id>
Regular expression
If the line starts with a /
then confwall expects the line to be a regular expression. If the tweet text matches the regular expression, then the the tweet is blocked.
For example to block all three of the tweets in the previous example, a regular expression of /word.*rude|rude.*word/
.
Regular expression can often be complicated, so if it's possible to do the match with a plain string, it's encouraged. However, you can test out your regular expression here to check in real-time what will and will not match.
Functions
Functions, written in JavaScript syntax can test the full content of the tweet. If the function returns true
then the tweet is blocked.
To block all tweets from a particular user for example:
function (tweet) { return tweet.screen_name === 'bad_person' }
For full details of the contents of the tweet, see the Twitter developer documentation.
Full example
An example of an active blacklist that blocks tweets based on four different criteria. Only one of these criteria needs to be matched for the tweet to be blocked:
users: baddie, rude_person, nasty_user, spamyFella
https://twitter.com/joe_normal/status/1234567890
competitor-site.com
/word.*rude|rude.*word/
function (tweet) { return tweet.screen_name === 'bad_person' }
function (tweet) { return tweet.id_str === '1234567890123' }