WP-RESTful WordPress Plugin


I’m 99% sure that you already heard about APIs or REST APIs, it’s what Twitter, flickr and a lot more companies use to share they’re resources with a consumer.
A consumer can be anything from a website (for example, showing your Twitter updates on your blog or personal website) to a desktop / mobile application (iPhone, Android, Windows Mobile, …).
This is possible because all information sent to and from the API is encoded in either two common, inter-platform language, XML and JSON.
The difference between a regular API and a REST API is on the way they work. A REST API requires two entities to work, a client and a server.

Download WP-RESTful (Version 0.1)

Download WP-RESTful Users Plugin (Version 0.1)

Download WP-RESTful Categories Plugin (Version 0.1)

Download WP-RESTful Tags Plugin (Version 0.1)

Follow me for real-time updates


How does it work?

WP-RESTful uses OAuth, a widely, commonly and open source API implementation used all over the World (Wide Web).
The way it work is fairly simple.

First a Consumer registers with a Server. At this point the Server will provide the Consumer with 2 tokens, a public and a private token. The public token will be used to communicate and identify the Consumer with the Server while the private token will be stored locally for security and integrity reasons.
After this the Consumer will request the Server with a Request Token. This Request Token will be used to initiate the Authentication Protocol in where the Consumer will be required to authorize the Server.
The Server will create 2 new token (definitive tokens). They will be our authentication tokens.

I know this sounds and seems complicated but you won’t need to do anything as the Plugin will do almost everything for you (Registration and Authentication process are manual).

Plugin features

  • Add new Plugins to API Plugin to extend functionalities to any way you want/need. (See next group)
  • Fully manageable Client and Server side.
  • Ability to choose what fields are allowed to be returned to the consumer.
  • Ability to restrict modules to OAuth authentication process or liberated them and make them open.
  • Load balance system where you can specify how many requests a given consumer is allowed in a 60 minute timeframe.
  • Out of the box Post and Comments management.
  • And much more…


As stated on “Plugin Features” you have the ability to develop and/or add new modules to your REST API. This means, for example, if you use a plugin like WP E-Commerce, you can develop a plugin for the REST API in order to provide support for WP E-Commerce resources.
The way these plugins are developed is very similar to how plugins for WordPress are developed.
You can see this video that explains how plugins work and how you can develop them.


All requirements for the plugin to work properly are addressed by the plugin itself, upon activation. You can see your system status on WP-RESTful link after activation the plugin.

How to install?

This plugin is installed like any other WordPress plugin out there.

  1. First you need to download it from WordPress Plugin Repository.
  2. Upload the contents of the compacted file to your plugin folder on your WordPress installation.
  3. Go to your WordPress Administration page and activate the Plugin (Plugins → Installed → WP-RESTful → Activate)
  4. Create a new page, name it API, set the permalink to /api and set the content as [REST_return] and save the page.
  5. Go to WP-RESTful → WP-RESTful to check your system status.

I need help!

Check these two videos. They will help you starting up.

This post will be updated, if needed, to reflect changes made to the plugin.

Jun 2010
AUTHOR joseairosa


COMMENTS No Comments

BarCampPT Talk


Today I presented a talk at BarCampPT about WordPress and its Plugins. The reactions wore fantastic and I would like to share the presentation documents.

Warning: The presentation was made in Portuguese.

[slideshare id=4418509&doc=apresentacaobarcamppt-100605124633-phpapp02]

Jun 2010
AUTHOR joseairosa


COMMENTS No Comments