The Arcive of Official vBulletin Modifications Site.

About Developer · **Released**: 06-16-2004

vBulletin POP3 / IMAP Email Client
Version 1.4 for vBulletin 3.x.x by Dr Erwin Loh

World's easiest hack to install! Upload a file, and you're done! No templates to add, no files to edit!!!

Ever wanted to access your POP3 or IMAP email account when you are away from your Outlook Express? Sick of Hotmail and free web-based email addresses, and want to just stick with your ISP email account? Want to be able to use a web-based interface? Want to be able to integrate this interface into your forums and offer it to your members?

Here we have it - I've created a file that does all that.

Features:

1. Only 1 file to upload, no templates, no file edits!
2. Automatic integration into your forums, with your forum colors and layout.
3. Accesses any POP3 or IMAP email account.
4. Ability to bypass any firewalls that any mail servers may have.
5. Ability to READ, REPLY, REPLY ALL, DELETE, FORWARD, and COMPOSE emails using the interface.
6. Ability to read HTML emails.
7. Ability to ATTACH files.
8. Ability to VIEW / DOWNLOAD ATTACHMENTS.
9. Ability to show HEADERS of emails.
10. Ability to allow certain usergroups access to this.
11. Ability to allow or disallow users from changing their FROM: email address
12. Ability to let yourself change the FROM: email address at at all times.
13. Your user can use this to access their ISP email account, or (Yahoo email or Hotmail premium accounts) via your forums!

Installation:

Upload email.php into your forums directory, link to it, and you've got an instant web-based POP3/ IMAP email interface in your forums!

Nothing else to do!

By default, this allows registered members, moderators and admins access only. You can edit the top of email.php to add or remove usergroupids easily.

Settings:

At the top of the PHP file, you can change the variables to:

1. Decide which usergroups can use this
2. Allow or disallow the changing of the FROM: email address (security update)
3. Exempt yourself so you can always change the FROM: email address

Requirements:

1) This hack requires PHP 4 or higher on your server.

2) This hack requires you to have IMAP support compiled with PHP on your server. If you get a error like "imap_open undefined function", then you dont have IMAP support. Sorry!

If you see this error message, you do NOT have IMAP compiled with PHP:

Quote:

Fatal error: Call to undefined function: imap_open() in /home/yourforums/public_html/forum/email.php on line 652

Please click the install link at the bottom of this thread for updates.

Enjoy!

Add-Ons (OPTIONAL) -

1) Username and Mail Server saved in Member Profile:

To make the Username and Password become part of a member's profile (I don't suggest to include password as well as staff can then have access to this), just create 2 custom profile fields in your Admin CP - one for Username, the other for Mail Host Server. Make sure they do not show up in the user's profile.

