WordPress Post from Front End using REST API and Vue.js Part II
The objective of this post is to demonstrate some Vue.js basics for working with the WordPress REST API. This post continues where the last post left off with the following additions.
- List posts submitted by the current user
- Select from the list to edit a post
- Delete a post from the list
Source Code
A React hooks version of this proof-of-concept is available here.
Development
The original proof of concept details building the WordPress plugin, installing Vue.js, Webpack and configuring for development. Also included is information on creating the front end slug where the Vuejs app will run. The end product is a simple form to submit new posts from a custom WordPress page template. It is recommended that you read these aforementioned prerequisites:
List Posts
App.vue
Above the form, replace the hardcoded heading text with a placeholder to render heading data that will be adding to the data model.
Below the form, add this markup to display the messages for loading and errors along with the list element for the posts. Note the vue.js v-if
attributes to control visibility of the elements depending on the data model values. This is called conditional rendering.
<h3>{{ heading }}</h3>
<form v-on:submit.prevent="onSubmit">
...
</form>
<div v-if="loading">
Loading...
</div>
<div v-if="error">
{{ error }}
</div>
<div v-if="posts">
<ul>
<li v-for="post in posts">
<a href="#" @click='editPost(post)'>{{ post.title.rendered }}</a>
</li>
</ul>
</div>
Note that an ellipsis … in the code snippets are not a part of the code and are there only to denote code that is being skipped and not applicable to the example. To view the entire file, examine the source code.
In the App.vue component script
block, update the data model for the new elements.
...
data() {
return {
error: null,
heading: 'Submit New Post',
loading: null,
post_id: null,
post_title: null,
post_content: null,
posts: null
}
},
...
Insert the getPosts ()
method to fetch all the posts for the current user and set the posts property of the data model. The endpoints for the WordPress REST API can be looked up at its base url.
...
methods: {
getPosts () {
this.error = this.posts = null
this.loading = true
var params = '?author='+ wp_api_vuejs_poc.current_user_id +'&status=any';
$.ajax({
url: wp_api_vuejs_poc.rest_url + 'wp/v2/posts' + params,
beforeSend: function ( xhr ) {
xhr.setRequestHeader( 'X-WP-Nonce', wp_api_vuejs_poc.nonce );
}
})
.done( $.proxy( function( response ) {
this.loading = false;
this.posts = response;
}, this ))
.fail( $.proxy( function( response ) {
this.error = response;
}, this ));
},
...
}
Insert the mounted function to call the getPosts
method when the app has rendered. If there are any posts to show when the page loads, they should be listed.
App.vue
...
methods: {
mounted: function () {
this.$nextTick(function () {
this.getPosts ();
})
},
...
}
Development Build
In your CLI, build in development mode which enables watch on the files and incrementally recompiles as needed. This is faster than a prodcution build. Additionally, this unminified build is compatible with the Vue DevTools extension for Chrome for debugging and object inspection.
npm run dev
After the build is completed and watch is running, reload the page. Submit a new post to make sure it is working and gets added to the list.
Edit / Add Posts
In the markup that lists posts, the titles link contains a @click='editPost(post)
attribute to call the editPost
method passing it the post object. Insert the editPost
method to accept the post object from the list and set the properties of the data model. Since this is a simple proof of concept, we are not comparing the post against the version on the server to make sure it is hasn’t been modified since the last fetch. Note that the heading property is being set as well to display the appropriate text.
...
methods: {
editPost( post ) {
this.heading = 'Edit Post'
this.post_id = post.id
this.post_title = post.title.rendered
this.post_content = post.content.rendered
},
...
}
When you save the changes to the App.vue file, the watch detects the changes and incrementally rebuilds the code. Refresh the browser, select a post from the list and verify that it is working as expected.
We need a way to Submit New Post without reloading the page. Add this markup to the bottom of the form
under the submit
input so we have a link that will call a newPost
method.
...
<span v-if="post_id">
<a href="#" @click="newPost">New Post</a>
</span>
</form>
Insert the newPost
method to reset the post and heading properties to their default values.
...
methods: {
newPost() {
this.heading = 'Submit New Post'
this.post_id = null
this.post_title = null
this.post_content = null
},
...
}
In most cases, we should reset the form after fetching posts. Insert a call to newPosts
inside the ajax callback function right after the posts object is populated with the response
.
...
methods: {
getPosts () {
...
.done( $.proxy( function( response ) {
this.loading = false;
this.posts = response;
this.newPost();
}, this ))
...
}
Delete Posts
Insert this link markup in the list item element after the post title link.
...
<a href="#" @click='delPost(post)' title="DELETE">[–]</a>
</li>
Lastly, insert the delPosts
method.
...
methods: {
delPost( post ) {
$.ajax({
method: "DELETE",
url: wp_api_vuejs_poc.rest_url + 'wp/v2/posts/' + post.id,
beforeSend: function ( xhr ) {
xhr.setRequestHeader( 'X-WP-Nonce', wp_api_vuejs_poc.nonce );
}
})
.done( $.proxy( function() {
this.getPosts();
}, this ))
.fail( $.proxy( function( response ) {
console.log( response );
}, this ));
},
...
}