Mod Name / Version - RaiderSoft Chat Integration 1.5	Description - This integrates RaiderSoft's java based chatroomwith your UBB.Threads, and updates the who's online information.This also can automatically log the user in, and if you have a Premier Raidersoftaccount, you can use AAS (Alternative Authentication System) for maximum security.This uses a page with iFrames - in which the header refreshes every 9 minutes (before the user would normally drop off of the UBB.Threads Who's online screen). This will also add a "Chat" link into your UBB.Threads Menu Bar.Features:  - Integrates with the Look/Stylesheet of your UBB.Threads		   - Can automatically log the user into chat, using their Threads username		   - Option to limit chat to logged in/registered users only		   - Option to temporarily close the chat room		   - Updates the Threads Who's Online page with "In the Chat Room" 		   - Can authenticate chat username/password against your UBB.Threads		     Database (Platinum Service Only)		   - Allows you to right click a user name and view the user's profile		     in UBB.Threads (Platinum Service Only)Working Under - UBB.Threads 6.2 & 6.3Pre-requisites - noneAuthor - Joshua Pettit (JoshPet) - www.joshuapettit.comFor discussion and bug reports, please come to www.ThreadsDev.comFiles Altered - ubbt_registerednav.tmpl, ubbt_unregisterednav.tmpl,  /languages/english/online.phpDatabase Altered - noneNew Files - chat.php, chatheader.php, chatroom.php, chatauth.php,			chatprofile.php, chat.tmplWarning - Note: Before modifing any UBB.Threads scripts, be sure to make backup copiesfirst.  Should you need official support from Infopop, you may need to restore unmodified UBB.Threads scripts.######################## Edit Variables####### In the chat.php file##- Edit the "topsize" variable at the top if your header is getting cut off- Edit the page title if you desire- Turn on or off the link for browsers that don't support iFrames#### In the chatroom.php file##- Edit the "anonaccess" to determine if people must be registered to use chat- Edit the "roomclosed" variable if you must temporarily close the room#### In chat.tmpl template file ##- Set the option if you are using AAS (Alternative Authtication System)  Requires a Platinum Raidersoft Account - details at www.raidersoft.com  If you are not using this option - or do not have a Platinum Raidersoft account  make sure you set this to 0.  - Edit your Raidersoft Chat Room ID Number    (If you are not sure, Login to your account at Raidersoft.com and click "Link     Instructions", you'll see your room ID number there - it's usually a 5 digit number).   ######################## Upload the files### - Upload chat.php, chatheader.php, chatauth.php, and chatroom.php to your UBB.Threads Directory- Upload the chat.tmpl template file to your /templates/default directory########################################### Open /languages/english/online.php####### Find this:##$ubbt_lang['FROM_IP']  = 	"From IP";?>#### Change to this:##$ubbt_lang['chat']  = 	"In the Chat Room";$ubbt_lang['chatheader']  = 	"In the Chat Room";$ubbt_lang['chatroom']  = 	"In the Chat Room";$ubbt_lang['FROM_IP']  = 	"From IP";?>###### NOTE: You may wish to also add these lines to the online.php file in ### the other language folders if your board uses multiple languages########################################################## Open /templates/default/ubbt_registerednav.tmpl####### Find this:##$members_link |<a href = "$phpurl/markallread.php?Cat=$Cat" $target>{$ubbt_lang['MARKALL']}</a>#### Change to this:##$members_link |<a href = "$phpurl/markallread.php?Cat=$Cat" $target>{$ubbt_lang['MARKALL']}</a> | <a href="$phpurl/chat.php?Cat=$Cat" $target>Chat Room</a>############################################################# Open /templates/default/ubbt_unregisterednav.tmpl##### ## Find this:##<a href="$phpurl/$FrontPage.php?Cat=$Cat">{$ubbt_lang['FORUM_IND']}</a> | <a href="$phpurl/search.php?Cat=$Cat">{$ubbt_lang['TEXT_SEARCH']}</a> | <a href="$phpurl/newuser.php?Cat=$Cat">{$ubbt_lang['NEW_USER']}</a> | <a href="$phpurl/login.php?Cat=$Cat">{$ubbt_lang['BUTT_LOGIN']}</a> | <a href="$phpurl/online.php?Cat=$Cat">{$ubbt_lang['WHO_ON']}</a> | <a href="$phpurl/faq.php?Cat=$Cat">{$ubbt_lang['FAQ_TEXT']}</a>#### Change to this:##<a href="$phpurl/$FrontPage.php?Cat=$Cat" target="_top">{$ubbt_lang['FORUM_IND']}</a> | <a href="$phpurl/search.php?Cat=$Cat" target="_top">{$ubbt_lang['TEXT_SEARCH']}</a> | <a href="$phpurl/newuser.php?Cat=$Cat" target="_top">{$ubbt_lang['NEW_USER']}</a> | <a href="$phpurl/login.php?Cat=$Cat" target="_top">{$ubbt_lang['BUTT_LOGIN']}</a> | <a href="$phpurl/online.php?Cat=$Cat" target="_top">{$ubbt_lang['WHO_ON']}</a> | <a href="$phpurl/faq.php?Cat=$Cat" target="_top">{$ubbt_lang['FAQ_TEXT']}</a> | <a href="$phpurl/chat.php?Cat=$Cat" target="_top">Chat Room</a>###### NOTE: If you have added additional links into your menubar already, ensure you ### add the target="_top" tag to the end of the HTML link.################################################################### AAS (Alternative Authentication Instructions)### If you are using Raidersoft's AAS System - Requires Platinum Account### You'll need to do this step as well.#### Test the chat authentication script##	   Test file using your UBB.threads username and password:	   For example:	   http://www.mydomain.com/ubbthreads/chatauth.php?username=JoshPet&password=pizza	   (replace JoshPet and pizza with your respective username/password)	   For this example, replace any spaces in your username or password	   with a +	   The script should print out a single 1, or a 2. If it prints out	   a 0, then the authentication failed; Double check your username and	   password are correct.#### Enable AAS in your RaiderSoft Control Panel##	 Log in to your RaiderSoft control panel at http://www.raidersoft.com	   a. Select "User Accounts" -> "Options"	   b. Scroll down to the "Alternative Authentication System (AAS)" section	   c. Select "Custom Authentication Script"	   d. Enter the URL to your newly installed auth.php file.	      I.e., 	      http://www.mydomain.com/forums/chatauth.php	   e. Scroll to the bottom of the page and click "Save Changes"	   d. Restart (if already started) your chat room and test your UBB.threads	      login name/password.### ### NOTE: If your forum was in operation prior to UBB.Threads version 6.0### older users may have trouble loggin into the chatroom due to the password### encryption changes that took effect in UBB.Threads version 6.0.### To solve this, users having trouble simply need to edit their profile### from the "My Home" screen of UBB.Threads, reenter their passsword### and update their profile.  They should have no further problems.################################################################### Profile Link ### Allows you to right click the Username and view their### Profile in a new window - Requires a Platinum Service Account	Make sure you uploaded the chatprofile.php script to your UBB.Threads Directory		Log in to your RaiderSoft control panel at http://www.raidersoft.com	  a. Select "User Account" -> "User List Integration"	  b. For 'Description' enter "View Profile"	  c. For 'URL' enter "http://www.yourforum.com/ubbthreads/chatprofile.php"	  d. Choose if you want this to be an Admin only option or not	  e. Click "Add Entry"	  f. Restart (if already started) your chat room and give it a test. ################################################################ TROUBLESHOOTING:###	Q. My Forum Header seems to be cut off.	A. Open chat.php and adjust the size for $topsize to a larger amount.	   This is the size of the top iFrame	   	Q. How do I temporarily close my chatroom.	A. Open the chat.php file and edit the value of $roomclosed		Q. I'm getting "Incorrect Password" errors from the Raidersoft Applet.	A. Open the chat.tmpl file and check the setting of $aas.  Note that to use this	   you must be a Platinum Service Customer (not Professional).  	   Make sure you've entered the URL to the chatauth.php script correctly in 	   your control panel at Raidersoft.com.  Double checkthe AAS instructions above.	Q. Who's Online in UBB.Threads shows a user in Chat, but when I go 	   into the room, nobody is in there. 	A. The UBB.Threads Who's Online system simply works off of what "script"	   the user is viewing.  So if they have clicked "Logout" in the chat module	   the system may show them on the chat page, even though they are not 	   specifically logged into the chat room.  Likewise, if a user simply 	   closes their browser window, Who's Online will continue to show them 	   online for the next 10 minutes.	   	Q. Why does the top of the page refresh every so often?	A. The UBB.Threads Who's Online system works off of what script the user  	   is viewing.  It is updated each time a new page loads.  Once you enter 	   the chat room, you are no longer loading new pages, and thus would 	   "drop off" the Who's Online list after 10 minutes, so the header of the  	   chat page (in an iFrame) refreshes every 9 minutes to keep the  	   Who's Online table accurate, and check if there are private messages etc...    	    	Q. The Chat room is just blank.... or it says "Applet Halted. Chat Room is Closed" 	A. Open the chat.tmpl file and ensure you have filled in the Chat Room ID  	   number in the variables near the top.  If that's correct, check the  	   RaiderSoft.com site for browser java troubleshooting tips. 	    	Q. Using the Profile Link for some users results in "no such user". 	A. This can be because of special characters in the display name.  I  	   have tried to account for correcting this - but if a user has special 	   characters and the profile won't come up, please report it at  	   www.threadsdev.com and I can work on the fix.   ################################################################ SUPPORT:###		Feel free to contact RaiderSoft for help with this script.	support@raidersoft.com	or Post Questions to the appropriate Thread at www.threadsdev.com		################################################################ Optional - Who's Online Integration### This optional modification will add a string of text below your ### menubar telling how many users are in the chatroom###For this optional step - follow the enclosed "ShowUsersInChat1.0.txt" instructionsincluded in this Zip