Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
help:installing:webchat [2007/03/04 14:35]
dcraig
help:installing:webchat [2013/05/19 10:41] (current)
rubin
Line 1: Line 1:
-====== Add Chat to Your Website ======+~~NOTOC~~
  
-<box 30% orange left | Try Out Our Chat Applet> +====== AfterNET in your Browser with Qwebirc ======
-<javachat2> +
-</box>+
  
-===== Overview =====+We now offer [[https://qwebirc.afternet.org/|QWebIrc]] where you can chat on AfterNET in your browser. 
  
-Our standard WebChat applet can easily be added to any web page on any web server or free host and only requires that your users have a [[http://www.java.com/getjava/|Java]]-enabled browser, which more than 97% of users do. We do not add any banner ads or popup windows to your website or try to install any adware or spyware, so your users can rest assured that using our WebChat applet on your site is completely safe.+===== Advantages ===== 
 +  * Connects using https protocol, which is securely encrypted and unlikely to be filtered on even the most paranoid internet connection. 
 +  * Works anywhere with a javascript enabled web browser, such as [[http://www.firefox.com|FireFox]] or Internet Explorer. 
 +  * Built in support for Login-on-Connect so you can authenticate with your AfterNET Account easily and keep your IP hidden from other chatters.
  
-By default, the login form our WebChat script generates is as simple as possible. This is to allow you to customize it to match the look and feel of the rest of your website, and you can read the information further below to learn how to modify many aspects of the script. The script also gives users the option to automatically login to their AfterNET account using [[help:connecting:login-on-connect|Login-on-Connect]].+===== How to Use ===== 
 +  * Open [[https://qwebirc.afternet.org/|qwebirc.afternet.org]]
 +  * Enter a nickname and a channel where you want to go. If you don't know a channel, start in '#AfterNET' 
 +  * If you have registered an AfterNET Account, enter your account and password in. If not, just leave them blank.
  
-An AfterNET account allows you to permanently own your channel and also hides your IP address from other users on the network, but it is typically not required for visitors to your website to obtain an account with us to use our WebChat applet. We use [[help:connecting:dnsbl|DNS RBL blocking]] to prevent spam on our network, so a small portion of your users may be required to use [[help:connecting:login-on-connect|Login-on-Connect]] to connect.+===== Add Chat to Your Website =====
  
-===== How to Set It Up =====+You can embed the qwebirc session into an existing website, to have your visitors chat via afternet!
  
-The easiest way to set up and install our WebChat applet on your site is to simply copy and paste the following code and insert it into the HTML code of your web page where you'd like the WebChat applet to appear. You'll want to edit the nickname, channel, width, and height variables to customize the default nickname for your visitors, the name of your channel (or chat room), and the size of the Java applet. Be sure that the channel name begins with the # character. You can also choose whether to have the applet open in a new window or expand to fill the space occupied by the login form. +==== Link to chat ==== 
-<code> +Simply link to a URL like this:
-<!-- AfterNET WebChat: Start --> +
-<script src="http://www.afternet.org/chat/afterjavachat.js" type="text/javascript"> +
-</script> +
-<script type="text/javascript"> +
-after_nickname 'Traveler'; +
-after_channel  '#afternet'; +
-after_width    '800'; +
-after_height   '600'; +
-after_newwin   'true'; +
-after_webchat(); +
-</script> +
-<!-- AfterNET WebChatEnd --> +
-</code>+
  
 +  https://www.afternet.org/qwebirc/?nick=MYVISITOR_.&channels=MYCHANNEL&prompt=1&uio=d4
  
-===== Making Your Channel Your Own =====+but change MYCHANNEL to your channel name (ie #frogs), and MYVISITOR to something disinct (ie. ANONFROG)
  
 +Or, you can embed the chat in your own web page instead of a link:
  
-On our network you have the ability to permanently own your channel (or chat room). This allows you to kick out or ban troublesome visitors and extend these rights to others you trust. Once you've found a channel on our network that is not in use by anyone else, you can make that channel your own by following some simple steps. +<code html
- +  <iframe src="https://www.afternet.org/qwebirc/?nick=MYVISITOR&channels=MYCHANNEL&prompt=1&uio=d4" width="647" height="400"></iframe>
-  * Join your new channel using the WebChat applet and verify that nobody else is in it. +
-  * Create an AuthServ account to use X3, our channel services bot. To do this, type the following command: +
-<code> +
-/authserv register <username> <password> <email>+
 </code> </code>
-You'll need to fill in your desired username, password, and email address above. Your email address is only used to prevent multiple registrations and if you forget your password. We never use it to send you spam or for any other purposes. 
-  * Check your email and type the command from the email to complete the account registration. It should look something like this: 
-<code> 
-/msg AuthServ@X3.AfterNET.Services COOKIE <username> a1b2c3d4e5 
-</code> 
-  * You should now be automatically logged in to your account. In the future, you can use the login-on-connect feature of the WebChat form to login when you connect or you can type the following command once connected: 
-<code> 
-/authserv auth <username> <password> 
-</code> 
-  * Now that you are in your channel and logged in, you can register your channel with this command: 
-<code> 
-/x3 register <channel> 
-</code> 
-Remember that the channel name in the above command must begin with the # character. Our channel service bot, X3, will then join your channel. Whenever you login with AuthServ and join your channel, X3 will automatically make you a channel operator. You can learn all about X3's functions on this help page or by typing .help in your channel. 
-  * If you have any questions, feel free to /join #afternet or /join #help and ask for assistance! 
- 
-===== How to Make Detailed Modifications ===== 
- 
-Our WebChat script has many other variables that you can modify. Here is an expanded version of the simple code above that shows every setting you can change along with its default value. 
- 
-<code> 
-<!-- AfterNET WebChat: Start --> 
- 
-<script src="http://www.afternet.org/chat/afterjavachat.js" type="text/javascript"> 
-</script> 
-<script type="text/javascript"> 
- 
-// Login form settings 
-after_nickname    = 'Traveler';         // default nickname 
-after_channel     = '#afternet';        // default channel 
-after_showchan    = 'true';             // show channel box in login form 
-after_loccolor    = 'blue';             // login-on-connect link color 
-after_loctext     = 'underline';        // login-on connect link style 
- 
-// Java applet settings 
-after_newwin      = 'true';             // open applet in new window? 
-after_width       = '800';              // applet width 
-after_height      = '600';              // applet height 
-after_name        = 'AfterNET WebChat'; // full name 
-after_userid      = 'webchat';          // userid in userid@host 
-after_quitmessage = 'Goodbye!';         // quit message 
-after_fontface    = 'Arial';            // chat font typeface 
-after_fontsize    = '12';               // chat font size 
-after_useinfo     = 'false';            // use infos instead of status 
-after_smileys     = 'false';            // use graphical smileys 
-after_bgimage     = 'true';             // use background image 
-after_helppage    = 'http://www.afternet.org/help'; // help 
- 
-// Java applet colors 
-after_color11     = 'ff0000';           // operator 
-after_color12     = 'ff6600';           // halfoperator 
-after_color10     = '009900';           // voice 
-after_color0      = '';                 // black 
-after_color1      = '';                 // white 
-after_color2      = '';                 // dark gray 
-after_color3      = '';                 // gray 
-after_color4      = '';                 // light gray 
-after_color5      = '';                 // foreground 
-after_color6      = '';                 // background 
-after_color7      = '';                 // selection 
-after_color8      = '';                 // event 
-after_color9      = '';                 // close 
- 
-after_webchat(); 
- 
-</script> 
- 
-<!-- AfterNET WebChat: End --> 
-</code> 
- 
-Additionally, the entire WebChat script lives inside <div id="afterwebchat"></div> tags, so you can use CSS to make further modifications to look and feel of the applet. 
  
-Enjoy chatting on AfterNET!