PM Management Suite Lite

[Mosh]

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?Silver
This 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 (almost, it does display the BBCode, but it is not formatted correctly and also does not parse smilies.... but this is fixed in the commercial product)
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.


vBulletin Version CompatibilitySilver
This hack can be used with vBulletin versions 4.0.0 - 4.2.1.

The version of this hack can be used with v3.8.0, v3.7.0, v3.6.0 and later versions is available here.


Hack SupportSilver
IMPORTANT: This hack is no longer supported.


BrandingSilver
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.


Install/Uninstall InstructionsSilver
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.


TranslationsSilver
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 HistorySilver
v4.0.4 - Wednesday 3rd March 2011
-- Fixed: removed depreciated "pass by reference" return value from a PHP5 OOP constructor

v4.0.3 - Saturday 15th January 2011
-- Altered: updated 3 phrases in the Turkish language file "read_pms_tur.php"

v4.0.2 - 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

v4.0.1 - 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

v4.0.0 - Thursday 6th January 2011
-- Intial vBulletin 4.0.0 Gold version (released to Wolfshead Solutions on Tuesday 29th December 2009)
-- Fixed: Partial fix that enables PMs with BBCode to be displayed in vBulletin v4.0.0 and above

ThanksSilver
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 Silver
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.

[ssslippy]

Can you still read a pm if the user has deleted it?

[Brandon Sheley]

where exactly is the copyright?
is it just visible in from the admincp PM pages?

thx

[Mosh]

Can you still read a pm if the user has deleted it?
If all users have deleted the PM (as all pointers to the PM and the PM itself will be gone)..... then no, but if one user has not deleted their copy of the PM, then yes.

[Mosh]

where exactly is the copyright?
is it just visible in from the admincp PM pages?

thx
Just the AdminCP pages.

[x9751]

Tagged.... Will install later I like the idea and have been waiting for this.

[motorola]

Installed. Thanks for this, is a great mod !

[DxSEO]

tagged

will check this latter

[Adem GEN?]

Thanks, installed

Turkish translation files

File Updated

[Mosh]

Update: v4.0.1
-- Added: Turkish language file "read_pms_tur.php" - thanks to Adem GEN?
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions on how to change language files

This is just a language update. There is no new functionality, no bug fixes, just added a new language. So, only update if you feel the need to.

As Adem GEN? is continuing to keep the ball rolling with language translations (thank you once again Adem GEN? ;)), I will make the request.

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 Brazilian, English, German, Italian, Spanish or Turkish, 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.

[Mosh]

Hi all,

Free support has now been moved back to vBulletin.org.

Please see the first post for more information (and also this thread (http://www.wolfshead-solutions.com/threads/444-Our-quot-vBulletin.org-Hacks-Support-quot-subscription-has-been-scrapped) at Wolfshead Solutions).

Enjoy :)

Regards,

Mosh Shigdar - Wolfshead Solutions.

[COL NIL SATIS]

tagged...looks another top mod this.

[Dadoo]

Installed :-)

Please find below French language :-)

[Mosh]

Update: v4.0.2
-- Added: French language file "read_pms_fre.php" - thanks to Dadoo
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions on how to change language files

This is just a language update. There is no new functionality, no bug fixes, just added a new language. So, only update if you feel the need to.

As Dadoo is continuing to keep the ball rolling with language translations (thank you once again Dadoo ;)), I will make the request.

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 Brazilian, English, French, German, Italian, Spanish or Turkish, 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.

[Adem GEN?]

Thanks, installed

Turkish translation files

File Updated
There was little bugs, I updated the file.

Update: v4.0.1
-- Added: Turkish language file "read_pms_tur.php" - thanks to Adem GEN?
-- Updated: "readpms.php" to accommodate the new language
-- Updated: Instructions on how to change language files

This is just a language update. There is no new functionality, no bug fixes, just added a new language. So, only update if you feel the need to.

As Adem GEN? is continuing to keep the ball rolling with language translations (thank you once again Adem GEN? ;)), I will make the request.

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 Brazilian, English, German, Italian, Spanish or Turkish, 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.
I can only speak Turkish.
I try to help the Turkish translations.

