User Ignore Mod (v1.2.1) - Released September 28, 2004

---[ Summary ]----------------------------------------------------------------

This is a mod for phpBB. (http://www.phpbb.com/) It adds the functionality 
where users can ignore the posts of other users by adding them to their 
ignore list. If a user is ignored, their post will appear as blank, but 
can be temporarily bypassed to view.

There is also an administrative panel (as "Ignore Stats" in the User 
section) that provides statistics of the top 10 folks who are ignore, the 
top 10 folks ignoring the most people, as well as the full dump of all 
ignores. I find this information helpful in assessing trolls on a large 
board.

---[ Installation ]-----------------------------------------------------------

I heavily reccomend that you install this module with EasyMod if at all 
possible. I've tried to make it friendly to the most current versions of 
easy mod. (version beta1 - 0.1.13 as of this writing)

To install this module via EasyMod you will need to copy this directory 
("user_ignore") into the "admin/mods" directory within your install of 
PhpBB.

At that EasyMod should be able to find the "UserIgnore.mod" instruction 
file and install it three very-easy steps.

If you must install this without using EasyMod, you just need to follow 
the steps outlined in UserIgnore.mod. The EasyMod directions are human 
readable. (The individual directions are marked within the squre brackets 
withing the comment sections. The code to be added or edited follows each 
comment section. For the copy commands you are copying from this install 
directory into the root of your phpBB install directory.)

There are more than 50 steps including a SQL statement to create the 
table and the editing of 7 files. So it will take some time to execute 
manually.

---[ History ]----------------------------------------------------------------

I cannot take full credit for this module. And if it ever appears that I 
do, please correct me. This module was originally written by GunnerX 
(Romar Armas - <gunnerx@gunnerx.net>) and was also credited to The phpBB 
Group.

GunnerX's version (v1.1.1) appears to have been last released in October 
of 2002 for v2.0.3 of phpBB. Unfortunately, changes were made to phpBB 
which made this module fuction inappropriately. When I installed it on my 
v2.0.6 board, I figured these problems out and fixed them.

Later as time progressed, I added the administrative panel. While 
rebuilding my site for a fresh reload of v2.0.10 I noticed that the User 
Ignore mod was still out of date. So I packaged my own changes and this is 
what you have now. I am assuming this is abandonware. If not, the code is 
welcome to whomever would like it.

In all possible places I have retained original copyright where original 
code exists.

---[ Changes ]----------------------------------------------------------------

  2004-09-28 - Version 1.2.1

    - Appropriate use of $lang in the admin page.

  2004-09-26 - Version 1.2.0 (Release Candidate)

    - Updated from 'dead' 2.0.3 version to 2.0.6-2.0.10 compliance
    - Admin Interface now available 
    - Improved EasyMod compatibility

  2002-10-16 - Version 1.1.1

    - Minor bug fix in viewtopic.php
    - Most recent release bu GunnerX

---[ (un?)Known Issues ]------------------------------------------------------

The following issues are on slate to be addressed:

  - Deleting a user needs to remove their ignore preferences and any 
    ignores of that user from the ignore table.

  - The user's profile panel should list users that are ignored and have a 
    link to go to the ignore page to addd more.

  - Better pagination of the full-list of ignores.

  - The ignore icon is ugly. A more subtle icon (since it is on every post)
    should be found.

  - Admin configurable setting if moderators are allowed to be ignored.

  - Should ignore block private messages. Possibly user configurable.

---[ Contact ]----------------------------------------------------------------

Further information on this module and its author can be found at: 

  http://www.crescendo.net/software/phpbb-ignore/

