*****************************************************
* Ignore User - Modification for SMF                *
* version 1.4                                       *
* © 2006, Rudolf Martincsek                         *
*****************************************************
Please read thoroughly this file, because it contains vital information on how to use and/or customize other themes to use with this mod. If still in trouble visit the official thread over the official SMF support forum.

Table of contents
  1. Description
  2. Installation
  3. Usage
  4. Customizing
  5. Final notes
  6. Changelog

1. Description

This mod will allow users to ignore other users. In place of the posts of the ignored users there will be a short message displayed, letting you now that the current user is ignored by you. This doesn't breaks the flow of the topic!

2. Installation

This mod has been tested with SMF versions 1.1 Final and 1.1 RC3.
Install using the Package Manager in your forum's Admin section. Before you install this version make sure you uninstall any previous versions. This will not remove your settings.
This mod supports only the 'default' theme. (Note: The "default" one that came with SMF, and not your forum's default!) If you are using another theme or a modified version of this one, consult the "4. Customizing" section below.
Uninstalling the mod will *not* remove your ignore settings! Reinstalling or upgrading your mod will use the already existing settings.

3. Usage

You can Ignore/Unignore a user by clicking on the link in the "Author info" included with every single post.
You can also manage your ignore list by going in your Profile-> Ignore User options
Administrators will find the settings in Admin-> Features and Options.

4. Customizing

This mod changes the 'default' theme. If you're using a different theme, you will have to apply the theme modifications for every theme where you want this feature to work. Not modifying a theme to support this mod will *not* break your forum, said theme, or computer. You will not see the "Ignore" link and posts will not be ignored, they will be shown as usual.
If you want to modify a theme there are two ways you can do it.
a) Open the package and look at the theme.xml file. If you understand the format you can apply the changes to your theme following the operations done there. Obviously this is the hard way.
b) The normal way would be to search for the default template files open it and copy over your themes the modified parts.

The template files would be: Display.template.php, Profile.template.php and Post.template.php. You can find these in 'Themes\default' folder.
You will find sections between //-IGNORE MOD- Start and //-IGNORE MOD- End. The code betwen this you'll have to copy in the template files of the other theme, in the same place. Occasionally you will find a simple //-IGNORE MOD- something comment. In this case only the line is added/modified.
Note: The code in other template files could look different. If it's so you'll have to figure out the correct place where to put the code. Experiment. If everything else fails, ask for support.

This mod is language customizeable. That is if you are using another language then english you can and you will have to translate it.
How to translate:
The language files are: index.english.php, Profile.english.php, ModSettings.english.php, Help.english.php files. Copy the sections into your template.yourlanguage.php files, translating the text to the right of the equal sign (=). Note: Use single quotes(') to wrap the text, and escape any single quote(') in the body of the text with the slash (\). Ex: 'Your\'s truly.'
You will need four buttons translated in your language if you're using buttons in your theme. These are: ignore.gif , unignore.gif , ignshow.gif , ignhide.gif. You'll find these in the "Themes/default/images/english" folder. The translated buttons should be placed in "Themes/yourtheme/images/*language*" folder.

5. Final notes

  1. You can't ignore yourself.
  2. You can ignore anyone else, including guests.
  3. Forum management(admins, moderators) can be protected.
  4. You can prevent forum management(admins, moderators) from ignoring members.
  5. You can protect additional member groups.
  6. You can prevent additional member groups from ignoring members.
  7. If you ignore one guest you will ignore them all.
  8. In your blacklist write guest to ignore them.
  9. Guests can't ignore.

Changelog:

Ignore user 1.4 - august 2007
!The ignore/unignore button redirects to the same post (Ignore.db, Display.template.php) (Post.php, Post.template.php)

Ignore user 1.3 - december 2006
!Topic summary was not respecting the various ignore settings. (Post.php, Post.template.php)
!Fixed bug in loading the ignore list information (Load.php)
+Recent posts on the board index are filtered (Recent.php)

Ignore user 1.3 - september 2006
+ Setting to allow usage for forum management
+ Setting to allow members to ignore forum management
+ Ability to set restrict usage for additional groups
+ Ability to set protect additional groups from being ignored
+ Profile summary shows how many members are ignoring the viewed member
+ Profile -> Ignore user options area shows the list of members that are ignoring the viewed member
+ Setting to allow non-administrative members to view the 'ignored_by' list
+ Ignored members' posts are hidden in the topic summary while posting.
+ Rewrote and optimized the whole 'engine'!

Ignore user 1.2 - december 2005
+ Ignores poster info

Ignore user 1.2 - october 2005
+ Admin option to allow/disallow ignoring administrators and moderators

Ignore user 1.1 - august 2005
+ Settings panel added for managing the ignore list in "Profile->Ignore User options" (!)
+ Buttons added for links (+4 images) (!)
+ Language file added (!)
+ Template file added
+ Fixed bugs in the 'ignore' system
+ Fixed errors in the table creation procedure
+ Optimized some code and the installation
+ Cleaned up files

Ignore user 1.0 - august 2005
+ First release