vBulletin LTS

Roaming Threads - Mobile Image Uploads Directly To Forum
Mod Version: 1.0.3, by crowdgather

This plug-in will give you a quick and effective way to allow your mobile forum members to upload images to threads and posts in real-time. Your members will reply to secure emails sent to them from our platform and if they attach images to their replies- voila- mobile image uploads! RoamingThreads Basic is a free service that allows each of your forums to use our platform to process up to 99 emails per month and only 1 image attachment per email. For most forums this will be more than enough to handle your member’s needs since our plug-in gives you full control of which usergroups can make RoamingThreads and RoamingPosts. This is a great benefit to your VIP members if you have a subscription program, and it also makes for a great resource for your news team if you have one. Users with the need for more messages per month can easily upgrade to get more credits by following the instructions on our site once they have installed the plug-in and activated the service for their forum. All images are stored locally on your servers, but we handle the image parsing and mail server responsibilities for you! Go to the http://www.roamingthreads.com/forums/ if you want to try the service out as a user before you install.

http://www.roamingthreads.com

Requirements:

• vBulletin 4.0.1 or higher
• Root Access to forums area on your server
• FTP Client to access a remote server
• Account with the Roaming Threads site

Features:

• Supported
• Free Standard Version
• Premium Version Upgrade available soon (including Video and Multimedia)
• Single and Multiple Images upload
• Image Captioning
• MMS Enabled
• Forum Owner Admin/Control

Installation:

1. Extract the contents of vb_roamingthreads.zip to your computer.
2. FTP the content of the upload directory to the vBulletin installation directory on your server. For example if your vBulletin installation is referenced as http://www.EXAMPLE.com/forums FTP the contents of the upload directory to your server's "forums" directory.
3. Upload the product-roaming_threads.xml product file, located in the do_not_upload directory, via the Add/Import Product interface found by navigating to vBulletin Admin CP=>Plugins and Products=>Manage Products.
4. Refresh the Admin CP page; the Roaming Threads menu will now be visible.
5. Rebuild bitfields
6. Configure Roaming Threads and all options if applicable.
7. Enter your domain name on the Add Domain page located within your account on the http://www.roamingthreads.com/account. Note: When you add your domain you have the option of all of your Roaming Thread images displayed on the Roaming Threads home page. By default this is set to sharing.

Use and configuration:
You’ve captured a bunch of photos using the camera of your mobile phone – now how do you upload these pictures directly to a forum thread without having to transfer them to a desktop computer?

With RoamingThreads you can either add images to an existing thread or start your own thread.

To create a new thread:

1. Navigate to your forum’s thread listing page and click on the roaming thread icon.
   
2. You will be prompted to enter an email address that is accessible by your mobile device. Write up the title and intro text and submit. Your thread will not be visible to other users until you send your images.
   
3. After the thread is submitted you will receive a unique email address designated to your thread and user account.
   
4. Reply to the email with your images as attachments.
   
5. RoamingThreads will create a new thread with your images. Images will continue to be added to your first post until the max number of images per post is reached. After the max number of posts has been reached, new posts will be created using your account.
   
   
   

Breaking out of the first post:
If you would like for uploaded images to create new posts instead of being added to the first post before you reach the max number of images, change the subject line of your email to 'new post'. This will cause all additional uploaded images to be created as new posts in the thread.

Adding Images to an Existing Thread

1. Click on the ‘Roaming Post’ icon found next to the ‘Post Reply’ icon on a thread.
   
2. This will take you to a page with a pre-filled thread ID. Fill in an email address that is accessible by your mobile device.
   
3. An email from RoamingThreads will arrive on your mobile phone with an email address designated to the thread that you have selected.
   
4. Reply to the email with your images as attachments.
   

It’s as simple as that. RoamingThreads will add your images to the thread.

Image Captions:
Each image can now have its own caption. In the body of your email, you will need to use the following format to caption your images.

example, assuming we have attached 3 images


Troubleshooting and Support
We are more than happy to lend a hand getting your Roaming Threads install working properly on your forum. Jump over to the troubleshooting section of our forum, and we will do our best to offer any help that you may need: http://www.roamingthreads.com/forums/forumdisplay.php?f=3

Changes
v1.0.1: Fixed minor issue with non-urlencoded characters in image captions.
v1.0.2: Fixed minor issue with quote characters when inserting new posts.
v1.0.3: NEW FEATURE: Added the ability to use the Roaming Threads functionality from quickreply on showthread.php.

To see RoamingThreads in action, visit these forums:
http://www.roamingthreads.com/forums/
http://www.motoringalliance.com/forums/
http://www.waltdisneyboards.com/forums.php