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:

[apdcanari]

Originally Posted by Hellcat

That's really weird.... I'm not running own code there, it's all native vB....
I'll look at the permission stuff....

Thanks

Rebuild permissions...

Perhaps...

require_once(DIR . '/includes/class_bitfield_builder.php');
vB_Bitfield_Builder::save($db);
build_forum_permissions();

[yinyang]

Looks awesome. Could be greater than vbMail? I'll test and let you know. Great job Hellcat and thank you very much for sharing!

[Barakat]

woking great ............................ thanks

[Basboss]

Been waiting for something like this...

Thanks for sharing.

[Hellcat]

Originally Posted by apdcanari

Thanks

Rebuild permissions...

Perhaps...

require_once(DIR . '/includes/class_bitfield_builder.php');
vB_Bitfield_Builder::save($db);
build_forum_permissions();

I added this testwise to the install code.
Can you uninstall the current one (if not already done) and try a reinstall with the attached product .XML?
Check if it's working then....

Originally Posted by yinyang

Looks awesome. Could be greater than vbMail? I'll test and let you know. Great job Hellcat and thank you very much for sharing!

Well, as charming as that sounds I doubt that.
I just did some research on "vBMail" (can you believe I didn't hear of it till now :knockedout: ) and it has something about 16.000 lines of code.

My one only comes up to ~1.000 lines - there HAS to be a big difference

But, who knows, if I got the time and peoples interest stays constant, this definately will evolve.... I'd like that

[rmxs]

Hmmm i can receive mails byt i cannot sent

I get this

Connection to SMTP:25....
Sent: helo localhost
Rcvd: 250 servername.com Hello servername.com [Server IP]
Sent: MAIL FROM:xxx.com
Rcvd: 501 xxxx.comr: sender address must contain a domain
Sent: RCPT TO:xxx@xxx
Rcvd: 503 sender not yet given
Sent: DATA
Rcvd: 503 valid RCPT command must precede DATA
Sent: QUIT
Rcvd: 221 SERVERNAME.com closing connection


Also if there is not messages in INBOX i get this

An error accoured while connecting to your POP3 server!

Byt there is no Problem!!(The problem is "ALL forget me" LOL )

[donatas]

When going to Get Mails
Recieving
Warning: strtotime() [function.strtotime]: Called with an empty time parameter. in /wmail/inc_misc.php on line 90

[nitro]

[high]* nitro marks "installed" for future reference.
[/high]

Sounds like a very interesting, cool and promising vb addon.

[IrPr]

Hellcat ROCKS~

[Parker Clack]

Hellcat:

Great mod. A couple of things I noticed is that when you get a listing of the emails that you have from the wmail.php?do=getmail page and you check the emails you want to delete and then click on the Delete Selected button the thread is not deleted. You can delete it from the page when you read the email.

When there are no emails on your server you get a "An error accoured while connecting to your POP3 server!" error message.

Then when you send an email it doesn't redirect you back to the page to allow you to send another email, etc. It stops on the sent email notification.

Again, this is a great hack and I look forward to its final release.