--------------------------------
Guest Anti-Spam Addon for miniBB
Author: lime (as_ziggy@yahoo.com), Paul @ minibb.com
Release date: October 24, 2006
Update date: February 5, 2026
miniBB Version: 3.4 and higher
--------------------------------

The Guest Anti-Spam Addon is an addon made for minibb to prevent guests from posting links or urls. There is also an option, which prevents registered members, who has made less than X posts, from posting by the same rules.


Included files
--------------
- README.txt: installation instructions
- addon_anti_guest.php: main plugin file
- addon_anti_guest_dict.php: forbidden terms dictionary file
- bb_plugins.code.txt: file containing code snipper for bb_plugins.php
- lang-eng.php.txt: file containing variables for the language pack

- how_it_looks/forbidden_term.jpg: screenshot showing the warning message displayed, if URL is entered
- how_it_looks/forbidden_url.jpg: screenshot showing the warning message displayed, if forbidden term is entered


Installation / modification Instructions
----------------------------------------
1. Upload addon_anti_guest.php, addon_anti_guest_dict.php into your forum's folder.

2. Paste the code provided in bb_plugins.code.txt, into bb_plugins.php (specify $membersRule setting, if necessary).

3. Forbidden words dictionary is kept in addon_anti_guest_dict.php file. Modify array of words in this file, if you find it necessary, by the same schema as common spam words are already defined. If your forums encoding is UTF-8, it's possible to add forbidden words in UTF-8 as well.

4. Paste the variables provided in lang/eng.code.txt, into your language pack (most preferrably to the end; use a dirrefent postfix-code for your forums language, or translate).


==NOTES==

* When the "Limits" mode is enabled ($ag_limitsEnabled in addon_anti_guest_options.php is set to TRUE), the script will consider all messages posted in a certain time range, which also includes the Closed forums. If you see that someone is spamming your forums with waste messages, do not reset messages amount related to this account, just deleting them. It is better to have kind of closed forum with a related topic in it, let's say named "Deleted messages", and then you have to *Move* messages to this topic or forum, and not delete them right away. That way you will keep the amount of currently posted messages in a time range, this will prevent a certain account spamming in the same day.


Updates (by Paul)
-------
November 24, 2006 
- Update concerning request descriptions http://www.minibb.com/forums/12_4264_0.html#msg25981
- Code optimization
- Compatibility with Preview addon

November 2, 2006
- Edited addon_anti_guest.php so that checking for forbidden terms is now case insensitive

November 7, 2006
- Fixed premature break in for loop to loop through all forbidden terms.

March 12, 2013
- `htmlspecialchars` replaced to `operate_string`; updated vocabulary

October 27, 2014
- updated vocabulary; display_footer() replaced the older footer's code

September 17, 2019
- addon_anti_guest_options.php - new configuration file; updated addon_anti_guest_dict.php; addon_anti_guest.php now contains more advanced codes to care of various member account limitations and flood filters; language codes updated.

Copyright License
-----------------
This addon is made for miniBB and miniBB is released under GPL so this addon is also released under GPL. Check the COPYING file in your miniBB files to see the full license.