[Mosh]

There was little bugs, I updated the file.

Can you tell me what bugs? As I have only added your translation, and will need to look through the bug fixes before adding them to the official download. .... OK, I misunderstood that one, it was just the altered phrases :face palm:

I can only speak Turkish.
I try to help the Turkish translations.

I think you misunderstood, what I was asking everyone who uses this hack, and not yourself is that if they can do a translation in a different language other than Brazilian, English, French, German, Italian, Spanish or Turkish can they post it.

[dontpanic]

Installed and nominated. Many thanks!

[Mosh]

Update: v4.0.3
-- Altered: updated 3 phrases in the Turkish language file "read_pms_tur.php"

This is just a language update. There is no new functionality, no bug fixes, just updated an existing language. So, only update if you feel the need to.

As Adem GEN? is continuing to keep the ball rolling with language translations (thank you once again Adem GEN? ;)), I will make the following request to everybody.

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 Brazilian, English, German, Italian, Spanish or Turkish, 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.

[Adem GEN?]

Edited only Turkish translation

[gibigbig]

very sneaky mod. 'private messages' should be changed to 'public messages' :/

[obmob]

Thanks for sharing :)

[OldSchoolDSL]

I temporary installed this to see how this would work & used it to read my own PM (sent to myself). But I did notice a small little thing above:

Deprecated: Assigning the return value of new by reference is deprecated in /home/xxxxx/public_html/forums/admincp/read_pms.php on line 517

[Mosh]

I temporary installed this to see how this would work & used it to read my own PM (sent to myself). But I did notice a small little thing above:

Deprecated: Assigning the return value of new by reference is deprecated in /home/xxxxx/public_html/forums/admincp/read_pms.php on line 517

That is because when I wrote this, it was for the vBulletin 3.x.x series and it on a PHP 4 platform... now because vBulletin 4.x.x uses PHP 5.2.0 as a minimum requirement, I forgot to remove the "pass by reference" OOP operator, as in PHP 5 and above this is done automatically. So, I will release new version soon... thanks for pointing that out OldSchoolDSL ;)

[Mosh]

Update: v4.0.4
-- Fixed: removed depreciated "pass by reference" return value from a PHP5 OOP constructor

[OldSchoolDSL]

That is because when I wrote this, it was for the vBulletin 3.x.x series and it on a PHP 4 platform... now because vBulletin 4.x.x uses PHP 5.2.0 as a minimum requirement, I forgot to remove the "pass by reference" OOP operator, as in PHP 5 and above this is done automatically. So, I will release new version soon... thanks for pointing that out OldSchoolDSL ;)

You're welcome and thank you for fixing it so quick :)

Update: v4.0.4
-- Fixed: removed depreciated "pass by reference" return value from a PHP5 OOP constructor

Test and working

4.1.1 & 4.1.2

[ExciterNL]

4.0.4 installed. Works fine.

With the older versions and with this one i often get this:

Fatal error: Call to a member function show_chatbox() on a non-object in /home/skodaforum/domains/skodaforum.nl/public_html/board/includes/class_bootstrap.php(412) : eval()'d code on line 18

But trying one more time, and it works. Its about 3 times of 10 try's.

[Mosh]

4.0.4 installed. Works fine.

With the older versions and with this one i often get this:

Fatal error: Call to a member function show_chatbox() on a non-object in /home/skodaforum/domains/skodaforum.nl/public_html/board/includes/class_bootstrap.php(412) : eval()'d code on line 18

But trying one more time, and it works. Its about 3 times of 10 try's.

There is no show_chatbox() function in this hack, so the error message in all likelihood has nothing to do with this hack.

I am assuming that that you have a chat box hack installed, and that is probably the cause of the error message.... you may want to post in that thread for support for the error.

[ExciterNL]

Yeah, but the only place, where i do get this message is by clicking [view private message] in this mod. Strange.

Maybe is one of the two mod's conflicting the other? But i'm afraid, i'm not able to find out, it would be the chicken/egg discussion...

And my PHP coding skills are like nothing. If the mod's don't work, i'm not able to seek errors...

[Mosh]

