Difference between revisions of "Filters"
(premium block only) |
m (Minor spruce up. Will need major spurcing up.) |
||
| Line 1: | Line 1: | ||
| − | {{notice| | + | {{notice|Main client and Premium Widgets Only}} |
'''Filters''' are a simple yet useful system to replace (main client only) or block text. They can be applied to incoming or outgoing IRC chat. | '''Filters''' are a simple yet useful system to replace (main client only) or block text. They can be applied to incoming or outgoing IRC chat. | ||
| Line 7: | Line 7: | ||
Just go to Prefs -> Filters and setup your own. | Just go to Prefs -> Filters and setup your own. | ||
| − | + | {| border="1" | |
| − | + | |- | |
| − | + | ! Part !! What it does | |
| − | + | |- | |
| + | | REGEXP || This is a javascript regular expression to match against | ||
| + | |- | ||
| + | | Replacement || The text you want to replace with (not available in premium widgets) | ||
| + | |- | ||
| + | | Command || <span style="color:red">Not in current releases.</span> Commands to send when REGEXP matches. | ||
| + | |- | ||
| + | | In || If checked, it'll be applied to any incoming IRC chat | ||
| + | |- | ||
| + | | Out || If checked, it'll be applied to any outgoing IRC chat | ||
| + | |- | ||
| + | | Block || If checked, do not send or show text. | ||
| + | |} | ||
Note that the filters are applied from first to last, only once. | Note that the filters are applied from first to last, only once. | ||
Revision as of 11:39, 28 March 2011
| Main client and Premium Widgets Only |
Filters are a simple yet useful system to replace (main client only) or block text. They can be applied to incoming or outgoing IRC chat.
How to Use
Just go to Prefs -> Filters and setup your own.
| Part | What it does |
|---|---|
| REGEXP | This is a javascript regular expression to match against |
| Replacement | The text you want to replace with (not available in premium widgets) |
| Command | Not in current releases. Commands to send when REGEXP matches. |
| In | If checked, it'll be applied to any incoming IRC chat |
| Out | If checked, it'll be applied to any outgoing IRC chat |
| Block | If checked, do not send or show text. |
Note that the filters are applied from first to last, only once.
For the regular expression syntax, see https://developer.mozilla.org/En/Core_JavaScript_1.5_Guide/Regular_Expressions
If part of the regex is going to be in the replacement, place it in parenthesis, and call it by $<number> where the number is signified by which set of parenthesis it is.
Possible Usages
For the main client:
- Replace irritating abbreviations:
- BRB -> Be right back
- i18n -> internationalization
- Filter out offensive words:
- Damn -> by the beard of Zeus!
- Store commonly used responses:
- tellWidget -> "The widget is a fantastic thing that you can find more info about here....."
- default:
- \bmibbiturl\b -> http://www.mibbit.com/chat/ (\b = word boundary)
- Use a matched text within the replaced string
- \b([^ ]+)url\b -> http://www.$1.com -> mozillaurl -> http://www.mozilla.com
Examples
- ^gn$
- Matches only if you send "gn". Will not match " gn" or "gn " or "You have a gn".
- [Start of line][g][n][End of line]
