Username Password
Bookmark and Share

Content Filters

Content filters (also known as “Replacements”) are WebGUI’s way of allowing administrators to have some automated control over user submitted content. They can be used to give some functionality to a user, but more often than not they are used to curb profanity.

Note: Some of the language used in this chapter may be offensive to some. Please understand that no offense is intended. The words are here simply as examples.

Where Are Filters Used

As of this writing content filters are used in the Collaboration System asset and the Wiki asset. However, there is an API provided to the replacements system so other custom assets may use them as well.


Adding A Filter

Adding and editing content filters is easy, just follow these instructions:

  1. Log in and go into admin mode.

  2. Select “Content Filters” from the admin bar.

  3. Now you will be presented with a list the content filters that have already been created. The system comes with about a dozen of the common ones.

  4. From here, click on the “Add a content filter” link on the right side of the screen.

  5. Now you’ll be presented with a small form.


  1. The first field is “Search For”. In this field you enter something you want WebGUI to look for in users posts. Let’s assume that you never want someone to use the word “bitch” on your site, because your site has nothing to do with dogs, and therefore “bitch” would only be used in a hurtful context. So enter “bitch” in the “Search For” field without the quotes.

  2. The second field is “Replace With”, which is what you want WebGUI to output in place of the original item. So in this case, let’s output some Q-Bert™ language. Enter “@#$!” into the “Replace With” field, again without the quotes.

  3. Click “save”.

Now you’ve successfully created a content filter that can be used in Wiki’s and Collaboration Systems that have replacements enabled.

Recipes For Foul Language

It’s easy to filter out provocative and vulgar language simply by putting the following most common hurtful words into replacements: bitch, cunt, farg, icehole, guy, crap

However, often the people using such language are teenagers, and angry adults. Both of which are devious human beings. If they know you filter the words then they will start using other replacements for common characters and symbols. You’ll need to catch those as well. Here are some common ones you should look out for:

@$$ = ass

(o)(o) = boobs

f*ck = farg

The good news is that content filters are retroactive, so if people come up with new terms you don’t want to see on your site, you can always create a new content filter and it will automatically apply itself everywhere that content filters are enabled. In addition, people trying to circumvent your filters will often times make themselves look unintelligent simply because their language will be changed by your filters.

Exposing Functionality

Often times you’ll set up your rich editors and your other filters on your Collaboration Systems and Wiki’s to be very strict, not allowing much in the way of HTML to get into posts. However, you can use replacements to expose that functionality to your users. For example you could do something like this to allow your users to format source code:

Search For

Replace With

<blockquote style=”border: 1px solid black; font-family: courier;>



Then your users can create a block of content like this:

my @colors = qw(black blue orange);

foreach my $color (@colors) {

print “$color\n”;


Which will be formatted like this:


Another example is to expose common symbols this way.

Search For

Replace With












Notice the last example? If you have a particular trademark or product name or something like that, and you always want it to appear a certain way, then creating a replacement for it might be just the trick.

Keywords: replacements

Search | Most Popular | Recent Changes | Wiki Home
© 2022 Plain Black Corporation | All Rights Reserved