Then, note down the custom profile ID number of each of the 2 custom profile fields (hover your mouse over the link to each, and it's the number at the very end of the URL in the status bar).

Then, in email.php, find:

PHP Code:


			
if ($CMD=="")
    {
    if (!$session_server)
        {

Underneath, add:

PHP Code:


			
$user = $bbuserinfo[fieldx];
$host = $bbuserinfo[fieldy];

Change x to the ID number of the username profile ID, and y to the ID number of the host mail server profile ID. Done!

2) Force user to use a specific mail server:

In email.php, find:

PHP Code:


			
$HTML .= "<tr><td align=right>Server: </td><td><input TYPE=text NAME=host value='$host'></td></tr>\n";

Change to:

PHP Code:


			
$HTML .= "<input TYPE=hidden NAME=host value='mail.yourserver.com'>";

Change 'mail.yourserver.com' to your own mail server subdomain name.

3) To force users to use only POP3 or IMAP

In email.php, find:

PHP Code:


			
$HTML .= "<tr><td align=right>Type: </td><td> POP3<INPUT TYPE=radio size=1 NAME=opt group=opt value='POP3' checked>";
$HTML .= "IMAP <INPUT TYPE=radio size=1 NAME=opt group=opt value='IMAP'></td></tr>";
// $HTML .= "<input type='hidden' name='opt' value='POP3'>\n"; // set to IMAP als IMAP

Replace with:

PHP Code:


			
$HTML .= "<input type='hidden' name='opt' value='POP3'>";

Change POP3 to IMAP if you wish.

Updates:

Version 1.1 - removed the vB2 variable $bburl which was left over.
Version 1.2 - removed the vB2 variable $bbtitle, changed it to vB3, and also fixed up the table heading variable - purely cosmetic.
Version 1.3 - added automatic navbar support.
Version 1.4 - fixed email address server name domains, removed 1 query by caching template, fixed Attachment: alignment.

Screenshots:

1. Login screen
2. List of emails
3. Reading emails
4. Composing emails

Enjoy!

mbanje · #42 06-18-2004, 07:22 PM

nice

thanks

why-not · #43 06-18-2004, 10:38 PM

Hi

It works great for me, I am running it on 2 servers (1) windows/Apache/VB/Merak the other Unix/Apache/VB/UOW imap...

Also I did not have any trouble installing it!

Thanks Again.....

F!

dreamhost · #44 06-18-2004, 10:38 PM

For some reason the table is displaying as 70% when I view the source. It means that my table is cutting off the right side, so instead of "log out" and anything that may be beyond that, I get "log o" with the page cut off.
I checked my vb globals and all tables are set to 100%.
I also searched the code from email.php but do not see the 70% width variable anywhere.
Is there something that I may be missing that would cause this?

Erwin · #45 06-19-2004, 01:28 AM

Quote:

Originally Posted by ChurchMedia

I saw someone had this same error but didn't see a solution.

PHP Code:


			
Warning: imap_open(): Couldn't open stream {******.net:110/pop3}INBOX in /***path/***to/forum/email.php on line 652

Any ideas? Great hack concept!

Wrong user information or the mail server is not authenticating you.

Erwin · #46 06-19-2004, 01:30 AM

Quote:

Originally Posted by RetroDreams

Erwin,

Lovely piece of work. What would be involved to make templates for this and build around this? This is some solid work and I'd love to integrate it further.

That's planned, but would take a long time. I wanted to upgrade the vB2 version of this to vB3 so that people can upgrade to vB3 with this.

Erwin · #47 06-19-2004, 01:30 AM

Quote:

Originally Posted by dreamhost

For some reason the table is displaying as 70% when I view the source. It means that my table is cutting off the right side, so instead of "log out" and anything that may be beyond that, I get "log o" with the page cut off.
I checked my vb globals and all tables are set to 100%.
I also searched the code from email.php but do not see the 70% width variable anywhere.
Is there something that I may be missing that would cause this?

That's very odd, since I'm merely using the generic standard error vB3 template. I suggest playing around with the HTML code in email.php and see if that helps.

custsrvcrep · #48 06-19-2004, 04:19 AM

Sorry for what is probably a stupid question: But is there a way to easily verify that your server meets the requirements (IMAP support compiled AND suexec compiled) BEFORE you attempt to install this hack? Is there a command-prompt command that could be issued to find out the above? Thank you

This hack requires you to have IMAP support compiled with PHP on your server. If you get a error like "imap_open undefined function", then you dont have IMAP support. Sorry!

If you see this error message, you do NOT have IMAP compiled with PHP:

Quote:

:
Fatal error: Call to undefined function: imap_open() in /home/yourforums/public_html/forum/email.php on line 652

Quote:

:
Originally Posted by 350Chevy
One other thing.. when anyone sends an e-mail no matter what account or server they're logged into it's always sent from: Nobody [nobody@lssix.propagation.net]

That's probably because you do not have suexec compiled for php, so "nobody" is the owner of the php file.

SnowBot · #49 06-19-2004, 04:20 AM

Erwin it all works great here, no problems at all.

Thanks for sharing this great addition

[high]* SnowBot clicks instal

[/high]

Erwin · #50 06-19-2004, 04:43 AM

Quote:

Originally Posted by custsrvcrep

Sorry for what is probably a stupid question: But is there a way to easily verify that your server meets the requirements (IMAP support compiled AND suexec compiled) BEFORE you attempt to install this hack? Is there a command-prompt command that could be issued to find out the above? Thank you

Considering this hack is a 1 file upload with no PHP or template editing, the easiest way to find out is to download and upload the file, and run it.

You can look at your phpinfo if you know how to do it, but the fact that you are asking how to do it, means that it's easier to just upload and see if it runs.

Erwin · #51 06-19-2004, 04:52 AM

Update Version 1.2
-------------------------

Updated vB2 variable $bbtitle to vB3, and fixed up the table heading so it states the correct name of the application.

This is purely a cosmetic upgrade - all you need to do is download and upload the new email.php - nothing to do really. It does look better, and your forum name shows up correctly, so I would say to do it.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.05156 seconds Memory Usage 2,337KB Queries Executed 25 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (7)bbcode_php (7)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (6)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (1)pagenav_pagelinkrel (11)post_thanks_box (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (11)post_thanks_postbit_info (10)postbit (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!