Ajaxize

How does ajaxize work?

To ajaxize your plugin or function, the only thing you need is the function name.
Go to Settings->ajaxize and enter your function name. Then click ‘Generate DIV’.

If all is working fine you should get a div that you can add to any page, post or template.
You should also see the output of the generated div below.

How do I find the correct function name?

Many plugins come with shortcodes or function names that can be entered directly into the template.
It is usually within the plugin documentation. Search the documentation for information how to use the plugin in your templates. Otherwise, you can try the plugin editor (Plugins->Editor), select your plugin and then search for the function name inside the php code.

Are there any limitations to which functions I can use?

Yes.
1. Functions must return valid HTML – this will be called in php and returned via the Ajax call
2. Functions cannot accept any parameters (at least at the moment)

How can I test if ajaxize is working?

Try ‘ajaxize_test’ (without the quotes) and click Generate DIV to test it.

What is the Secret Key? Do I need to change it?

The secret key is there to allow you to ajaxize any function you want, but only the functions you want and not others. The secret key is used to create a ‘signature’ on the div you generate. This signature is generated using HMAC, and the Secret Key is the key used by HMAC.

A few notes about the secret key:
1. A random Secret Key is automatically generated when the plugin is first installed.
2. You can change your secret key, but please be aware that any previously-generated divs will stop working.
3. Do not post or share this key! Please only change it if you know what you’re doing.

Can I add stuff or modify the div?

This is a normal div. The only part that you cannot change is the id section. Even the smallest change to the id will invalidate the signature, and it will stop working.
Therefore, if you have a new function you also want to ajaxize – you’d have to use the ajaxize generator. Don’t just replace the function name, because the signature will not be valid for any other function.

What is this good for?

ajaxize is most suitable when you are using a caching solution (W3 Total Cache, WP Super Cache etc). With ajaxize you can keep the page cached, but still pull content dynamically. Best used for quotes, feedbacks, statistics etc, but can work on almost any type of output.

It might also be useful to speed up page loads with plugins like Facebook and Twitter buttons (which often take some time to load if embedded directly).

It won’t make you rich in 21 days nor will it make your pencil longer.

Can I automatically refresh the div every X seconds?

Yes, but currently you’d have to write your own javascript for it.
Here is a small example using jQuery (replace with your own div id):

<script>
jQuery(document).ready(function($) {
    var refreshId = setInterval(function() {

        var $data = $('div[id*="ajaxize_this:REPLACE_THIS"]');
        $data.each( function() {
            $data.fadeOut(2000, function() {
                var newquery = $.query.set('ajaxize_this', $data.attr('id')).set('_wpnonce', ajaxizeParams._wpnonce);
                $data.load(location.pathname + newquery, function() {
                    $data.fadeIn(2000);
                });
            });
        });

        return false;
    }, 10000);
});
</script>

I’m getting an error after generating a DIV “ajaxize: Error executing . Is this function correct?” What’s wrong?

Check that the function name is correct, do not include brackets. Use: some_function instead of some_function().
Make sure the function does not require any parameters either.

I generate a DIV but the Function output is empty. Why?

Some plugins/functions produce iframes and other content that might only get displayed in the right context.
In general, if there’s an error, you would get an error message on the settings page. Try to copy the div into a post instead. It might still work.

I’m getting -1 instead of the content some times. Is there anything I can do?

You can try de-selecting the Ajax Referer Check option. For security reasons, please check that your ajaxize function doesn’t have any side-effects. It is recommended to keep this option On. Only use if you understand the risks. For more information, please see https://codex.wordpress.org/Function_Reference/check_ajax_referer

1.4

Removed deprecated split function
Added an option to remove Ajax referer protection (not recommended, but helpful in some rare cases)
Tested for compatibility with WordPress 4.0

1.3

Updated to work within 404 templates (thanks to ovidiubica for reporting)

1.2.1

Small change to documentation only.

1.2

Small security improvements (added nonce to the javascript) and tested with WordPress 3.2.1

1.1

Context information is much better handled in ajaxize. Special thanks to One Trick Pony.

1.0.2

Code tidy-up. No functionality changes

1.0.1

quickfix for an all-encompasing hook that breaks lots of other wordpress functionality.

1.0

• First release