Frequently Asked Questions

Looking for general information on WP Ajaxify Comments? Click here.

 

The plugin is not working, what can I do?

It is recommended to use the plugin’s debug mode that can be enabled on the plugin’s settings page (Settings > WP-Ajaxify-Comments). After enabling the debug mode, use a browser that supports console.log(…) (e.g. Firefox with the Firebug extension or Google Chrome). Open a page that contains a comment form. If the plugin is not working, you will most likely find an error message in the console saying that one of the selectors does not match any element.

If your theme does not use the default IDs for the comment form (#commentform), the comment container (#comments) or the respond container (#respond), you’ll need to go to the plugins settings page and provide the proper selectors.

Please note: If you don’t succeed in configuring the proper selectors, we’d be happy to support you! Check our support page for further information on individual assistance. The plugin is highly customizable and we’re aware of only a few conflicts with any themes or other plugins that cannot be resolved (see “Known incompatibilities” in the FAQ section).

 

Can I suggest new features?

If you feel something is missing, or if you have any other suggestions, please contact us.

 

Are there any known problems?

There are problems when using an old jQuery version. The plugin was successfully tested with jQuery 1.4.4 and above.

The debugging mode does not work in Internet Explorer 8 (and older versions). Please use Firebug, Google Chrome or Internet Explorer 9 or above for debugging WP-Ajaxify-Comments.

Please see also the “Known incompatibilities” section.

 

Does this plugin work with every WordPress theme?

Since the plugin hooks into the DOM that is generated by the theme, there is no guarantee that the plugin will work with every theme.
Basically, the plugin uses (jQuery) selectors to find the required DOM elements, such as the comment form and the list of comments. Please go to the plugin’s settings page to customize these selectors if the default selectors don’t match the elements in your theme.

There is no guarantee, but (as written above) the plugin is highly customizable and we are only aware of a few conflicts with themes or other plugins that cannot be resolved (see section “Known incompatibilities” below).

 

Can I add or update translations?

If you would like to support the plugin by adding or updating translations, please contact us. After installing the plugin, you can find more information about translations in the file wp-content\plugins\wp-ajaxify-comments\languages\readme.txt.

 

Does the plugin work with older WordPress versions than 3.1.3?

Most likely yes, but it has not been tested yet. For security reasons, you should consider upgrading your WordPress installation.

 

Are there any future plans?

Yes, there are some features we’d like to add in future versions:

  • Client-side validation
  • Option to enable vertical alignment of overlays
  • Option to customize popup overlays with user-defined CSS
  • File upload support

 

How to enable the debug mode?

The debug mode can be enabled on the plugin’s settings page (Settings > WP-Ajaxify-Comments).

 

Which callback options are supported and how do I use them?

The plugin provides some JavaScript callback options that can be used to add custom JavaScript code that is executed on client-side when certain (wp-ajaxify-comments related) events occure. Please note that these callbacks are client-side callbacks, i.e. you cannot execute any PHP code using these callback options.

In detail, the following callbacks are supported:

  • OnBeforeSelectElements: Called before the plugin selects any DOM elements. The DOM tree the plugin is currently working on is passed as parameter “dom”.
  • OnBeforeSubmitComment: Called before a (new) comment is submitted.
  • OnBeforeUpdateComments: Called before the plugin replaces the comments.
  • OnAfterUpdateComments: Called after the plugin has replaced the comments.

 

How do I use the client-side API?

In addition to the callback options, the plugin provides a JavaScript-based client-side API that supports the following functions:

  • WPAC.RefreshComments(options): Refreshes the comments on the current page
  • WPAC.LoadComments(url, options): Loads the comments from another url/page

The options are defined as key/value pairs. The following keys are supported:

  • scrollToAnchor: Whether or not to scroll to the anchor of the target url/page (default: true)
  • showLoadingInfo: Whether or not to show a “loading” overlay (default: true)
  • updateUrl: Whether or not to update the browser url (default: false if option “Disable URL updating” is enabled, true otherwise)
  • success: A function to be called when the comments have been updated/replaced

 

Does the plugin use any external libraries?

Yes, the plugin uses the following libraries:

 

Known incompatibilities

There are known incompatibilities to the following plugins:

  • WP-reCAPTCHA (tested with WP-reCAPTCHA 3.1.6)
  • Jetpack with activated “Jetpack Comments”