Administrative and Maintenance Tools - Read PMs (PM Management Suite Lite)

Please click Mark as Installed if you are using this hack.

IMPORTANT NOTICE: This hack can only be used by Super Administrators.


What Does This Hack Do?[hr]hr[/hr]
This version is a major update (a virtual re-write, there is very little original code left) of Dream's Read PMs hack v0.7. Permission for me to release this hack is shown here, and blessings are given by Dream here.

This hack will allow you as a Super Administrator to read your member's private messages.

Please, lets not get into a discussion in this support thread about the suitability of this hack and invading privacy etc, (I have seen this happen in other threads, so, I am pre-empting people before it starts). If you have a moral objection to this hack, please don't comment on it, just don't install it, it is as simple as that. This hack is here for people who want to use it, I have no opinion about it one way or the other.

Original Features by Dream:

• List PMs separated by sent/received given a username or id
• List all users with PMs
• Search PMs by exact text, all words and at least one of the words
• List the latest X PMs sent

Fixed in this version:

• BBCode in PMs is now parsed correctly !!!!
• To and BCC fields when reading a single PM now display correctly
• If a PM is displayed in Latest X PMs that has been deleted by all parties (from, to, cc, bcc) and it has not yet been deleted permanently by the hourly cron job, it will display a proper error message when clicking on the link for it, instead of displaying a database error
• Any PMs that a user sent to others that included the themselves in the To or BCC now show up in Received PMs (they did not before)
• High server load when clicking List Users with PMs, especially if there are 1000s of users that have PMs (now split into categories acording to how many PMs a user has)

Added in this version:

• Now completely phrased (uses a language file that has 75 custom phrases that take the form $rpmphrase['phrase_name']), so can be translated into other languages very easily by creating a separate phrase file for each language
• Now available in 7 languages:
  • English
  • Italian
  • German
  • Brazilian/Portuguese
  • Spanish
  • Turkish
  • French
• Read Single PM - read a single PM by typing in pmtextid
• Minimum length for each search term, and the ability to disable it
• userids now displayed next to user (From, To and BCC)
• userids are now click-able and linked to their admincp user profile, so user can be edited (ie prune all PMs from a spammer)
• A more complete message is displayed if admin user is not super administrator, it has a link to vBulletin manual
• To column to Lastest X PMs
• To column to the recieved section of Read A User's PMs
• To and From columns to Search for PMs
• A lot of the formatting has been changed to make it look better (that is just my opinion)
• Extra links to various functions for each user
• Other things I can not think of right now

Frequently Asked Questions

Question:

How do I hide the Read PMs link?

Answer:

The only way to do so, is to not upload cpnav_rpm.xml and to use a shortcut/bookmark to http://<your-forum-path-here>/admincp/read_pms.php? instead.

Question:

How do I fix the following error when I upgrade to PHP 5.3.x and above?

PHP Code:

Deprecated: Assigning the return value of new by reference is deprecated in xxxxxx 


Answer:

The fix is available here - https://vborg.vbsupport.ru/showpost....&postcount=235

vBulletin Version Compatibility[hr]hr[/hr]
This hack can be used with vBulletin versions 3.6.0 - 3.8.8. This may even work for v3.5.x (but has not been tested).

The version of this hack that is compatible with vBulletin v4.0.0 or later versions is available here.


Hack Support[hr]hr[/hr]
IMPORTANT: This hack is no longer supported.


Branding[hr]hr[/hr]
There is a small unobtrusive block of copyright branding text at the bottom of each page generated by this hack, which is there to promote my work and allow you to use this hack for free.

You are NOT allowed to remove my copyright branding from this hack.


Install/Uninstall Instructions[hr]hr[/hr]
IMPORTANT: THERE ARE NO FILES TO IMPORT INTO THE ADMINCP

The readme.txt instructions file is included in attached .zip file. The upgrade instructions are exactly the same as the install instructions.


Translations[hr]hr[/hr]
Official Language Files (included in the zip file):

• read_pms_eng.php - English by Mosh
• read_pms_ita.php - Italian by anonymous
• read_pms_deu.php - German by Speedy1505
• read_pms_bra.php - Brazilian/Portuguese by Setokaiba (SW)
• read_pms_esp.php - Spanish by cloferba
• read_pms_tur.php - Turkish by Adem GEN?
• read_pms_fre.php - French by Dadoo

Version History[hr]hr[/hr]
v3.8.17 - Saturday 15th January 2011
-- Altered: updated 3 phrases in the Turkish language file "read_pms_tur.php"

v3.8.16 - Sunday 9th January 2011
-- Added: French language file "read_pms_fre.php" - thanks to Dadoo
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions

v3.8.15 - Saturday 8th January 2011
-- Added: Turkish language file "read_pms_tur.php" - thanks to Adem GEN?
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions

