PSR-7 / PSR-15 compatible AJAX router for WordPress.

Inspired by NestJS and Express - this library provides a simple way to handle AJAX requests in WordPress.

QuickStart

Install the library

Define a controller

Register a controller

This will expose the following endpoints:

• GET /wp-ajax/my-endpoint/get-post/{id}
• POST /wp-ajax/my-endpoint/modify-post/{id}

Ajax base URL is /wp-ajax by default, and can be changed in permalink settings.

Getting Endpoint URLs

In PHP

In JavaScript

Library adds a global object xwp attached to window object. Both in the admin and on the frontend. You can disable this by using xwp_ajax_vars filter, or calling the xwp_disable_ajax_js_vars

FAQ

1. Did you just reinvent the wheel?

Yes, we did. We basically took the wheels from NestJS and Express and put it on a WordPress car.

2. Why?

Read this.

3. Can I use this in my project?

Yes, you can. But remember, this is a work in progress and we are still figuring out the best way to do things. API is subject to change.

4. Can I contribute?

Sure 💪💪💪.
If you have an idea, a suggestion, or a bug report - feel free to open an issue.

5. How does it work?

Read this.