Major Additions - vBMS : vBulletin Mail System

vBulletin Mail System

Finally, for vBulletin 3.6, there is a port from filburt1's original hack. For those of you who aren't aware, he essentially declared it open source, and it's been a bit of a wait for someone to fix it up... I've wanted it for my site, too, so I finally sat down and just did it.

What is this?
The vBulletin Mail System is a way to give your users webmail access from your site. They can have a name@yourwebsite.com address, send and receive emails and attachments, etc. Options such as mailbox quotas, limits on numbers/types of attachments, a message trailer ("Free mail at yourwebsite.com!") at the end of each message, etc. are all available as well.

Please note: this is a pre-final version. As far as I have seen, it is working so far for me, but I have not tested it completely and thoroughly and it's very likely there'll be a number of bugs popping up. However, I have successfully been able to install this on a clean board, exchange emails regularly (including attachments), go through all the basic options/etc. without any errors popping up, so it should be fine. Still, make sure you back up your database before installing this, just due to the nature of its "beta"-ness.

To install: upload all files from the "upload" directory to your server in the proper directories. Then, navigate to admincp/vbms_install.php on your server and run the installer. It will make several template additions. If your navbar or header templates hav been modified, it will not be able to do it automatically, and you'll have to add these edits yourself.

In template navbar, find:

<td class="vbmenu_control"><a href="usercp.php$session[sessionurl_q]">$vbphrase[user_cp]</a></td>

Add after:

			<if condition="$show['popups']">
				<td class="vbmenu_control" id="navbar_vbms">
					<a href="vbms.php$session[sessionurl_q]">$vbphrase[email]</a>
			
					<if condition="$vbms_newmessages['newcount'] > 0">
						<span style="font-weight: normal; padding: 1px 1px 1px 2px; margin: 0px 3px 0px 2px; border: 1px inset" class="alt1">
							<phrase 1="$vbms_newmessages[newcount]">$vbphrase[x_new]</phrase>
						</span>
					</if>
				
					<script type="text/javascript">
						<!--
							vbmenu_register("navbar_vbms");
						// -->
					</script>
				</td>
			<else />
				<td class="vbmenu_control" id="navbar_vbms">
					<a href="vbms.php$session[sessionurl_q]">$vbphrase[email]</a>
				
					<if condition="$vbms_newmessages['newcount'] > 0">
						<span style="font-weight: normal; padding: 1px 1px 1px 2px; margin: 0px 3px 0px 2px; border: 1px inset" class="alt1">
							<phrase 1="$vbms_newmessages[newcount]">$vbphrase[x_new]</phrase>
						</span>
					</if>
				</td>
			</if>

Find:

<!-- / header quick search form -->
	</if>

	<if condition="$show['member']">

Add after:

		<div class="vbmenu_popup" id="navbar_vbms_menu" style="display: none">
			<table cellpadding="4" cellspacing="1" border="0">
				<tr><td class="thead">vBulletin Mail System</td></tr>
				<tr><td class="vbmenu_option"><a href="vbms.php?$session[sessionurl]">$vbphrase[navbar_inbox]</a></td></tr>
				<tr><td class="vbmenu_option"><a href="vbms_new.php?$session[sessionurl]">$vbphrase[navbar_write_message]</a></td></tr>
				<tr><td class="vbmenu_option"><a href="vbms_ab.php?$session[sessionurl]">$vbphrase[navbar_address_book]</a></td></tr>
				<tr><td class="vbmenu_option"><a href="vbms_folders.php?$session[sessionurl]">$vbphrase[navbar_folders]</a></td></tr>
				<tr><td class="vbmenu_option"><a href="vbms_filters.php?$session[sessionurl]">$vbphrase[navbar_filters]</a></td></tr>
				<tr><td class="vbmenu_option"><a href="vbms_options.php?$session[sessionurl]">$vbphrase[navbar_options]</a></td></tr>
				<tr><td class="vbmenu_option"><a href="faq.php?$session[sessionurl]faq=faq_vbms">$vbphrase[navbar_help]</a></td></tr>
			</table>
		</div>

In your ACP, there should be a new set of options in a "vBulletin Mail System" category. That set of options is your main set of management stuff, and is pretty straightforward.

Feel free to post with any bugs or questions you find, etc. I'm trying to get this working again thoroughly, for all of us.

FAQ

• Is POP support available for my users?
  No, this is similar to a webmail system.
• What is a catch-all email address, and how do I set it up?
  A catch-all address is an email address that any mail sent to your server that isn't picked up by another account will go to. For example, if someone sends an email to randomgibberish@yoursite.com and you do not have a "randomgibberish" account defined, it would forward to your catch-all account that you have set up, such as all@yoursite.com.
• Can I run this if my server doesn't let me have a catch-all mail account?
  Yes, but it's not recommended. As has been suggested by a few members, you can set up one mail account to the be "catch-all" and have vBMS connect to that, then set up mail accounts for each member who wants one and have it forward to the catch-all. All this has to be set up manually with your web host, and takes a great deal of willpower and availability from the website administrator, and is thus not recommended.
