Thank you for downloading this modification!

Popup Private Messaging allows you to send a private message from a post, thread, your members list or forum leaders list without leaving the page. A DHTML popup window will allow you to compose a message using either a simple form or an advanced editor and options. More information is available on vBulletin.org.

The popup is DHTML so it won't be blocked by popup blockers. It's small, styled to your forum, can be moved on the page, and will appear almost anywhere there's a link to PM someone.

Version History:

1.3
- Improved template edits to be less intrusive, more efficient and more compatible with different vB versions.
- Improved Javascript code to be more efficient.
- Added border to popup window to appear more like an actual popup.
- Added AJAX username suggestion for PM recipients.
- Renamed to "Popup Private Messaging", as this wasn't looking as Facebook-y as I'd planned. :p

1.2
- Fixed Who's Online location bug.
- Fixed server load/efficiency issues.

1.1
- Major overhaul!
- Popups no longer interfere with inline moderation scripts or single PM deletion.
- PM form now supports multiple recipients, WYSIWYG editor, post icons, and miscellaneous options.
- All of the above is customizable within the Admin CP, along with popup window size.
- All actions (send, preview, errors, etc.) are contained within the popup window.
- Usergroup permissions can now be set in the Admin CP.
- Popup window can be reused after a PM is sent to send another PM.
- Branding free option available... more information below.

1.0
- Initial release!

Before proceeding with installation, it is recommended that you back up your forum database.
Then extract the modification "Zip" file and save it to a folder on your computer.

A license not only allows you to remove the copyright text from the bottom of the popup windows, it also gives me a few duckets for my work. Everybody wins! A branding free license is currently $5 for one forum installation, with removal valid forever.Visit http://www.robwoelich.com/business/testforum/ for more information.

If you like my work, please tell others about it! Be sure to click Install on vBulletin.org as I will be working to improve this constantly and this will nofity you of new releases. Also, consider making a donation or purchasing a branding free license if this is something you're going to get a lot of use out of. :) Donation links can be found on the product page on vBulletin.org.

Installation methods will vary depending on your forum configuration and the forum theme (style) you are using.

UPGRADES FROM 1.0:
First, uninstall the old Popup PM product. This should remove your template edits and any other changes that were made. Verify all template edits were removed, as a bug in the uninstall code may leave some template edits if you don't have default templates. If you want, you can delete the close X image from your /images/ folder, but it's not critical. Then, you can proceed with the installation instructions below.

UPGRADES FROM 1.1 and 1.2:
First, uninstall the old FBPM product. This should remove your template edits and any other changes that were made. Then, follow the installation instructions below. Note that you will have to reconfigure your options for Popup PM in the Admin CP.

INSTALLING 1.3:

Step one: Upload all of the files in the UPLOAD folder to your forum directory. Do this before you import the product, or else you may break stuff. If you are upgrading, overwrite the .js and .css files because they've changed since last version.

Step two: Import the product-robwoelich.com-fbpm.xml file using your Product Manager in your Admin CP.

Step three: Configure it! Go to your Admin CP > vBulletin Options > Popup Private Messaging where you can set your popup window size, options, and usergroup permissions. It is recommended to leave the popup window size as it is until you test the popups with your other options to see how they look first.

Step four: Test it! Go to a member profile, post, member list, or anywhere else you have a PM link and see if the popup works. If so, you're all set!

If your templates were not edited automatically:
Your templates may not be edited automatically (the popups only work in certain areas, or don't work at all) if your style is significantly different from the normal forum design, or if you are using other modifications that have changed the parts that are being edited.

If this is the case, see the text file templateedits-robwoelich.com-fbpm.txt for instructions on editing your templates. Also see the troubleshooting steps below.

If you run into any other odd issues:
Uninstall the product and remove any manual template edits you made. Verify you uploaded all files where they go. Then, reinstall the product.

It should be pretty self explanatory. :p You click on a PM link, and the PM popup window appears. You type your message and send it. Configuration options are in the Admin CP > vBulletin Options > Popup Private Messaging (located below Private Messaging Options).

To change the X in the corner of the window from a dark color to light color:

Rename the close_light.gif file to close.gif in the images/misc/ directory. You can also upload your own close X image, so long as it's named close.gif.

To uninstall, perform the installation steps in reverse order. Uninstall the product under Manage Products, and if you manually edited the templates, remove the changes you inserted or revert the templates. Optionally, delete any files you uploaded.

Q: It's not workkkkkking! My popups aren't showing up.

That sucks... sorry to hear about that. Is it happening on one page, or all pages (i.e. only in member profiles)? Are you getting a script error (error on page in the bottom left corner of your browser)? The most common cause for non-workingness is that one of the template edits was not applied automatically.

If popups aren't working on one single page, like showthread.php or member.php, check to make sure the template edit was correctly applied to the appropriate template. For example, showthread.php would be the templates postbit and postbit_legacy... member.php would be MEMBERINFO and memberinfo_block_contactinfo. Use the text file with the template edits included in this ZIP package to verify the template edits were made automatically. I know it sucks, but imagine how much it sucked to get all of that to install automatically... :)

If popups aren't working anywhere or you're getting an "error on page", first make sure you uploaded all of the files in the UPLOAD folder where they need to go. Then, check your headinclude and footer templates to make sure the template edits were applied correctly. If that doesn't fix your problem, chances are good that the script that makes the popup windows is interfering with another script on your forum. Do you have another mod installed that uses some sort of fancy Javascript? If so, you may be out of luck.

Q: How can I change the style of the window?

The short answer is that there's not an easy way to do it. The long answer is that you'd have to play with the Javascript file to change the outer appearance of the popup window. If you want to make changes to the actual form that is displayed within the popup, you can do so by editing the pm_fbpm template.

Q: How do I edit the text/phrases on the popup windows?

Same answer as above. I designed this for my own purposes right now, and I'll make it more user friendly and customizable when I have time. Meanwhile, you're just going to have to hack it like I do. ;)

Q: The X to close the window is ugly.

Yeah, well, what can you do. Oh, I know! Upload a new one over the file in images/misc/close.gif.