Happy Tuesday 🙂 The WP REST API The REST API is an acronym for the RESTful Application Program Interface (API) that uses HTTP requests to GET, PUT, POST and DELETE data. It is how the front end of an application (think “phone app” or “website”) can communicate with the data store (think “database” or “file system”) https://developer.wordpress.org/rest-api/. team is proud to bring you: 2.0 Beta A pre-release of software that is given out to a large group of users to trial under real conditions. Beta versions have gone through alpha testing in-house and are generally fairly close in look, feel and function to the final product; however, design changes often occur as part of the process. 12 “Canyonero”. Download it from the plugin repository or from GitHub.
Here are some highlightsbreaking changes from the changelog:
- Removes meta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. endpoints from primary plugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party. If your project depends on post meta endpoints, please install WP REST API Meta Endpoints. For the gory history of meta, read #1425 and linked issues. At this time, we recommend using
register_rest_field()
to expose meta (docs).
- Returns original resource when deleting PTCU. Now that all resources require the
force
param, we don’t need to wrap delete responses with the trash
state.
- Uses
roles
rather than role
in the Users controller. Building the REST API gives us the opportunity to standardize on roles
, instead of having both roles
and role
.
- Moves to consistent use of
context
throughout controllers. Contexts limit the data present in the response. Here’s how to think of them: embed
correlates with sidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. representation, view
represents the primary public view, and edit
is the data expected for an editor.
- Removes
post_*
query param support for GET /wp/v2/comments
. The proper pattern is to use GET /wp/v2/posts
to fetch the post IDs to limit the request to.
- Introduces
rest_validate_request_arg()
/rest_sanitize_request_arg()
. Dedicated functions means we can use them for validating / sanitizing query args too. Removes WP_REST_Controller::validate_schema_property()
and WP_REST_Controller::sanitize_schema_property()
.
As always, we have a detailed changelog as well as the full set of changes if you’re interested.
What’s the future of the WP REST API? I’d like to leave you with this final thought:
What came first, the chicken or the egg?
I egged the chicken, and then I ate his leg
#feature-plugins, #json-api, #rest-api