=== Ajax Comment Posting ===
Contributors: regua
Tags: comments, ajax, post, comment
Requires at least: 1.5.2
Tested up to: 2.3.1
Stable tag: 1.2

Posts comments without refreshing the page and validates the comment form using Ajax.

== Description ==

There are many comment-related plugins in Wordpress plugin directory. However, if you'd like to find just a simple comment-posting Ajax plugin, you won't find any. That's why I developed a simple yet functional Ajax Comment Posting (ACP) plugin. Not only will it post your comment without refreshing the page, but it will also make sure that you've filled all the form fields correctly.

The plugin works well in all major Web browsers, and switches to the traditional comment posting if JavaScript is disabled.

ACP should work with all CAPTCHA word-verification plugins, but I personally suggest using [Akismet](http://codex.wordpress.org/Akismet "The Akismet anti-spam plugin").

You can easily add some more functionality to your comment form using [jQuery](http://jquery.com "The jQuery JavaScript framework"), the best JavaScript framework, which is used by ACP to handle the Ajax requests and all those fancy fade-in/out effects.

== Installation ==

1. Upload the plugin directory `ajax-comment-posting` to the `wp-content/plugins` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. That's it!

== Frequently Asked Questions ==

= Why isn't my plugin working or it works differently than it should? =

It's probably your WordPress theme's fault. ACP needs several things to be present in your comments.php file (in the theme's default directory). The submit button has to have a `submit` id, the comment form has to have a `commentform` id, the ol (or div, whatever) with the comments has to have a `commentlist` class. Also, make sure that the following code is present somewhere in the head (header.php) section of your theme: `<?php wp_head(); ?>`
Most WordPress themes meet these requirements. If yours doesn't - please let me know.

= How can I customise the look of the error and success messages? =

You can either change the `acp.css` file in the plugin's directory, or just delete the file and add `error` and `success` classes to your CSS stylesheet.

= How can I change or remove the loading icon? =

The loading icon is the file `loading.gif` inside ACP's directory. If you want to remove the icon, just delete the icon image file and you'll get a 'Loading...' message instead. Also, you can edit the `acp.js` file (line 12).

= Why does the comment form disappear after a comment has been? =

For security reasons. Usually users dont want to post two comments in a row, so whats the reason in leaving the form there? If you still want to keep it from being removed, delete the line 68 in the `acp.js` file.

= How does the plugin work? =

Firstly, it validates the form - checks if you've enter a name, (valid) email address and the comment (if you're a logged-in user, you don't have to enter the name and email, of course). Then it submits the form using Ajax (Asynchronous JavaScript and XML), then checks if server returned an error and adjust the display method to the server response. Also, after a successful submission, it removes the comment form (see the question above if you want to prevent this from happening) and displays a nice, green-coloured message.

= Can you help me with it? =

Of course. [Contact me](http://regua.biz/contact "Contact the author of the plugin") if you have any questions, bug reports or suggestions. In case of a bug report or help request, please include your comments.php file from your theme's directory as an attachment to the email / message.

== Screenshots ==

Visit [the plugin page](http://regua.biz/acp "The ACP page") to see the plugin screenshots.

== Thanks ==

HUGE thanks to [Aen Tan](http://aendirect.com "Aen's homepage") for solving a WP 2.3.1 bug, correcting my mistakes and preventing the plugin from conflicting with Prototype.

Also, I'd like to thank [Gene Steinberg](http://macnightowl.com/ "Gene's homepage"), [Rayne Bair](http://www.wifetalks.com/knits/ "Rayne's homepage") and [Dave Anderson](http://cv.67design.com/ "Dave's homepage") for pointing some errors and suggesting the further development of the plugin.