Moderators Functions - One-touch Spam Ban and Cleanup

*** Staff note: The author of this modification has passed away in a diving accident. We wish his family all strength in dealing with this tragic issue. ***

One-touch Spam Ban and Cleanup




The main purpose of this mod is to clean up after a spammer. With a minimum of fuss it will:

• Delete all threads started by the spammer
• Delete all posts made by the spammer
• Delete all PMs sent to other members by the spammer
• Delete all calendar events made by the spammer
• Ban or delete the spammer as you like
• Ignore permissions - posts can be deleted in areas that a moderator may not have access to.

The option to activate this tool appears in the drop-down menu in the postbit, as well as on the profile page. From here it is a "one-touch" operation, with the small exception that you must press a confirmation button before the cleanup is made.




See the screenshot for the various options, but some of the more interesting ones are:

• You can specify individual users (in addition to groups) who can use this tool. This means certain trusted, non-moderator users could have the ability to clean up spam and ban spammers.
• You can specify users or groups who are protected - they cannot be deleted by this tool.
• By default, users who have registered more than 30 days ago are also protected from this tool (spammers tend to be caught and removed fairly soon after registration)
• You can turn the various deletion targets (threads, posts, events, PMs) on or off
• Select between hard delete or soft delete

This mod is similar to some older mods, but improved in a number of ways:

• You also have the choice to alter the standard ban and delete reasons before you press confirm.
• Deletes more types of spam (PMs, events)
• Simple, quick, effective
• Single file import (.xml) no file edits, no template edits, no .php files to upload
• Should work on all versions of 3.6.x and future versions

Installation

Download and import the .xml file via AdminCP -> Plugins & Products -> Manage Products -> Add/Import Product. Remember to click overwrite if upgrading

Configuration

Once installed, check in your AdminCP under "VBulletin settings" and look for the configuration group called "One-touch Spam Ban & Cleanup Options". The default options should be fine for most people.

How to use

If you have rights to use this tool (i.e. are an admin or moderator, or have configured it for the relevant user or group ID) you should see the option appear on the member profile page, or in a drop-down on the postbit (see attached screenshots for an example). The idea is that as soon as you see a spammer select the "One-touch Ban & Clean" option to remove all trace of the spammer.

Support




Support will be given to those who have:

• Read these instructions (and followed them) and
• Clicked install

Version history

1.0 - initial version (28.08.2007)
1.1 - security fix (21.09.2007)
1.2b - Beta Fix to work with vb3.7.0 (20.05.2008)

[perfphysio]

Originally Posted by mfyvie

Please read back through earlier posts in this thread.

I did this in the beginning but to know avail. Perhaps letting us know the message # would be good when referring to the potential solution.

I found the folllowing:

Check through your template (postbit) look for $template_hook[postbit_user_popup] - it should be right at the end, just before the final </table> tag. If it's not there, add it - but better would be ask yourself WHY it isn't there. These hooks should be in the templates of all recent versions of vbulletin. Other hacks may use them as well.

I did not find it and so tried to add it but this resulted in an error so I backed out of it again. Might there be more to this? I am using 3.6.8

[mfyvie]

Originally Posted by perfphysio

I did this in the beginning but to know avail. Perhaps letting us know the message # would be good when referring to the potential solution.

I found the folllowing:

I did not find it and so tried to add it but this resulted in an error so I backed out of it again. Might there be more to this? I am using 3.6.8

This template hook should appear in the version of vbulletin you are using, in the template called postbit. If not - chances are you are still running a postbit template from an older version of vbulletin, and you have not reverted this template during previous upgrades. If you are running other templates which have not been reverted to the latest versions, then you may run into other problems. Normally a warning appears in the admincp that there are templates that need to be reverted. You may want to double check if you have such messages, or refer to the vbulletin documentation concerning upgrades.

[MotoMihalich]

Originally Posted by mfyvie

Your suggestion seems to have nothing to do with modification (unless I have missed something). If you'd like to make a suggestion about writing a different hack, please use the appropriate forum at vbulletin.org for this purpose.

I am not familiar on writing mods, but I have manually edited the following in the register.php file:

PHP Code:

                foreach ($newemails AS $toemail)
                {
                    if (trim($toemail))
                    {
                        vbmail($toemail, $subject, $message);
                    }
                } 


and changed to:

