=== 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.1

Chatroll is a simple and flexible chat for WordPress. You can use it as a chat or shoutbox, on your sidebar, posts and pages.

== Description ==

<a href="http://chatroll.com/solutions/wordpress-chat-plugin">Chatroll</a> is a simple and flexible chat for WordPress.
Use Chatroll as a **live chat** or **shoutbox** on your sidebar, posts and pages.

*Your rating and feedback are important and will help us improve Chatroll.  Please rate our plugin!*

**Getting Started:**

*  <a href='http://chatroll.com/create'>Install Chatroll in 3 Easy Steps &raquo;</a>


**Related Links:**

*  <a href="http://chatroll.com/solutions/wordpress-chat-plugin">Chatroll Wordpress Chat Demo &raquo;</a>
*  <a href="http://chatroll.com/help/support?r=wordpress-org">Chat plugin Support &raquo;</a>


**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 WordPress user profiles

***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, iPhone and Android!

***Hosted, Cloud Solution***

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

***FREE!***

* Get it Free today
* Upgrade anytime for premium support and capacity




**<a href='http://chatroll.com/create'>Get Your Chatroll Now &raquo;</a>**


== Installation ==

**Easy Installtion**

Install chat in 3 Easy Steps. Start here: <a href='http://chatroll.com/create'>**Create your Chatroll &raquo;**</a>


**Advanced Installation**

1. Upload the whole `chatroll-live-chat` directory to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Follow the instructions on <a href='http://chatroll.com/create'>Chatroll</a> to create a Chatroll, customize the settings, and generate a WordPress shortcode.
4. To add Chatroll to your sidebar, go to 'Appearance' -> 'Widgets' in WordPress admin and add "Chatroll" to one of the widget-ready areas of your site. Paste your Chatroll shortcode in the box and click "Save".
5. To add Chatroll to posts or pages, simply paste the Chatroll shortcode where you want Chatroll to appear in your post or page.

== 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 to embed the Chatroll widget into a post or page.
You can easily generate a shortcode by going to your Chatroll's Settings page.


= What are various ways to use Chatroll?  =

Publishers use Chatroll in a wide variety of ways.  Most commonly, they are used as a live chat or shoutbox.  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
* **Community chat** - Setup a dedicated chat page for your blog visitor
* **Topic based chat** - Embed multiple chats, one for each topic
* **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 it on the sidebar as a shoutbox and add it on a page as a live chat


= 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 ==

Go to <a href='http://chatroll.com/solutions/wordpress-chat-plugin'>Chatroll</a> to see a live chat demo and get started.





== Changelog ==

= 1.2.1 =
* Chatroll API updates.

= 1.1 =
* Added Chatroll SSO support.

= 1.0 =
* Original Version.

== Upgrade Notice ==

= 1.2.1 =
Uses the new Chatroll embed API format.

= 1.1 =
Allows SSO integration with WordPress login