wpIdentity

A package that implements OAuth identity and a simple verb set with wordpress.com for Node.js apps.

It's used in FeedLand for WordPress identity and it's the complete backend for WordLand.

In October 2024, I wrote a brief doc about the history of wpIdentity, its purpose, where it came from, how to explore.

It works

You can try it out here.

You can log on, and see a list of your sites, when each was created and modified.

Here's a screen shot.

How to set up a server

1. Download the folder.

2. Throw away everything but the shell folder. In the shell folder you can throw away source.opml.

3. Move the shell folder to your server.

4. Edit the config.json file with the credentials you got from WordPress.com.

5. npm install

6. node wpidentity.js

7. If you want to use the storage feature, you'll need to set up the database.

Check out worknotes

I've been narrating my work in the worknotes.

Demo apps

There's a very simple demo app in the client folder here.

In November 2025 I wrote a simple editor that works through wpIdentity.

• This is code you can copy if you have an editor and want to configure it to work alongside WordLand.

• You can also try out the editor here.

Automattic docs

These docs proved useful at different points in this project.

• https://github.com/Automattic/wpcom.js/tree/master/docs -- docs for the routines we call

• https://developer.wordpress.com/apps/

• https://developer.wordpress.com/docs/oauth2/

• https://github.com/Automattic/node-wpcom-oauth

• https://github.com/Automattic/wp-calypso

• https://github.com/Automattic/wp-calypso/tree/trunk/packages/wpcom.js

• https://github.com/Automattic/wp-calypso/tree/trunk/packages/wpcom.js/docs

• https://github.com/Automattic/wpcom-connect-examples

Other pointers

I am using this site for testing. https://daveverse.org/.