View Unread PMs

[MPDev]

As an admin I get a ton of PMs; and I don't always get around to them when I should. Finding old PMs I haven't read can be a pain. So I coded up some quick changes to allow me to have a "Unread PMs" system folder that let me quickly view all my unread PMs.

Now, before you go looking for a plug-in, I'll tell you now you have to make code modifications to two files because vBulletin hard codes system folders. In adding a new system folder the only option I was able to come up with involved a few code changes.

From the dropdown folder selector is an "Unread PMs" option.

I also modified my USERCP_SHELL to include a link to the Unread PMs options.

<if condition="$show['showunread']">
<tr>
<td class="$navclass[pm_messagelist]" nowrap="nowrap"><a class="smallfont" href="private.php?$session[sessionurl]folderid=-2">Unread PMs</a></td>
</tr>
</if>Version 1.0 - April 7th, 2007
. Initial release

[MPDev]

Reserved for some screen shots....

[blogtorank]

First install and kicks butt!

[Jeordie015]

Is there a way to include a link to the unread PMs in the popup menu that is below the folder jump menu?

[MPDev]

You mean the dropdown folder list? That's covered in the changes; or do you mean a different dropdown?

[Muellmann]

You've made a good job, I like this modification because I had many unread messages everywhere in my box, now I can see them in one place, thanks ;)

[MPDev]

Thanks! Has been a huge timesaver for me as well; amazingly simple and should probably be an option by default.

[Ian Montgomerie]

I tried this and there's a fundamental problem with the coding - it sets up the "unread PMs" folder to be treated the same way as the "sent items" folder. It should be treated like the inbox folder, because the unread PMs are from the inbox. For example, this problem causes all messages in the unread PM list to display as if they were sent by you.

The fix is easy because the "inbox" way of doing things is the default. You just have to remove all of the modifications which look for a "-1" case in the code and change it to "-1 or -2". "-1" is the special case for the sent items folder.

I'm using a shorter, simpler mod file that looks like this. Working with 3.7 PL1.



//################################################## ##############################//
// MOD NAME: Unread PMs #//
//################################################## ##############################//
// DESCRIPTION: Let's users view only unread PMs #//
// Sorry, folks; this couldn't be done via a plug-in because #//
// it requires changing lines of code which explicitly use #//
// a folder id to identify "system" folders. #//
//################################################## ##############################//
// BY: MPDev #//
// DATE: 4.07.07 #//
// VERSION: 1.0 #//
//################################################## ##############################//
// FILES UPDATED: #//
// private.php #//
// includes/functions_misc.php #//
//################################################## ##############################//

Please make backups of these two files before editting them so you can back
it out if you want.

//################################################## ##############################//
// private.php #//
//################################################## ##############################//

Find:

$pmfolders = array('0' => $vbphrase['inbox'], '-1' => $vbphrase['sent_items']);

change to:

$pmfolders = array('0' => $vbphrase['inbox'], '-1' => $vbphrase['sent_items'], '-2' => 'Unread PMs');

//################################################## ##############################//

Find:

switch ($vbulletin->GPC['folderid'])
{
case -1:

change to:

switch ($vbulletin->GPC['folderid'])
{
// MDP
case -2:
$fromfolder = 'Unread PMs';
break;
// MDP
case -1:

//################################################## ##############################//


Find:

($hook = vBulletinHook::fetch_hook('private_messagelist_sta rt')) ? eval($hook) : false;

Add after:

$foldernames["-2"] = "Unread PMs";
$show['showunread'] = iif($vbulletin->userinfo['pmunread'], true, false);

//################################################## ##############################//

Find:

$pms = $db->query_read_slave("
SELECT pm.*, pmtext.*
" . iif($vbulletin->options['privallowicons'], ", icon.title AS icontitle, icon.iconpath") . "
FROM " . TABLE_PREFIX . "pm AS pm
LEFT JOIN " . TABLE_PREFIX . "pmtext AS pmtext ON(pmtext.pmtextid = pm.pmtextid)
" . iif($vbulletin->options['privallowicons'], "LEFT JOIN " . TABLE_PREFIX . "icon AS icon ON(icon.iconid = pmtext.iconid)") . "
WHERE pm.userid=" . $vbulletin->userinfo['userid'] . " AND pm.folderid=" . $vbulletin->GPC['folderid'] . "
ORDER BY pmtext.dateline DESC
LIMIT $startat, " . $vbulletin->GPC['perpage'] . "
");


Replace with:

if ( $vbulletin->GPC['folderid'] == -2 )
{
$pms = $db->query_read_slave("
SELECT pm.*, pmtext.*
" . iif($vbulletin->options['privallowicons'], ", icon.title AS icontitle, icon.iconpath") . "
FROM " . TABLE_PREFIX . "pm AS pm
LEFT JOIN " . TABLE_PREFIX . "pmtext AS pmtext ON(pmtext.pmtextid = pm.pmtextid)
" . iif($vbulletin->options['privallowicons'], "LEFT JOIN " . TABLE_PREFIX . "icon AS icon ON(icon.iconid = pmtext.iconid)") . "
WHERE pm.userid=" . $vbulletin->userinfo['userid'] . " AND pm.folderid=0 AND pm.messageread=0
ORDER BY pmtext.dateline DESC
LIMIT $startat, " . $vbulletin->GPC['perpage'] . "
");
}
else
{
$pms = $db->query_read_slave("
SELECT pm.*, pmtext.*
" . iif($vbulletin->options['privallowicons'], ", icon.title AS icontitle, icon.iconpath") . "
FROM " . TABLE_PREFIX . "pm AS pm
LEFT JOIN " . TABLE_PREFIX . "pmtext AS pmtext ON(pmtext.pmtextid = pm.pmtextid)
" . iif($vbulletin->options['privallowicons'], "LEFT JOIN " . TABLE_PREFIX . "icon AS icon ON(icon.iconid = pmtext.iconid)") . "
WHERE pm.userid=" . $vbulletin->userinfo['userid'] . " AND pm.folderid=" . $vbulletin->GPC['folderid'] . "
ORDER BY pmtext.dateline DESC
LIMIT $startat, " . $vbulletin->GPC['perpage'] . "
");
}

//################################################## ##############################//
// includes/functions_misc.php #//
//################################################## ##############################//

Find:

$folders = array('0' => $vbphrase['inbox'], '-1' => $vbphrase['sent_items']);

replace with:

$messagecounters["-2"] = $vbulletin->userinfo['pmunread'];
$folders = array('0' => $vbphrase['inbox'], '-1' => $vbphrase['sent_items'], '-2' => 'Unread');

[yoyoyoyo]

I'm using a shorter, simpler mod file that looks like this. Working with 3.7 PL1.
Thanks much- working great in 3.8.6!

[MPDev]

Be sure to click install! :)

[guydogg]

I've installed the mod and it does have an issue as Ian Montgomerie has stated. All of the unread PMs show as if you sent them to yourself. Can somebody paste an update on what needs to be changed.

I've tried installing Ian Montgomeries revised mod, but it doesn't work correctly with 3.6.4, as it doesn't display the PM's for some reason.

thanks in advance,

[ozmazdaclub]

Installed. Im not too fussed about who it says sent it because it has made life much easier than searching through pages and pages of pm's for the unread ones.

[TCE Killa]

Will this work for registered users as well? Thanks.

[ozmazdaclub]

Yes it appears to work for other usergroups or at least it does on my forums.