WordPress.org

Plugin Directory

Simple Ajax Chat

Simple Ajax Chat displays a fully customizable Ajax-powered chat box anywhere on your site.

Installation

Activate the plugin and visit the SAC settings page to customize your options.

Once everything is customized as you like it, display the form anywhere using the shortcode or template tag.

More info on installing WP plugins

Upgrading

IMPORTANT: the time functionality has been upgraded in version 20150316. As a result, all chat messages will be deleted when the plugin is upgraded to the latest version. If you want to save your current chats, please make a backup BEFORE upgrading. This applies only to people who are upgrading from a version less than 20150316.

ALSO: After upgrading, if your chat box displays something like "you need at least one message..", do the following:

  1. Backup or make a note of your chat settings (so you can restore them)
  2. Click the "Restore default settings" button
  3. Reconfigure your settings and done

Apologies for the inconvenience, but the plugin is better off using WP time functionality.

Shortcode

Use this shortcode to display the chat box on a post or page:

[sac_happens]

Template tag

Use this template tag to display the chat box anywhere in your theme template:

<?php if (function_exists('simple_ajax_chat')) simple_ajax_chat(); ?>

Stopping spam

This plugin works in two modes:

  • "Open air" mode - anyone can comment
  • "Private" mode - only logged in users may comment

In terms of chat spam, the "open air" mode is much improved at blocking spam, but some spam still gets through the filters. As a general rule, the longer your chat forum is online, the more of a target it will be for spammers.

If you absolutely don't want any spam, run the plugin in "private" mode. In private mode, the chat forum will require login to view and use, and no spam should make it through.

Alternately/optionally you may use the included .htaccess file to add some simple rules to block users by IP and other variables.

Other notes

If the chat form looks messed up on your theme, try disabling the checkbox for "Enable custom styles?"

If that doesn't help, you can include your own custom CSS. To do so, replace the "Custom CSS styles" with your own, and then enable the "Enable custom styles?" setting. Alternately, you may include custom CSS via your theme's stylesheet.

If your site's wp-blog-header.php and wp-config.php are not located in the usual default location (i.e., you have moved them to a custom location), you will need to edit the paths in /simple-ajax-chat.php (line 4) and /resources/sac.php (line 9). At some point I will be revamping the way that these files are included so that this modification won't be necessary.

Requires: 4.0 or higher
Compatible up to: 4.3
Last Updated: 2015-8-8
Active Installs: 1,000+

Ratings

4.5 out of 5 stars

Support

2 of 3 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,1,1
0,1,0
100,1,1 50,2,1
100,1,1 100,1,1
100,1,1 100,2,2 100,1,1
0,1,0
100,1,1 100,1,1
100,1,1 67,3,2 100,1,1
100,2,2
100,1,1