vBPunch v1.2 - A Quick Warning System

If Upgrading from version 1.1, upload all of the files in the Zip, making sure that they overwrite the old ones, then install the product XML.

If upgrading from version 1.0, please follow the instructions in the install guide in the Zip file.

Changelog
Version 1.2

• Clicking "Cancel" on the extra text prompt means that the PM will not be sent
• Adding an option to display a confirmation popup when the PM has been sent
• Fixed a bug with usergroup permission checking (thanks Osmosis)

Version 1.1

• Added a global on/off switch for vBPunch
• Added the ability to add/remove reputation points when punching
• Added usergroup permissions - you can now choose which usergroups are allowed to use vBPunch
• Now includes 3 "Punch User" images as well as the text link

What is vBPunch?
vBPunch is a quick way of sending a warning PM to a user, based on a post they have made.
It adds a link to the postbit called "Punch User". When an admin clicks this, vBPunch pops up a textbox letting the admin type a reason (if they wish, it's optional), then it sends the user a PM.

What makes vBPunch so special then???!?
The useful thing about vBPunch is that it does it all in the backgorund using Ajax. That means, no popup windows, no page refreshes, nothing. All the admin does is click the "Punch User" link, enter a reason if needed, then continues reading the thread / post, without being interupted.

Installation
Please read install.html located in the zip file

Un-installation
Please read install.html located in the zip file. Please ensure that you delete the uploaded files, before un-installing the product in the vBulletin AdminCP, otherwise you will recieve errors when you edit a usergroup.

-----------------------------------------------------------------

Important: Unfortunately, my leased vBulletin licence has now expired, and I won't be renewing it until September which means I will be unable to reply to this thread, or update this mod until then. I'm hopeful that the great vBulletin.org community will step in to answer any questions in my absence though See you all in early September!

[jugo]

LMAO...This is why I love this Community. Because even in jest we can produce some good stuff.

Awesome work.

Hey, if I change some of the Phrases can I make it a positive thing...like "The Admin" kisses (pulling name out of a hat) amykhar in the lips". or something like that?

Also, it would be a cool addon if this added or took away rep points.

BTW: INSTALLED!!!

[Alan @ CIT]

Thanks for the good comments guys

Jugo: I'll make the add/remove rep points an option in the next version.

[Bad Bunny]

Originally Posted by Hawkbizkit

yes in the plugin vBPunch : Template conditional checks change this line:

PHP Code:

 else if (can_administer()) 


To:

PHP Code:

else if (in_array($vbulletin->userinfo[usergroupid], array(5,6,7,9))) 


just add the usergroups you want to the array.

Also edit vbpunch.php on line 25:

PHP Code:

if (!can_administer()) 


With this:

PHP Code:

if (!in_array($vbulletin->userinfo[usergroupid], array(5,6,7,9))) 


Yes! I need to go gold, then my users will be spurred on to participate more as their love to punch each other in the face will be encouraged! YES!

[utw-Mephisto]

I like that addition, however, I rather moved it on the bottom of the post rather on the top ... I guess a button would be cool too rather than simple text (gonna make one soon myself).

Another idea : Instead of a link rather a drop down menu entry (Moderation) where you simply tick the post u want to punch ..

[Alan @ CIT]

Hi Mephisto,

Changing it to a button is on my todo list, and it can be placed anywhere on the postbit, just move it about

As for the dropdown, I thought about doing this, but it would mean the admin would have to tick the post, scroll down, pick Punch from the dropdown, enter the reason, then scroll back up and carry on reading. Or, they would tick multiple posts, scroll down and pick Punch from the menu, then have to enter x amount of additional text to add to the PM's (if they wanted), and all this just seemed like a lot of hassle comapred to the 2 click system at the moment.

[utw-Mephisto]

Originally Posted by Alan @ CIT

Hi Mephisto,

Changing it to a button is on my todo list, and it can be placed anywhere on the postbit, just move it about

As for the dropdown, I thought about doing this, but it would mean the admin would have to tick the post, scroll down, pick Punch from the dropdown, enter the reason, then scroll back up and carry on reading. Or, they would tick multiple posts, scroll down and pick Punch from the menu, then have to enter x amount of additional text to add to the PM's (if they wanted), and all this just seemed like a lot of hassle comapred to the 2 click system at the moment.

Ok, point for you

[jesus likes pie]

Alan, is this why you asked me to count my rows in phpmyadmin over at #vbfans about 2 weeks ago? (I'm ATI4EVER! on vbfans).

eh?

Anyways, lmao, this looks awesome but does it really "warn" as in after X ammount of warnings the user gets banned?

I would really like to see a full wrning system that uses AJAX.

[jesus likes pie]

To add to my last post (editing sucks without Ajax :P), there should be an option to just "punch" and one to actually warn. So punching would be for little stupid things that kinda break forum rules or are just stupid posts that make no sense, and another one punches AND adds a "warn", and after say, X ammount of warns the user gets banned for X ammount of days.

Ideally you should be able to change these values through the admincp. But this would then be a full warning system that is probably harder to do.

Anyways Alan, if you do this, I'll kiss your feet.

See ya at #vbfans!

[jesus likes pie]

Alright.....

now join #vbfans and we can talk real time

[Alan @ CIT]

lol - hey ATI mate,

I was asking for the number of rows in your threadrate table as I'm working on a rating system for a different project and wanted to see how well vB's performed on a big forum

At the moment, this isn't really what you'd call a real warning system (points / bans / etc), all it does is send a PM to the user with some pre-set text + whatever additional text you send. At the moment it says something along the lines of "You have been warned for this post, pleae follow the forum rules when posting"...etc - this can be changed in the Phrase manager though.

I didn't plan on adding points / bans / etc to vBPunch, but I might write another hack based on it that works as a proper warning system.

I'll see what I can do bud