WordPress.org

Visit the plugin page for FAQ in different languages.

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 (list) 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 - either correct it by yourself or let me know.

Also, another cause of the plugin disfunctioning may be Google Analytics. Read on for solution to this problem.

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.

The loading icon doesn't show. What can I do?

You can manually set the direct path to the loading image in the acp.js file (line 35).

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 35).

The plugin conflicts with Google Analytics. What should I do?

You have two ways: either switch to the old Google Analytics code instead of the new one (available in the GA settings panel), or edit the acp.js file and insert your GA tracking code (you can find it in the GA control panel) in line 15. Please keep in mind that Google Analytics will not recognise the script as installed immediately, it may take a few hours for it to start working.

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

For security reasons. Usually users don't want to post two comments in a row, so what's the reason in leaving the form there? If you still want to prevent it from being removed, delete the line 105 in the acp.js file.

I don't want the email address field to be validated. How do I do that?

Just delete or comment the lines 52-61 in the acp.js file.

Some other plugin installed on my WordPress uses jQuery as well. Can I make ACP use the jQuery library provided with the other plugin so that I didn't need to waste additional 30kB?

Yes, just edit the ajax-comment-posting.php file (line 13) and change the jQuery path. Just make sure it's jQuery 1.2.2 or higher version.

Is the plugin available in different languages?

Yes, and all you have to do to change the plugin's language is to download one small file from the plugin's page and upload it to your plugin's main directory.

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 obviously don't have to enter the name and email). Then it submits the form using Ajax (Asynchronous JavaScript and XML), checks if server returned an error and adjusts the display method to the server response. Also, after a successful submission, it appends your newly posted comment to the comment list (or creates one if not present), removes the comment form (see 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 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, and explain your problem thoroughly giving all needed details: your WordPress and ACP version, other Ajax-based plugins you are using, etc.