Table of Contents
Introduction

The blacklist feature of ToplistX allows you to create and manage a list of items that you do not want to appear on your site. The blacklist will be checked for all new account submissions and can also be rechecked with the account scanner. This document will give an overview of the blacklist features in ToplistX.

Blacklist Types

There are several different blacklist types which allow you to configure your blacklist to accurately find and reject the items that you do not want to appear on your site. Each of the blacklist types are described below. Blacklist Search Type

When you add a blacklist item you have the option of specifying if it is a regular expression. Regular expressions are more complex than standard searches that simply look for the item as-is, but they add a great amount of flexibility. In ToplistX the Perl Compatible Regular Expressions format is used for regular expressions. If you are not familiar with regular expressions, please see the Pattern Syntax portion of the PHP manual for additional information. If you check the Regular Expression box on the blacklist add/edit form, the item(s) you enter will be treated as regular expressions and used to match against the values that are submitted by the user.

If the values you enter are not regular expressions, be sure to leave that box unchecked. This will cause a normal search to occur which will match the item you enter anywhere within the field that is being searched. For example, if you enter the word "car" as a blacklisted word and someone submits a description of "Carpool to work to save gas", this will match the "car" blacklist word item since it appears in the description. Note that the search is case-insensitive and will match not only exact words, but also portions of words.

Viewing/Searching Blacklist Items

To view or search your currently configured blacklist items, access the Settings > Manage Blacklist function from the control panel menu. This will display a page where you will be able to see the currently configured blacklist items and search them if you wish.

In the table that displays the blacklist items, you will find a couple of functions that you can run on a single blacklist item. Each of those functions are described below. In addition to running these functions on single blacklist items, you can also run the delete function on multiple blacklist items at once. To run the delete function, put a check in the checkbox next to the blacklist items you want to delete, then press the Delete button at the bottom of the page.

Adding a Blacklist Item

To add a new blacklist item access the Settings > Manage Blacklist function from the control panel menu. This will display your currently configured blacklist items. Near the top of the page in the header bar that reads "Blacklist Items" click on the icon. This will display a popup window where you will be able to enter the data for the new blacklist item that you want to add. Each of the form fields are described below.
When adding multiple blacklist items at once you can use a special format in the Value(s) field to add both the item and reason at the same time. This special format still has one item per line, however after the item you want to blacklist enter a | character (pipe) followed by the reason. For example:

@yahoo.com|Free e-mail addresses are not accepted
@usersite.com|Sites have too many popup windows
@mysite.com|Sites have dialers and other trojans

Once you have filled in all of the fields as you want them, press the Add Blacklist Item button. This will add the new item to the database, and it will be activated immediately.

Editing a Blacklist Item

To edit a blacklist item you will first need to locate it through the View/Search interface. When you locate the item you want to edit, click on the icon to bring up the blacklist item editing interface. This interface is nearly identical to the blacklist item addition interface, and has the same form fields with the same properties. You can make the changes that you want, and then press the Update Blacklist Item button to save your changes.

Deleting a Blacklist Item

To delete a blacklist item you will first need to locate it through the View/Search interface. When you locate the item you want to delete, click on the icon, which will ask you to confirm the deletion.

You can also delete several items at once by putting a check in the box next to the items you want to delete, then pressing the Delete button at the bottom of the page.