PHP Code:

                global $isbot_time1;
                $isbot_timediff = intval(TIMENOW - $isbot_time1);
                foreach ($newemails AS $toemail)
                {
                    if (trim($toemail))
                    {
                        vbmail($toemail, $subject, $message."\nRegistration preiod: $isbot_timediff sec.");
                    }
                } 


Now each time I get New User Notification it shows me how much time has a real user passed during registration. Maybe you can arrange this manual change as plugin/mod?

[BobbyBig]

There still is a problem with showing it in the popup menu on a 1.6.4.

$template_hook[postbit_user_popup] can not be found in postbit template, also not in standard instalation templates. Where to add it in the tempalte ?

thanks
regards

[alexi]

I've installed this hack and it would be wonderful to get it working.
When I use it, it deletes posts and threads properly but does not ban the user or the IP address, it just grinds away untill eventually I get a time out error.

[tekguru]

Originally Posted by mfyvie

Check through your template (postbit) look for $template_hook[postbit_user_popup] - it should be right at the end, just before the final </table> tag. If it's not there, add it - but better would be ask yourself WHY it isn't there. These hooks should be in the templates of all recent versions of vbulletin. Other hacks may use them as well.

Interestingly enough I use the Aria+ Skins and the postbit template was as follows:

$template_hook[postbit_start]
<if condition="$post[postcount] == 1"><div class="spacer"></div><else /></if><table   border="0" cellpadding="0" cellspacing="0"  width="100%"  align="center">
  <tr>
    <td width="21" height="31" align="left" valign="top" style="background-image: url($stylevar[imgdir_misc]/top_bg.gif)"><img border="0" src="$stylevar[imgdir_misc]/top_left.gif" width="21" height="31" alt="" /></td>
    <td  height="31" width="80%" align="left" valign="middle" style="background-image: url($stylevar[imgdir_misc]/top_bg.gif)"><div class="category_title">$post[title]</div></td>
    <td width="19" align="left" valign="middle"><img src="$stylevar[imgdir_misc]/top_end.gif" alt="" width="19" height="31" border="0" /></td>
    <td  align="right" valign="top" style="background-image: url($stylevar[imgdir_misc]/top_center.gif)"><a style="float:$stylevar[right]; padding-top: 9px;" href="#top" onclick="return toggle_collapse('postbit_$post[postid]')"><img id="collapseimg_postbit_$post[postid]" src="$stylevar[imgdir_button]/collapse_tcat{$GLOBALS['vbcollapse']['collapseimg_postbit_' . $post[postid]]}.gif" alt="" border="0" /></a>
    </td>
    <td width="14" height="31" align="right" valign="top"><img border="0" src="$stylevar[imgdir_misc]/top_right.gif" width="14" height="31" alt="" /></td>
  </tr>
</table>

