=== Chatroll Live Chat ===
Contributors: chatroll
Donate link: http://chatroll.com
Tags: chatroll, live, widget, chat, sidebar, shoutbox
Requires at least: 2.8
Tested up to: 2.9
Stable tag: 1.2.4

Chatroll is a simple and flexible chat plugin for WordPress. Use Chatroll as a live chat or shoutbox on your sidebar, posts and pages.

== Description ==

**Chatroll Live Chat** is a simple and flexible chat plugin for WordPress.
Use Chatroll as a **live chat** or **shoutbox** on your sidebar, posts and pages.

**Benefits & Features:**

***Elegant & Simple Interface***

* Clean, clutter-free user interface
* Embed chat using shortcode or widget

***Flexible Customization***

* Customize colors and size to match the look of your site

***User Integration***

* Supports Single Sign-On (SSO) for seamless integration with the WordPress login system

***Powerful Moderation***

* Moderate chat with 1-click delete, profanity filters and IP block

***Fine-Grained Access Control***

* Manage read, write and moderate permissions for Guests and Registered users

***Fast Loading and Scalable***

* Chat connects instantly - No heavy Flash download!
* AJAX / DHTML compliant - Works on all major browsers, including iPhone and Android!

***Hosted, Cloud Solution***

* No programming, servers or database maintenance
* On-demand scaling - Supports over 500+ simultaneous users in chat

***FREE!***

* Get started for free
* Upgrade anytime for additional capacity and support


== Installation ==

**Quick Install**

<a href="http://chatroll.com/create" target="_blank">**Click here**</a> to create a Chatroll. Choose the "WordPress Self-Hosted" instructions to install the plugin and add Chatroll to your sidebar, posts and pages.

**Manual Install**

1. Download and extract the plugin
2. Upload the `chatroll-live-chat` directory to your `/wp-content/plugins/` directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. <a href="http://chatroll.com/create" target="_blank">**Click here**</a> to create a Chatroll. Choose the "WordPress Self-Hosted" instructions to add Chatroll to your sidebar, posts and pages.

== Frequently Asked Questions ==

= Can I use more than one Chatroll widget in my site? =

Yes, you can add as many Chatroll widgets as you want to your sidebar, posts and pages.


= How can I add a Chatroll widget to a post or page? =

Use the 'chatroll' shortcode anywhere in a post or page. <a href="http://chatroll.com/create" target="_blank">Click here</a> to create a Chatroll. Choose the "WordPress Self-Hosted" instructions to install the plugin and get a shortcode to paste in your post or page.


= What are some ways I can use Chatroll?  =

Chatroll can be used in a wide variety of ways.  Most commonly, it is used as a live chat for community-based sites.  Here are a few common usages:

* **Live radio show chat** - Host a radio show and put a chat next to your audio / podcast stream
* **Live video show chat** - Host a video show and put a chat along side the video stream
* **Live blogging** - Use Chatroll to live blog an event, such as a conference or news announcement
* **Community chat** - Create a dedicated chat page for your site's community
* **Topic based chat** - Embed multiple chats, one for each topic
* **Private chat** - Create a space for administrators, co-workers, or private groups to communicate
* **Sidebar shoutbox** - See the number of viewers online and interact with your readers
* **Pop-out shoutbox** - Add a link to popup a shoutbox, create your own IM for your site
* **Comment shoutbox** - Add a shoutbox as a footer widget, for users to leave live comments
* **Combined** - Add a shoutbox to the sidebar and create a dedicated live chat page


= I get an error similar to "Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' in /.../wp-chatroll.php on line ##" when I try to activate the plugin.  Is your plugin broken? =

No.  This error occurs because the plugin requires PHP 5 and you're running PHP 4. Most hosts offer PHP5 but sometimes you have to enable it in your control panel, through .htaccess, or by asking them.  There may be instructions for your specific host in the <a href="http://codex.wordpress.org/Switching_to_PHP5">Switching to PHP5</a> article in the codex.


== Screenshots ==

Installing Chatroll is so easy, we recommend you <a href="http://wordpress.org/extend/plugins/chatroll-live-chat/installation/">install it now</a> to see how it looks on your site.

For more information, check out our <a href="http://chatroll.com/tour">Tour</a> or try a <a href='http://chatroll.com/solutions/wordpress-chat-plugin'>Live Demo</a>.


== Changelog ==

= 1.2.4 =
* Add support for Gravatars and local avatars.

= 1.2.3 =
* Improved install instructions.

= 1.2.2 =
* Improved widget instructions.

= 1.2.1 =
* Chatroll API updates.

= 1.1 =
* Added Chatroll SSO support.

= 1.0 =
* Original Version.

== Upgrade Notice ==

= 1.2.3 =
Quick create link. Improved instructions.

= 1.2.1 =
Uses the new Chatroll embed API format.

= 1.1 =
Allows SSO integration with WordPress login