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

Chatroll is a great new way to reach, engage and grow your site's social media following. Add Chatroll's leading social chat widget to your WordPress sidebar, posts, and pages.

== Description ==

**Chatroll** is a great new way to **reach, engage and grow your site's social media following**. Add Chatroll's leading **social chat widget** to your WordPress sidebar, posts, and pages.

**Benefits & Features:**

***Social Chat***

* True real-time social interaction
* Reach, engage and grow your social media following
* Facebook and Twitter support

***Simple Design***

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

***Flexible Customization***

* Customize colors and size to match the look of your site
* 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
* Manage permissions for guests, signed-in users and moderators

***Works Everywhere***

* Works on ALL browsers and devices, including iPhone, iPad and Android!
* Built using HTML5 standards - no Java or Flash necessary

***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/" target="_blank">Create a Chatroll account</a>. From your Chatroll Dashboard, create a new live event and 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/" target="_blank">Create a Chatroll account</a>. From your Chatroll Dashboard, create a new live event and 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 ==

= 2.1 =
* Updated description and install instructions.

= 1.2.5 =
* Improved Gravatar support. Removed Curl dependency.

= 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