Private Messages Enhancements - Mass Private Messages

Notice: This mod uses Re-usable Code, so please feel free to port it to vbulletin 4 under your username. Thanks.

What does this modification do?
On memberlist select multiple users for Mass Private Messages them. This is done by only 2 template edits
What is Mass PM? It's like Mass Mail in admincp. You write one pm to multiple users.

How to
In template memberlist_resultsbit replace

</tr>

with

<td class="$bgclass"><input type="checkbox" name="deletebox[$userinfo[userid]]" value="$userinfo[userid]" /></td>
</tr>

In template memberlist replace

<form action="profile.php?do=deleteusergroups&amp;usergroupid=$usergroupid" method="post">
<input type="hidden" name="do" value="deleteusergroups" />
<input type="hidden" name="s" value="$session[sessionhash]" />
<input type="hidden" name="securitytoken" value="$bbuserinfo[securitytoken]" />
<input type="hidden" name="usergroupid" value="$usergroupid" />

with

	<script type="text/javascript">
	<!--
	function pm(tform)
	{
		var users = new Array();
		var arrCount = 0;
		for (i = 0; i < tform.elements.length; i++)
		{
			var element = tform.elements[i];
			if ((element.name != "allbox") && (element.type == "checkbox") && (element.checked == true))
			{
				users[arrCount] = element.value;
				arrCount++;
			}
		}
		if (arrCount == 0)
		{
			alert("$vbphrase[no_users_selected]");
		}
		else
		{
			var querystring = "";
			for (i = 0; i < users.length; i++)
			{
				querystring += "&userid[]=" + users[i];
			}

			self.location=	"private.php?$session[sessionurl]do=newpm" + querystring;

		}
	}
	// -->
	</script>
<if condition="$totalcols++"></if>
<form action="private.php" method="post" name="vbform">

In template memberlist also replace the second instance this code appears:

</form>

with

<input type="button" class="button" value="$vbphrase[send_private_message_to_selected_users]" onclick="pm(this.form);" title="title" style="float:right"/>
</form>

In template memberlist also replace

</tr>
$memberlistbits

with

<td class="thead" align="right"><input type="checkbox" name="allbox" title="$vbphrase[check_uncheck_all]" onclick="js_check_all(this.form);" />$vbphrase[check_uncheck_all]</td>
</tr>
$memberlistbits

How does this template modification work?
This template edit puts a checkbox right to each user. If you click on "Send PMs", the small javascript generates a custom url "private.php?do=newpm&userid[]=1&userid[]=2&userid[]=3" and refreshes actual window with this url. Javascript code is mostly from Quick Links > Open Buddy List.

FAQ

Originally Posted by chikkoo

I installed this product. But I don't want to show this feature to everyone. Is there a way to restrict few usergroups, such as admin, supermoderators and moderators?

You can for example only show this mod for moderators, supermoderators and administrators (usergroups 5,7,6). Note that you have to put this condition for any template edit you want to only show to these usergroups.

<if condition="in_array($bbuserinfo[usergroupid], array(5,6,7))">
here you do put template edits
</if>

[Hornstar]

hey do you think you could make a different hack but similiar to this where you can mass pm from within the admincp (I'd like to mass pm certain usergroups sometimes, but I can only email them currently) you would rock if you could do that version.

anyway, thanks for this release, it might come in handy down the track.

[ThorstenA]

This modificationen makes use of memberlist template and therefore has to be completely rewritten for an admincp version. That is why I will not write an admincp version. I'd be glad if another one would complete this task.

[NFLfbJunkie]

I am unsure as to what needs to be done to restrict this to certain user groups. Where exactly does this go and what gets placed in the "here you do put template edits"?

<if condition="in_array($bbuserinfo[usergroupid], array(5,6,7))">
here you do put template edits
</if>

[ThorstenA]

Originally Posted by Junkie

I am unsure as to what needs to be done to restrict this to certain user groups. Where exactly does this go and what gets placed in the "here you do put template edits"?

<if condition="in_array($bbuserinfo[usergroupid], array(5,6,7))">
here you do put template edits
</if>

You have to do this for all changed parts of this template (4x).

[NFLfbJunkie]

Sould I would put "<if condition="in_array($bbuserinfo[usergroupid], array(5,6,7))">" at the beginning of your edits and then </if> at the end of your edits?

So your last edit

<td class="thead" align="right"><input type="checkbox" name="allbox" title="$vbphrase[check_uncheck_all]" onclick="js_check_all(this.form);" />$vbphrase[check_uncheck_all]</td>
</tr>
$memberlistbits

Would be

<if condition="in_array($bbuserinfo[usergroupid], array(5,6,7))">
<td class="thead" align="right"><input type="checkbox" name="allbox" title="$vbphrase[check_uncheck_all]" onclick="js_check_all(this.form);" />$vbphrase[check_uncheck_all]</td>
</tr>
$memberlistbits
</if>

[ThorstenA]

Only changes from template should be within new <if conditions>. For last change it would be like this:

<if condition="in_array($bbuserinfo[usergroupid], array(5,6,7))">
<td class="thead" align="right"><input type="checkbox" name="allbox" title="$vbphrase[check_uncheck_all]" onclick="js_check_all(this.form);" />$vbphrase[check_uncheck_all]</td>
</if>

[NFLfbJunkie]

Why was this left out? I'm still confused. Not that advanced of a coder.

</tr>
$memberlistbits

[ThorstenA]

Originally Posted by Junkie

Why was this left out? I'm still confused. Not that advanced of a coder.

</tr>
$memberlistbits

This is html code from original template. You have to display this html code for all usergroups.

[NFLfbJunkie]

Would it be possible to get each of the required edits with the additional usergroup code? If so, can you PM it to me?