admin
07-01-2011, 10:57 AM
http://www.wolfshead-solutions.com/external_images/hack-by-wolfshead-solutions.png (http://www.wolfshead-solutions.com/)
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?
IMPORTANT: This hack is feature complete and there will be NO further updates, apart from fixing proven bugs and adding additional language files. The reason this hack exists is to showcase/demo the potential of our commercial PM Management Suite 4 product and most, if not all, feature requests will already be included in the commercial product.
This is the Lite version of my commercial product - PM Management Suite 4 (http://www.wolfshead-solutions.com/ws-products/product-4). For obvious reasons, we can not talk about pricing for the PM Management Suite here, as it would be in violation of vBulletin.org's Commercial/Paid Modifications rules. So that we do not accidentally violate the rules, can you please post any and all questions regarding my commercial product at Wolfshead Solutions (http://www.wolfshead-solutions.com/forums/5-Pre-sales-Questions) instead of here.
This Lite version is a major update (a virtual re-write, there is very little original code left) of Dream's Read PMs (http://www.vbulletin.org/forum/showthread.php?t=123166) hack v0.7. Permission for me to release this hack is shown here (http://www.vbulletin.org/forum/showthread.php?p=1368001#post1368001), and blessings are given by Dream here (http://www.vbulletin.org/forum/showthread.php?p=1797942#post1797942).
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 lite 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 lite 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
Additional Features exclusive to the "PM Management Suite" (Paid Version):
Fully phrased via vBulletin phrases.
Minimum search length for key word search works differently than the lite version.
List all users with PMs - grouped by username.
When reading a PM, an entry next to each user which indicates if they have read their copy of the PM, if their copy is unread, or if they have deleted their copy.
Edit a PM (affects all copies of that PM for all users that have it).
Paginated throughout.
Delete a pmid (a reference to a particular PM from a single user).
Delete multiple selected pmids (references to a particular PM from selected users).
Delete a pmtextid (a particular PM from all users).
Delete multiple selected pmtextids (selected PMs from all users).
Administrator access and use of these functions is controlled by Administrator permissions, with the AdminCP menu only being visible to Administrators that have been given permission.
This product has context sensitive help throughout each of the functions.
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:
Can you add a feature/functionality to this hack (edit PM, delete PM, pagination, sort users alphabetically [not just by number of PMs] etc,.)?Answer:
These features are included in my paid product PM Management Suite 4 (http://www.wolfshead-solutions.com/ws-products/product-4).
vBulletin Version Compatibility
This hack can be used with vBulletin versions 4.0.0 - 4.1.4.
The version of this hack can be used with v3.8.0, v3.7.0, v3.6.0 and later versions is available here (http://www.vbulletin.org/forum/showthread.php?t=209344).
Hack Support
IMPORTANT: This hack is feature complete and I will NOT be adding further features, apart from fixing proven bugs and adding additional language files.
I will provide support for this hack in this thread only, and only for people who have clicked on Marked as Installed. I do not provide support via Private Message, Instant Messenger or Email.
Support for this hack is in its unaltered form, and does not include supporting alterations to this hack, custom code, custom template edits and integration with other third-party hacks.
I will only add features to this hack if I find the request interesting and would find it useful to have on one of my sites.
As with all of the hacks I release for free, I code for fun and code hacks the way I like them, then release them so you can benefit. If I am not interested in adding a feature, do not take offence, it is that is a feature that does not interest me personally.
However, if you would like additional paid support for alterations to this hack, professional installation of this or any other hack, custom code, custom template edits, integration with other third-party hacks or adding features that not interest me (but you would like added for your site), then feel free to make a paid work request via the Paid Work Requests forum at Wolfshead Solutions (http://www.wolfshead-solutions.com/).
Branding
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.
If you wish to remove the visible copyright branding from this hack, then you can do so by purchasing a life-time multi-site Read PMs (PM Management Suite Lite) - Branding Free Subscription at Wolfshead Solutions (http://www.wolfshead-solutions.com/).
Removal of the copyright branding without purchase of a branding-free license will be considered as a breach of copyright, and I will take the matter further.
Install/Uninstall Instructions
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
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
NOTE: If you have the spare time and can provide a translation into your language, that would be great. The below would be how to do it and have it posted here:
Create a copy of read_pms_eng.php renaming it to read_pms_XXX.php (where XXX is the 3 letter ISO code for your language) and edit for a list of phrases that you will need to translate.
Once you have translated all 74 phrases, edit read_pms.php and edit the line define('LANGUAGE_FILE', 'read_pms_eng'); and change read_pms_eng to the name of your language file read_pms_XXX (where XXX is the 3 letter ISO code for your language) and save the file.
Upload both files to your /admincp folder and check the translation works.
Once you have a working language file, post it here, it will be edited to add your name as the official translator for that language. It will then be added to the hack, a new version (with the language file in the official zip and an extra entry will be added to read_pms_XXX.php to easily change to the language) will be released and the language and your name will be added to the translation list as a credit for your work.
Version History
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
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?
IMPORTANT: This hack is feature complete and there will be NO further updates, apart from fixing proven bugs and adding additional language files. The reason this hack exists is to showcase/demo the potential of our commercial PM Management Suite 4 product and most, if not all, feature requests will already be included in the commercial product.
This is the Lite version of my commercial product - PM Management Suite 4 (http://www.wolfshead-solutions.com/ws-products/product-4). For obvious reasons, we can not talk about pricing for the PM Management Suite here, as it would be in violation of vBulletin.org's Commercial/Paid Modifications rules. So that we do not accidentally violate the rules, can you please post any and all questions regarding my commercial product at Wolfshead Solutions (http://www.wolfshead-solutions.com/forums/5-Pre-sales-Questions) instead of here.
This Lite version is a major update (a virtual re-write, there is very little original code left) of Dream's Read PMs (http://www.vbulletin.org/forum/showthread.php?t=123166) hack v0.7. Permission for me to release this hack is shown here (http://www.vbulletin.org/forum/showthread.php?p=1368001#post1368001), and blessings are given by Dream here (http://www.vbulletin.org/forum/showthread.php?p=1797942#post1797942).
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 lite 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 lite 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
Additional Features exclusive to the "PM Management Suite" (Paid Version):
Fully phrased via vBulletin phrases.
Minimum search length for key word search works differently than the lite version.
List all users with PMs - grouped by username.
When reading a PM, an entry next to each user which indicates if they have read their copy of the PM, if their copy is unread, or if they have deleted their copy.
Edit a PM (affects all copies of that PM for all users that have it).
Paginated throughout.
Delete a pmid (a reference to a particular PM from a single user).
Delete multiple selected pmids (references to a particular PM from selected users).
Delete a pmtextid (a particular PM from all users).
Delete multiple selected pmtextids (selected PMs from all users).
Administrator access and use of these functions is controlled by Administrator permissions, with the AdminCP menu only being visible to Administrators that have been given permission.
This product has context sensitive help throughout each of the functions.
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:
Can you add a feature/functionality to this hack (edit PM, delete PM, pagination, sort users alphabetically [not just by number of PMs] etc,.)?Answer:
These features are included in my paid product PM Management Suite 4 (http://www.wolfshead-solutions.com/ws-products/product-4).
vBulletin Version Compatibility
This hack can be used with vBulletin versions 4.0.0 - 4.1.4.
The version of this hack can be used with v3.8.0, v3.7.0, v3.6.0 and later versions is available here (http://www.vbulletin.org/forum/showthread.php?t=209344).
Hack Support
IMPORTANT: This hack is feature complete and I will NOT be adding further features, apart from fixing proven bugs and adding additional language files.
I will provide support for this hack in this thread only, and only for people who have clicked on Marked as Installed. I do not provide support via Private Message, Instant Messenger or Email.
Support for this hack is in its unaltered form, and does not include supporting alterations to this hack, custom code, custom template edits and integration with other third-party hacks.
I will only add features to this hack if I find the request interesting and would find it useful to have on one of my sites.
As with all of the hacks I release for free, I code for fun and code hacks the way I like them, then release them so you can benefit. If I am not interested in adding a feature, do not take offence, it is that is a feature that does not interest me personally.
However, if you would like additional paid support for alterations to this hack, professional installation of this or any other hack, custom code, custom template edits, integration with other third-party hacks or adding features that not interest me (but you would like added for your site), then feel free to make a paid work request via the Paid Work Requests forum at Wolfshead Solutions (http://www.wolfshead-solutions.com/).
Branding
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.
If you wish to remove the visible copyright branding from this hack, then you can do so by purchasing a life-time multi-site Read PMs (PM Management Suite Lite) - Branding Free Subscription at Wolfshead Solutions (http://www.wolfshead-solutions.com/).
Removal of the copyright branding without purchase of a branding-free license will be considered as a breach of copyright, and I will take the matter further.
Install/Uninstall Instructions
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
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
NOTE: If you have the spare time and can provide a translation into your language, that would be great. The below would be how to do it and have it posted here:
Create a copy of read_pms_eng.php renaming it to read_pms_XXX.php (where XXX is the 3 letter ISO code for your language) and edit for a list of phrases that you will need to translate.
Once you have translated all 74 phrases, edit read_pms.php and edit the line define('LANGUAGE_FILE', 'read_pms_eng'); and change read_pms_eng to the name of your language file read_pms_XXX (where XXX is the 3 letter ISO code for your language) and save the file.
Upload both files to your /admincp folder and check the translation works.
Once you have a working language file, post it here, it will be edited to add your name as the official translator for that language. It will then be added to the hack, a new version (with the language file in the official zip and an extra entry will be added to read_pms_XXX.php to easily change to the language) will be released and the language and your name will be added to the translation list as a credit for your work.
Version History
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