<table class="tborder" id="post$post[postid]" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tbody id="collapseobj_postbit_$post[postid]" style="{$GLOBALS['vbcollapse']['collapseobj_postbit_' . $post[postid]]};">
<tr>
	<td class="thead" $post[scrolltothis]>
		
			<!-- status icon and date -->
			<div class="normal">
			<a name="post$post[postid]"><img class="inlineimg" src="$stylevar[imgdir_statusicon]/post_$post[statusicon].gif" alt="$post[statustitle]" border="0" /></a><if condition="$show['inlinemod']"><input type="checkbox" name="plist[$postid]" id="plist_$postid" style="vertical-align:middle; padding:0px; margin:0px 0px 0px 5px" value="$post[checkbox_value]" /></if>
			
		</div>
			<!-- / status icon and date -->				
		</td>
		
		<td class="thead" style="font-weight:normal">
		
	<div class="normal" style="float:$stylevar[right]">
			&nbsp;
			<if condition="$show['postcount']">(#<a href="showpost.php?$session[sessionurl]p=$post[postid]&amp;postcount=$post[postcount]" target="new" rel="nofollow" id="postcount$post[postid]" name="$post[postcount]">$post[postcount]</a>)</if>
		</div>
		</td>
	
</tr>


<tr valign="top">
	<td class="userinfo_bg" width="175">
			
			<div id="postmenu_$post[postid]">
					<if condition="$show['profile']">
					<a class="bigusername" href="member.php?$session[sessionurl]u=$post[userid]">$post[musername]</a>
					<script type="text/javascript"> vbmenu_register("postmenu_$post[postid]", true); </script>
					<else />
					$post[musername]
					</if>
				</div>
				
				<if condition="$post['usertitle']"><div class="smallfont">$post[usertitle]</div></if>
				<if condition="$post['rank']"><div class="smallfont">$post[rank]</div></if>
$template_hook[postbit_userinfo_left]
				
					
<if condition="$show['reputation']"><div style="padding:2px 0px 2px 0px;"></div><div><span id="repdisplay_$post[postid]_$post[userid]">$post[reputationdisplay]</span></div></if>
$template_hook[postbit_userinfo_right]
		
			<if condition="$show['avatar']">
				<div class="smallfont">
					&nbsp;<br /><a href="member.php?$session[sessionurl]u=$post[userid]"><img src="$post[avatarurl]" $post[avwidth] $post[avheight] alt="<phrase 1="$post[username]">$vbphrase[xs_avatar]</phrase>" border="0" /></a>
				</div>
			</if>
			
			<div class="smallfont">
				&nbsp;<br />
				<div class="vb_postbit_info"><span class="smallfont">$vbphrase[potbit_online_status]</span> $post[onlinestatus]</div>
				<div class="vb_postbit_info">$vbphrase[posts]: $post[posts]</div>


				<if condition="$post['joindate']"><div class="vb_postbit_info">$vbphrase[join_date]: $post[joindate]</div></if>
				<if condition="$post['field2']"><div class="vb_postbit_info">$vbphrase[location_perm]: $post[field2]</div></if>
				<if condition="$post['field3']"><div class="vb_postbit_info">PDA(s): $post[field3]</div></if>
				<if condition="$post['field5']"><div class="vb_postbit_info">Operator: $post[field5]</div></if>
				<if condition="$post['age']"><div class="vb_postbit_info">$vbphrase[age]: $post[age]</div></if>
				<if condition="$show['infraction']"><div class="vb_postbit_info">$vbphrase[infractions]: $post[warnings]/$post[infractions] ($post[ipoints])</div></if>
				<if condition="$show['reputation']"><if condition="$show['reppower']"><div class="vb_postbit_info"><span id="reppower_$post[postid]_$post[userid]">$vbphrase[reppower]</span>: $post[reppower]</div></strong></if></if>
				<div class="vb_postbit_info">$template_hook[postbit_userinfo_right_after_posts]</div>
				
			</div>		
$template_hook[postbit_userinfo_right]			
		<div style="padding:5px 0px 5px 0px;"></div>
		
	</td>
	
	



	
	<td height="100%" valign="top" class="alt2" id="td_post_$post[postid]">
	
	
	
	<div style="float:right;">

<if condition="$show['reputationlink']">
				<span id="reputationmenu_$post[postid]"><a href="reputation.php?$session[sessionurl]p=$post[postid]" rel="nofollow" id="reputation_$post[postid]"><img class="inlineimg" width="20" height="20" src="$stylevar[imgdir_button]/reputation.gif" alt="<phrase 1="$post[username]">$vbphrase[add_to_xs_reputation]</phrase>" border="0" /></a></span>
				<if condition="$show['popups']"><script type="text/javascript"> vbrep_register("$post[postid]")</script></if>
			</if>
		
			<if condition="$show['reportlink']"><a href="report.php?$session[sessionurl]p=$post[postid]" rel="nofollow"><img class="inlineimg" width="20" height="20" src="$stylevar[imgdir_button]/report.gif" alt="$vbphrase[report_bad_post]" border="0" /></a></if>

<if condition="$show['infractionlink']"><a href="infraction.php?$session[sessionurl]do=report&amp;p=$post[postid]" rel="nofollow"><img class="inlineimg" width="20" height="20" src="$stylevar[imgdir_button]/infraction.gif" alt="<phrase 1="$post[username]">$vbphrase[add_infraction_for_x]</phrase>" border="0" /></a> </if>  
$post[iplogged]<if condition="is_browser('ie')"><div style="padding: 2px 0px 0px 0px;"></div></if></div><div class="smallfont">
		<if condition="$show['messageicon'] OR $post['title']">
            <!-- icon and title -->
            <if condition="$show['messageicon']"><img class="inlineimg" src="$post[iconpath]" alt="$post[icontitle]" border="0" /></if>
				<if condition="$post['title']"><strong>$post[title] - </strong></if>
            <!-- status icon and date -->
          </if>
		
		
			<!-- status icon and date -->	
		<if condition="!$show['announcement']">
				$post[postdate]<if condition="!$show['detailedtime']">, $post[posttime]</if>
			<else />
				<phrase 1="$post[startdate]" 2="$post[enddate]">$vbphrase[x_until_y]</phrase>
			</if>
			$post[firstnewinsert]
			<!-- / status icon and date -->
		</div>
		
<div class="spacer"></div>	

<div class="hr" style="width: 100%;">
              <hr />
            </div>	
<div class="spacer"></div>
		$template_hook[postbit_messagearea_start]
		<!-- message -->
		<div id="post_message_$post[postid]" class="vb_postbit">$post[message]</div>
		<!-- / message -->
	
		<if condition="$show['attachments']">
		<!-- attachments -->
			<div style="padding:$stylevar[cellpadding]px">
			
			<if condition="$show['thumbnailattachment']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attached_thumbnails]</legend>
					<div style="padding:$stylevar[formspacer]px">
					$post[thumbnailattachments]
					</div>
				</fieldset>
			</if>
		
			<if condition="$show['imageattachment']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attached_images]</legend>
					<div style="padding:$stylevar[formspacer]px">
					$post[imageattachments]
					</div>
				</fieldset>
			</if>
			
			<if condition="$show['imageattachmentlink']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attached_images]</legend>
					<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
					$post[imageattachmentlinks]
					</table>
					</fieldset>
			</if>
			
			<if condition="$show['otherattachment']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attached_files]</legend>
					<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
					$post[otherattachments]
					</table>
				</fieldset>
			</if>
			
			<if condition="$show['moderatedattachment']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attachments_pending_approval]</legend>
					<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
					$post[moderatedattachments]
					</table>
				</fieldset>		
			</if>
			
			</div>
		<!-- / attachments -->
		</if>
		$template_hook[postbit_signature_start]
		<if condition="$post['signature']">
		<!-- sig -->
			<div> <br />
            <div class="hr" style="width: 100px;">
              <hr />
            </div><div class="spacer"></div>
				$post[signature]
			</div>
		<!-- / sig -->
		</if>
		$template_hook[postbit_signature_end]
		<if condition="$show['postedited']">
		<!-- edit note -->
			<div class="smallfont">			<div class="spacer"></div>
          <div class="hr">
            <hr />
          </div><div class="spacer"></div>
				<em>
				<phrase 1="$post[edit_username]" 2="$post[edit_date]" 3="$post[edit_time]">$vbphrase[last_edited_by_x_on_y_at_z]</phrase>.
				<if condition="$post['edit_reason']">$vbphrase[reason]: $post[edit_reason]</if>
				</em>
			</div>
		<!-- / edit note -->
		</if>
	
	</td>
</tr>
<tr>
	<td class="postbit_bl">
	
	<div>&nbsp;$post[icqicon] $post[yahooicon] $post[aimicon] $post[msnicon] $post[skypeicon]&nbsp;</div>
		
	</td>
	
	<td class="postbit_br" align="$stylevar[right]">
	
		<!-- controls -->
		
	<div style="float:left">
			<if condition="$show['moderated']">
				<img src="$stylevar[imgdir_misc]/moderated.gif" alt="$vbphrase[moderated_post]" border="0" />
			</if>
			<if condition="$show['deletedpost']">
				<img src="$stylevar[imgdir_misc]/trashcan.gif" alt="$vbphrase[deleted_post]" border="0" />
			</if>
			<if condition="$show['redcard']">
				<a href="infraction.php?$session[sessionurl]do=view&amp;p=$post[postid]"><img src="$stylevar[imgdir_button]/redcard.gif" alt="$vbphrase[received_infraction]" border="0" /></a>
			<else />
				<if condition="$show['yellowcard']">
					<a href="infraction.php?$session[sessionurl]do=view&amp;p=$post[postid]"><img src="$stylevar[imgdir_button]/yellowcard.gif" alt="$vbphrase[received_warning]" border="0" /></a>
				</if>
			</if>
			
			
			</div>
			
			<if condition="$post['editlink']">
			<img style="display: none" id="progress_$postid" src="$stylevar[imgdir_misc]/progress.gif" alt="$vbphrase[loading_editor_please_wait]" />
			<a href="$post[editlink]" name="vB::QuickEdit::$post[postid]"><img src="$stylevar[imgdir_button]/edit.gif" alt="$vbphrase[edit_delete_message]" border="0" /></a>
		</if>
		<if condition="$post['forwardlink']">
			<a href="$post[forwardlink]"><img src="$stylevar[imgdir_button]/forward.gif" alt="$vbphrase[forward_message]" border="0" /></a>
		</if>
		<if condition="$post['replylink']">
			<a href="$post[replylink]" rel="nofollow"><img src="$stylevar[imgdir_button]/<if condition="$post['forwardlink']">reply_small<else />quote</if>.gif" alt="$vbphrase[reply_with_quote]" border="0" /></a>
		</if>
		<if condition="$show['multiquote_post']">
			<a href="$post[replylink]" rel="nofollow" onclick="return false"><img src="$stylevar[imgdir_button]/multiquote_<if condition="$show['multiquote_selected']">on<else />off</if>.gif" alt="$vbphrase[multi_quote_this_message]" border="0" id="mq_$post[postid]" /></a>
		</if>
		<if condition="$show['quickreply'] AND !$show['threadedmode']">
			<a href="$post[replylink]" rel="nofollow" id="qr_$post[postid]" onclick="return false"><img src="$stylevar[imgdir_button]/quickreply.gif" alt="$vbphrase[quick_reply_to_this_message]" border="0" /></a>
		</if>
		
	$template_hook[postbit_controls]	
		<!-- / controls -->
	</td>
</tr>
</tbody></table>
<table width="100%" border="0" cellpadding="0" cellspacing="0">
      <tr>
        <td width="12" align="left" valign="top"><img src="$stylevar[imgdir_misc]/blc.gif" width="12" height="13" alt="" border="0" /></td>
        <td  width="100%" style="background-image:url($stylevar[imgdir_misc]/bottom.gif)"><img src="$stylevar[imgdir_misc]/clear.gif" width="100%" height="13" alt="" border="0" /></td>
        <td width="12" align="right" valign="top"><img src="$stylevar[imgdir_misc]/brc.gif" width="12" height="13" alt="" border="0" /></td>
      </tr>
    </table>
$template_hook[postbit_end]
$postbit_advertisement
<!-- post $post[postid] popup menu -->
<div class="vbmenu_popup" id="postmenu_$post[postid]_menu" style="display:none">
	<table cellpadding="4" cellspacing="1" border="0">
	<tr>
		<td class="thead">$post[username]</td>
	</tr>
	<if condition="$show['profile']">
		<tr><td class="vbmenu_option"><a href="member.php?$session[sessionurl]u=$post[userid]">$vbphrase[view_public_profile]</a></td></tr>
	</if>
	<if condition="$show['pmlink']">
		<tr><td class="vbmenu_option"><a href="private.php?$session[sessionurl]do=newpm&amp;u=$post[userid]" rel="nofollow"><phrase 1="$post[username]">$vbphrase[send_private_message_to_x]</phrase></a></td></tr>
	</if>
	<if condition="$show['emaillink']">
		<tr><td class="vbmenu_option"><a href="sendmessage.php?$session[sessionurl]do=mailmember&amp;u=$post[userid]" rel="nofollow"><phrase 1="$post[username]">$vbphrase[send_email_to_x]</phrase></a></td></tr>
	</if>
	<if condition="$show['homepage']">
		<tr><td class="vbmenu_option"><a href="$post[homepage]"><phrase 1="$post[username]">$vbphrase[visit_xs_homepage]</phrase></a></td></tr>
	</if>
	<if condition="$show['search']">
		<tr><td class="vbmenu_option"><a href="search.php?$session[sessionurl]do=finduser&amp;u=$post[userid]" rel="nofollow"><phrase 1="$post[username]">$vbphrase[find_more_posts_by_x]</phrase></a></td></tr>
	</if>
	<if condition="$post['userid'] AND $show['member']">
	<tr><td class="vbmenu_option"><a href="profile.php?$session[sessionurl]do=addlist&amp;userlist=buddy&amp;u=$post[userid]"><phrase 1="$post[username]">$vbphrase[add_x_to_buddy_list]</phrase></a></td></tr>
	</if>
$template_hook[postbit_user_popup] <<< MISSING
	</table>
</div>
<!-- / post $post[postid] popup menu -->

The indicated hook was indeed missing and now I've added it the Mod works perfectly!

[blind-eddie]

I added this to my site...it is enabled, but I dont think my templates were update....I dont see it on any members profile....And yes only 5,6,7 are usergroups to see it......Can anyone help me with this?

[kall]

Originally Posted by Loco.M

Just wondering how this is different from the Spam Deciminator ?

Spam Decimator is a 2-click system. This is a ... 3-click system with more features.

(How can you call it a 'One-touch' system when it requires 3 clicks?)

[blind-eddie]

Would you please add readme for all templates edited for this to work, because none of mine were edited?

[Shaheen]

Cool hack man nice