Yeah, but the only place, where i do get this message is by clicking [view private message] in this mod. Strange.

Maybe is one of the two mod's conflicting the other? But i'm afraid, i'm not able to find out, it would be the chicken/egg discussion...

And my PHP coding skills are like nothing. If the mod's don't work, i'm not able to seek errors...
If you disable or un-install the MGC Chatbox Evo hack, you will not see that error message again.

There are other people who have have MGC Chatbox Evo installed and do not have this hack installed who also have the same problem (all you have to do is do a search for the error message on these forums..... which is what I did), so you will need to post in that thread for support, as it is an error generated with that hack installed.

[Sarah EI]

Hi. Any idea why I get this
""Invalid File Specified""
when I try to import product, EITHER upload the XML file from your computer-chose file .

Thks

[Mosh]

Hi. Any idea why I get this
""Invalid File Specified""
when I try to import product, EITHER upload the XML file from your computer-chose file .

Thks

Did you read the Install/Uninstall Instructions section in the first post?

[Sarah EI]

Did you read the Install/Uninstall Instructions section in the first post?
I think I know what I was doing wrong, now I get 404 error...so, in few months I will know what I did wrong this time.
Thks

[Mosh]

I think I know what I was doing wrong, now I get 404 error...so, in few months I will know what I did wrong this time.
Thks

It means either you did not do Step 2 or Step 3 of the installation instructions correctly or the files do not have the correct access permissions as the 404 error message means that the file(s) could not be found (see http://en.wikipedia.org/wiki/HTTP_404).

[hunter22375]

Has anyone tried this with v4.2.0 yet? I need a mod like this.

[Mosh]

Has anyone tried this with v4.2.0 yet? I need a mod like this.

Yes, it works fine with vBulletin 4.2.0 :)

[hunter22375]

I also get the invalid specified file error when attempting to import the XML file from my computer. Becasue I'm not using any languages than english, and we don't have to upload any files to our AdminCP folder, wouldn't importing the XML file be my only step? Appologies for the confusion.

UPDATE: OK, I missunderstood the directions so, I got the read_pms.php and read_pms_eng.php files uploaded to the AdminCP folder and the XML file uploaded to the XML folder but I cannot see the option under "Users" in the vB admincp that should say "Read PMs". Any ideas on what the issue is or what I need to change?

UPDATE....again: It works. Appologies for the confusion...its been one of those days. Thanks for the mod and I marked it as installed.

[Shadow]

Hello,

I'd like to use some code from the Lite version of this modification and incorporate some of it's features in to another modification. Would this be possible?

[Deafmute]

not working 4.2

[rhody401]

Works fine with 4.2 PL3

[dog-tag]

I'm also getting: "Invalid File Specified"

I have uploaded -
read_pms.php
read_pms_eng.php

For example ->>
They're sitting in /forum/admincp/read_pm_eng.php

I then either imported cpnav_rpm.xml or placed it in the correct folder.
Both ways resulted in the above error.

I made both .php files 777 on VB 4.2 PL3

Any ideas?

[RedTurtle]

Is there any way to make smileys work with this? Currently the path to the smilies on my forum is being messed up because the admincp directory is being included in the path and because of this smilies that are used in the PMs are not showing up and a broken image picture is shown instead.

The actual path to smilies:

mydomain.com/images/smilies/tongue.png

But this mod shows the PM and makes this the path to the smilies:

mydomain.com/admincp/images/smilies/tongue.png

Anyone know of a fix?

Running this on 4.2.1.

[z3r0]

The easy fix is just place a copy of your smilies folder at that location.

[tareqbd]

Fatal error: Cannot redeclare class vB_Bootstrap_Forum in /home/******/public_html/includes/class_bootstrap.php on line 1749

Any idea why I am getting this error after clicking "View private message".

[Zeus1221]

Thanks for the mod, works great!

Quick question though, Is there anyway I can restrict the access to a different usergroup than super administrators ?

[alexNL]

I'd say check around line 80 in read_pms.php, there is a check for supermoderators there (that did not actually work on my forum (4.2.1 PL1) as intended).

[darksidemon2]

Thanks for the mod, works great! 4.2.3

[JesWhite]

great addon..