v3.8.014 - Sunday 23rd August 2009
-- Added: Spanish language file "read_pms_esp.php" - thanks to cloferba
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions

v3.8.013 - Friday 14th August 2009
-- Added: Brazilian (Portuguese) language file "read_pms_bra.php" - thanks to Setokaiba (SW)
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions

v3.8.012 - Thursday 13th August 2009
-- Added: German language file "read_pms_deu.php" - thanks to Speedy1505
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions

v3.8.011 - Wednesday 12th August 2009
-- Added: Italian language file "read_pms_ita.php" - author wishes to remain anonymous
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions on how to change language files

v3.8.010 - Saturday 25th July 2009
-- Fixed: Typo on line 63 of 'readpms.php' - thanks to Andrea (Silvio)
-- Fixed: Typo on line 171 of 'readpms.php' - thanks to macc
-- Fixed: Typo on line 476 of 'readpms.php'
-- Fixed: Typo on line 483 of 'readpms.php'

v3.8.009 - Monday 6th July 2009
-- Fixed: Invalid argument supplied for foreach() error a very small percentage of people were experiencing
-- Added: 1 phrase

v3.8.008 - Saturday 4rd July 2009
-- Fixed: Several missing </div>s
-- Fixed: Uncached BBCode templates (save up-to 4 queries when viewing a PM)
-- Added: New English language phrase file - 74 new phrases
-- Added: 'To' column to 'Lastest X PMs'
-- Added: 'To' column to the recieved section of 'Read A User's PMs'
-- Added: 'To' and 'From' columns to 'Search for PMs'
-- Updated: A virtual re-write of the base code to remove all the hard-coded phrases

v3.8.007 - Thursday 2nd July 2009
-- Fixed: Now correctly parses BBCode Tags !!!
-- Added: Correct header when viewing single PMs
-- Updated: Screenshots

v3.8.006 - Tuesday 31st March 2009
-- Fixed: High server load when finding PMs for single user id or username
-- Fixed: Problems with hacks that have custom BBCode being called by the "bbcode_fetch_tags" file hook

v3.8.005 - Saturday 28th March 2009
-- Added: Read Single PM - read a single PM by typing in pmtextid
-- Added: Ability to disable the limit minimum length a key search word can be

v3.8.004 - Friday 27th March 2009
-- Changed: Layout of PM lists, individual PMs, sent/received PMs, Search Results
-- Fixed: High server load when clicking List Users with PMs, especially if there are 1000s of users that have PMs (now split into categories acording to how many PMs a user has)
-- Removed: From info for individual users sent PMs
-- Added: Constant to limit minimum length a key search word can be, to limit higher server loads when trying to search for a keyword with a length of 1 (ie. "a"). This minimum is currently set at 4, but can be altered by editing read_pms.php)
-- Added: Various links (depending what function you are using) to view all a users PMs, go to the users pmstats page, edit the user and send the user a PM

v3.8.003 - Thursday 26th March 2009
-- Fixed: The Plain Text BBcode parser version of the PM message body was stretching the screen too wide, now word wraps

v3.8.002 - Thursday 26th March 2009
-- Fixed: The unparsed version of the PM message body was stretching the screen too wide, now instead of just leaving unparsed, I have used the Plain Text BBcode parser instead.

v3.8.001 - Tuesday 24th March 2009
-- Initial Release


Thanks[hr]hr[/hr]
A big thanks goes out to Dream, whose original hack and permission to re-use his code enabled me to release this hack.


Show Your Appreciation [hr]hr[/hr]
Although not required, if you have enjoyed the benefits of this hack, and would like show your appreciation for my efforts, then please feel free to click on the Support Developer link and donate any amount you feel is appropriate.

[pakdi]

Thank alot

[Bluetiereign]

You know, this is one of those hacks, as an admin... I don't really want to admit I have... but I got a bot that has managed to bypass vBulletin's image verification, etc... to register and then PM me with an advert for his crap that enabled him to register and spam me with PMS !

Hello, Bluetiereign!

I see you want to promote your website. More effective, for less price...
It's easy . *X*.09 P*m is a software complex, which can post to more than 1.000.000 forums, blogs, guestbooks, BBS's, boards, etc.*

It's price was grow up to $540, and continues growing.
Just use Google for purchase X*r.

P.S. Do not use X*9 and X*.0 - it is too old and buggy versions.

So... I take the time to go to the database, look up the id and get to deleting all of the spamming he has done to the other members.

So, if I want to read PM's.. I could do it anyway since I have access to the database... no, I do not want to read your PRIVATE message's... but yes, I do want a quicker way than digging through the database to see if I'm the only one getting spammmed... so yes.. I have this installed - not to read PM's - but to lighten the load a bit.

