WMail - a POP3/SMTP Webmailer for vBulletin

What is this?
---------------
WMail is a "webmail client" - a front end, like a mail tool installed locally on your PC, for using POP3/SMTP mailboxes.

In short:
WMail adds POP3/SMTP access to vBulletin.

A live demo can currentliy be found on my testing board here:
http://vbdev.area-42.net/wmail.php


Key features:

• The obvious: Getting mailbox content, reading mails from every POP3 mailbox and sending mails through any SMTP server (configurable in the user options)
• written from scratch, spezificially to be used with vBulletin 3.5.x - not a port of something
• fully phrased and templated down to the last bit
• Full multipart support for downloading (and sending) attachments
• When reading mail the mail text is parsed for BB-Codes, so you get the graphical smillies from the forum, text formatting and URLs automatically become clickable links
• When replying to, or forwarding, mail the text of the original mail is quoted, propper quotemarks are added and a quote-header is added (customizable via template)
• various options for admin and users to customize the webmail client
• Does NOT require any special modules to be compiled into your PHP installation (like the IMAP libraries)
  (for techies: this uses basic socket connections instead of special PHP function calls)
• Admin can override certain aspects of the user config (forcing to use a given mailserver, force using forum email address and such)
• Write your mails using vB's WYSIWYG editor
• buildin (yet simple) addressbook for your E-Mail contacts
• Read/Unread markings - unread mails are highlighted, options for "mark selected read", "mark all read" and "mark selected unread"
• custom hooks to make it easy to develop addons for it
• automatically adds links to the webmailer in "Quick Links" menu, navbar and UserCP. Usualy no template edits needed when using default ones (can be disabled for each link in admin options)

Planned features:

• Support for multiple config sets per user
  (and so multiple mailbox accounts that can be querried)
• Sort mails into folders
• User configurable filters (for automatically sorting mails into folders)
• Preview of mailtext in inbox view (bellow subject)
• Forward mails as PM / Forward PMs as mail
• Reply to threads and PMs by mail
• Give/Provide your members an own eMail adress and inbox on your forums!
  • Members can recieve and send mails as "username@forumdomain.tld" without the need for an own POP3 account anywhere
  • Admin only needs ONE "real" POP3 box as "catch all".

Installation
--------------

Level : EASY
Duration : a minute or so
Files to upload : yes (11)
Products to import : yes (1)
Templates to edit : usually none


ChangeLog
===========
1.00 - first final release

• Fixed some minor bugs
• Login details are no longer stored as plain text in the database (*see note bellow!)
• Added option to save login details in a cookie on the users local computer instead of storing them in the forum's database

* Note on storing the login details in the database:
The login details are only base64 encoded when stored in the database.
A more secure encryption would make no sense anyway, the login details must be decrypted to be passed to the POP3/SMTP server - one well placed line of additional code in the POP3 or SMTP class could save the decrypted info anywhere the admin likes.
This "encoding" is only meant to prevent login details to be read (in plaintext) when doing maintanance to the database and stepping over it.
For fully securing the login details the "Save in cookie" option has been added.

Known Issues:

• On some installations mass deletion of mails (via "Delete Selected" from the inbox view) does not delete all mails
• Sometimes you get "-4 mails in inbox" - reloading the page then shows the correct inbox again

Besides of those two issues, that do not really break the function of the webmailer, it seemed to run pretty stable so far - that's why I decided to release 1.00 without having them resolved.


(more changelog entries in the readme)

____________________
This vBulletin extension is FREE! Be welcome to download and use it.
However, if you feel like supporting further development any donation is appreciated :bunny:

[magnus]

I have this installed and working on a fresh 3.6.2 installation. I, like others, ran into the 'adminhash mismatch' error -- so rather than commenting out code I decided to fix it. Took 5 seconds.

in admincp/wmail_admin_global.php:

FIND:

PHP Code:

print_form_header( "wmail_admin_global", "save", false, false, "wmailglobalsettings", "90%", "", false, "POST" ); 


REPLACE WITH:

PHP Code:

print_form_header( "wmail_admin_global", "save", false, false, "wmailglobalsettings", "90%", "", false, "post" ); 


For those keeping score at home, the only change made was changing the case of POST to post. You now have a working adminhash.

Enjoy.

* Edit:

Another purely aesthetic (template) fix:

In webmail_homepage:

FIND:

<select name="book" size="10" id="book" onChange="SetValue('to', GetSelectedEmail());">

REPLACE WITH:

<select name="book" size="10" id="book" style="width: 187px" onChange="SetValue('to', GetSelectedEmail());">

FIND and REMOVE:

<option value="" title="">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</option>

Remember, CSS is your friend.

[run.exe]

I applied your fixes; however, i still get a screenfull of garbage text when I click on the Webmail link in the navbar (per my previous post).

I'd love to get this working someday; sadly, it doesn't look like Hellcat will return to this thread anytime soon...

[magnus]

Originally Posted by run.exe

I applied your fixes; however, i still get a screenfull of garbage text when I click on the Webmail link in the navbar (per my previous post).

I'd love to get this working someday; sadly, it doesn't look like Hellcat will return to this thread anytime soon...

The modifications I posted only fix a specific problem. I scrolled back and checked your previous posts, and from what I can tell, it appears the file isn't being correctly parsed as PHP. I assume you've tried to re-upload a fresh copy of the file(s)? You're not editing the files at all, correct? Have you had this problem with any other plugins which require an external PHP file to be uploaded?

[run.exe]

Originally Posted by magnus

The modifications I posted only fix a specific problem. I scrolled back and checked your previous posts, and from what I can tell, it appears the file isn't being correctly parsed as PHP. I assume you've tried to re-upload a fresh copy of the file(s)? You're not editing the files at all, correct? Have you had this problem with any other plugins which require an external PHP file to be uploaded?

Magnus,

1) I have re-uploaded the provided (100% unedited) files numerous times (each one in vain).
2) I have zero (external or internal) PHP parsing issues, whatsoever, with any other plugins and/or files.

Thank you,

[run.exe]

Is this hack MySQL 5.x complaint/capable?

[y2ksw]

Installed on 3.6.0 and works fine. Test System: WinXP Pro. I'll install that now on a Win2003 production server and see how it works out

Really nice mod! :up:

[COBRAws]

I hope HELLCAT don't mind me editing the zip file with the fixes shown at post #381

The fixes are for vBulletin 3.6.2 ONLY. (I take absolutely NO CREDIT by this, it's just for lazy people or those who don't know much about coding and make their lives easier.

my 2cents.

[Axor]

How can I print the Complete Mailbox Size (Inbox&Outbox) to inform the User when he got over mailbox quota?

please help!

[gonkowonko]

works in the 3.6.2

but got a question

How can admin setup the users mail account? ie set up the default pop login information and setup a default SMTP login and then lock everything but the pop3 password? as dont want members choosing their own accounts only their email accounts selected by admin

IS this possible?

[Lionel]

Originally Posted by BETIServices

You could send emails but is not getting emails from your POP box.

I get mails from pop3 no problems on 3.60