• I'm receiving the following error:
  

  Fatal error: Call to undefined function: imap_open()...

  If you're getting an error similar to this, you do not have IMAP functionality available in PHP. Find your php.ini file on your server (usually /usr/local/lib/php.ini on Linux, C:\Windows\php.ini on Windows), and find the extensions section. Uncomment the line ";extension=php_imap.dll" (that is, remove the semicolon at the beginning) and restart your web server. If you don't have access to your web server to do this, contact your web host about installing IMAP support for PHP. If they won't do it, then this hack is not for you.
• I can't connect to the mail server, with this error:
  

  Warning: imap_open() [function.imap-open]: Couldn't open stream {localhost:110/pop3}INBOX in /includes/vbms_class_installer.php on line 791

  First, make sure that your port number and server information are right. Some mail servers are on non-default ports (this is common), and some you may have to connect to a different host besides localhost (this is very rare). Also, try using the "Force no-TLS connection" option in the vBMS Options in the ACP.
• I can connect to the server just fine, but it won't get any email!
  Check the "Mail checking logs" in your ACP (under the vBulletin Mail System area). If there are no logs, then the cronjob probably isn't running. If there are logs, see if there are any errors in there. If it's checking the mail account fine and simply says there are no messages, check with a webmail to see if the catch-all account is even receiving mails. If the webmail shows that the account has mail stuck in it and vBMS isn't picking them up, but vBMS is saying it's checking the account alright and finding 0 messages, then you're likely connecting to the wrong account. By doing these steps, you should at least be able to figure out where the problem is occurring.

Install clicks, donations and HotM nominations are always welcome.

[Krofh]

Hey guys,
I'm really sorry about not being around much lately... there've been all sorts of issues, mostly dealing with school and my dad having an unexpected major surgery; my life has not had a lot of free time. I'm going out of town for the next couple weeks, and would really like to be able to start working on this again when I get back, but there's really no guarantees that it'll happen right away. If someone would like to take it on as their own hack, I'm fine with that, but if not, I'll definitely get back to improving it this summer either way.

Not to sound selfish, but part of the issue is money as well. I've been programming for a third of my short life, and making some decent money... I figured, with all of the people offering donations in the original thread for someone to fix this up, that working on this might have some monetary benefit. I have yet to receive a single cent from it. I don't mind doing free open-source work at all, or I wouldn't have done this in the first place, but do understand that, as a result of not getting anything out of improving the vBMS, this takes a lower priority to the paid hacks and web design work I do.

Thanks for your understanding... I really do enjoy working on this project, and will be glad to return to it as soon as I can, but it's just not the highest thing on my priority list right now and as such I can't offer a definite timeline for anything.

[Fungsten]

Sorry. I just didn't work. Good luck though!!

[Andyrew]

I have disabled this untill it's updated as i'm finding more and more problems.
Flood checking set to 1 won't let user send emails at all, i also had a new user that had not verified his email in vb but still gained access to vbms even though i had access set to No for users awaiting email comfirmation.
parts of vbms did seem ok before i upgraded vb but now it don't seem to work very well at all.

[Killsparer]

Originally Posted by Krofh

I figured, with all of the people offering donations in the original thread for someone to fix this up, that working on this might have some monetary benefit. I have yet to receive a single cent from it.

I am more than willing to donate for this addon, but for that there has to exist a version which is more or less bug-free. And i currently seem to be cursed, because once i donated or paid for a (beta-)script or hack, the devolopment of it suddenly stops.

But once something is up and running at my board, i always donate for it. Yes, really!

[Rickeo]

Warning: imap_open() [function.imap-open]: Couldn't open stream {localhost:110/pop3}INBOX in /includes/vbms_class_installer.php on line 791

Getting that same error I have tried changing the port several times nothing is working any help please would love to get this working

[Rants]

Any one having a problem when sending an e-mail that the receiver is getting all of the headers, like its not translating properly?

[dazed12]

my catchall email is recieving it
i try running the task and get this error :The image “http://www.theoilclan.com/admincp/cr...onid=23” cannot be displayed, because it contains errors.

i can send email out

[Rukas]

Everything worked fine but now Im getting these emails non stop:

Database error in vBulletin 3.6.5:

Invalid SQL:
SELECT userid, bytesused
FROM vbvbms_quota
WHERE bytesused = 0
AND userid IN ();

MySQL Error : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ')' at line 4
Error Number : 1064
Date : Sunday, June 24th 2007 @ 12:48:03 AM
Script : http://www.streethop.com/forums/vbms...hp?&rand=40378
Referrer : http://www.streethop.com/forums/
IP Address : 72.68.49.198
Username : Unregistered
Classname : vB_Database

[Lahoria]

very nice hack

[Kingzor]

Originally Posted by Rukas

Everything worked fine but now Im getting these emails non stop:

Database error in vBulletin 3.6.5:

Invalid SQL:
SELECT userid, bytesused
FROM vbvbms_quota
WHERE bytesused = 0
AND userid IN ();

MySQL Error : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ')' at line 4
Error Number : 1064
Date : Sunday, June 24th 2007 @ 12:48:03 AM
Script : http://www.streethop.com/forums/vbms...hp?&rand=40378
Referrer : http://www.streethop.com/forums/
IP Address : 72.68.49.198
Username : Unregistered
Classname : vB_Database

Try re-uploading vbms_checkmail.php sounds like something might have been corrupted on the transfer as line 4 should just be part of a comment block.