Sorry... I just hate having to actually need this. But thanks, it is useful.

[yotsume]

Originally Posted by Bluetiereign

You know, this is one of those hacks, as an admin... I don't really want to admit I have... but I got a bot that has managed to bypass vBulletin's image verification, etc... to register and then PM me with an advert for his crap that enabled him to register and spam me with PMS !

You know you really need to moderate new members by approving them first! That is what Admins and Mods are for! No bot can get in a properly moderated site! :up:

[Silvio]

Hi Mosh, and thankyou for another greatfull hack.

Is there the possibility to hide the label 'Read PMs' to the regular admin and to anyone NOT SuperAdmin?

ty 4 hints will be highly appreciated

apologises for broken english

ciao take care

edit: on script line #63 there is a little issue. I immagine the correct one should be :

rpm_print_stop_back($rpmphrase['error_no_permissions'] . '<br />' . $rpmphrase['error_no_permissions_super'] . '<br /><a href = "http://www.vbulletin.com/docs/html/what_is_superadmin">' . $rpmphrase['error_no_permissions_super_what'] . '</a>');

instead original

rpm_print_stop_back($rpmphrase['error_no_permissions'] . '<br />' . $rpmphrase['error_no_permissions_super'] . '<br /><a href = \"http://www.vbulletin.com/docs/html/what_is_superadmin\">' . $rpmphrase['error_no_permissions_super_what'] . '</a>');

[OsideRida06]

Thank you!

[Mosh]

Originally Posted by Silvio

Hi Mosh, and thankyou for another greatfull hack.

Is there the possibility to hide the label 'Read PMs' to the regular admin and to anyone NOT SuperAdmin?

ty 4 hints will be highly appreciated

apologises for broken english

ciao take care

Andrea, the only way to do so currently, is to not upload cpnav_rpm.xml and to use a shortcut/bookmark to http://<your-forum-path-here>/admincp/read_pms.php? instead.

Originally Posted by Silvio

edit: on script line #63 there is a little issue. I immagine the correct one should be :

rpm_print_stop_back($rpmphrase['error_no_permissions'] . '<br />' . $rpmphrase['error_no_permissions_super'] . '<br /><a href = "http://www.vbulletin.com/docs/html/what_is_superadmin">' . $rpmphrase['error_no_permissions_super_what'] . '</a>');

instead original

rpm_print_stop_back($rpmphrase['error_no_permissions'] . '<br />' . $rpmphrase['error_no_permissions_super'] . '<br /><a href = \"http://www.vbulletin.com/docs/html/what_is_superadmin\">' . $rpmphrase['error_no_permissions_super_what'] . '</a>');

Thanks Andrea, well spotted Will fix it in the next update

[macc]

hello!

nice mod

found one mistake in read_pms.php on line 171

you have:

PHP Code:

rpm_print_stop_back($rpmphrase['error_prefix1'] . $_REQUEST['userid'] . '</b> ' . $rpmphrase['error_postfix2']); 


should be:

PHP Code:

rpm_print_stop_back($rpmphrase['error_prefix1'] . ': <b>' . $_REQUEST['userid'] . '</b> ' . $rpmphrase['error_postfix2']); 


reg
macc

[Mosh]

Originally Posted by macc

hello!

nice mod

found one mistake in read_pms.php on line 171

you have:

PHP Code:

rpm_print_stop_back($rpmphrase['error_prefix1'] . $_REQUEST['userid'] . '</b> ' . $rpmphrase['error_postfix2']); 


should be:

PHP Code:

rpm_print_stop_back($rpmphrase['error_prefix1'] . ': <b>' . $_REQUEST['userid'] . '</b> ' . $rpmphrase['error_postfix2']); 


reg
macc

Thanks macc Will fix it in the next version

I think I had better do a code review now. I will post an update in the next hour or so.

[Mosh]

Update: v3.8.010 - Saturday 25th July 2009
-- Fixed: Typo on line 63 of 'readpms.php' - thanks to Andrea (Silvio)
-- Fixed: Typo on line 171 of 'readpms.php' - thanks to macc
-- Fixed: Typo on line 476 of 'readpms.php'
-- Fixed: Typo on line 483 of 'readpms.php'

This is just a typo fix update. There is no new functionality, no bug fixes, just fixed four typos. So, only update if you feel the need to.

And yet, again I am requesting this. As a lot of people benefit from this hack, if you have time, I would urge you to help me out and give back to the community at the same time, by providing a translation in your native language (as long as there is not an official translation already out there). So, if you read and write a different language other than English, and have a couple of hours to provide a translation in your language, please see the Translations section in the first post for more information.

[Asdrubael]

Hi Mosh,

I recently installed your mod, but:

1st: I dont have a link in the ACP
2nd: When I try to open the read_pms.php manually, it redirects me to the forum index

=(