New plugin: Document Feedback

Document Feedback is a new WordPress plugin to close the loop between documentation writers and readers.

By default, it appends a simple prompt to the bottom of every Page:

Document Feedback prompt

If a reader responds to the prompt, they’re given a follow-up question to clarify their response. Readers must be logged in for the prompt to show up.

Comments are emailed to the post author and summarized in a post meta box:

Post meta box of feedback

Many thanks to Mario Peshev for his random hacks of kindness. I started this plugin a year ago and left it half-finished on Github. Then Mario comes along, submits a couple very substantial pull requests, and kicks me in the pants to release it.

Join the fun on Github or use the WordPress.org forums for questions / bug reports. This plugin is already live for the WordPress.com VIP documentation portal, and is available for use by VIP and Enterprise clients.

P2 Resolved Posts v0.3: Register your own post states

P2 Resolved Posts is a nifty plugin we use at Automattic, in conjunction with the stellar P2 theme, to help better ensure decisions aren’t left hanging and things get done. This third release of the plugin allows you to register your own custom post states.

For instance, if I wanted to have a post “Waiting Review” before it was marked unresolved, I could add something like the following to my theme’s functions.php:

P2ResolvedPosts()->add_state( 'waiting-review', 'Waiting Review', array( 'before' => 'unresolved' ) );

The third argument is the position of the state. It can be ‘first’ or ‘last’, or ‘before’ => ‘state’ or ‘after’ => ‘state’.

Alternatively, you can remove a state if you no longer find it useful.

Getting this feature out the door required a fair amount of refactoring. It’s been running stable on WordPress.com for a couple of weeks — the most awesome way to beta test. Feel free to post any feedback, issues, feature requests, etc. in the WordPress.org forums. You can also fork the plugin on Github.

IRC channels for all my plugins

Well, the big ones at least. I recently “discovered” you can create arbitrary rooms on Freenode. Given how much I love Automattic’s IRC backchannels, I decided to create a few rooms for the plugins I work on on the off-chance they make it easier to answer quick questions, discuss feature requests, etc.

If you like #editflow, #coauthorsplus, #adcodemanager, or #supportflow, feel free to join me.

VIP plugin idea: Tips inbox

Quick plugin idea from a conversation with Scott from Grist: use Post By Email available on WordPress.com to funnel press releases, story ideas, etc. into the dashboard.

Upon importing, these would be saved to a custom post type that allows you to comment on the pitch, indicate that you’re working on the story, or punt it far, far away.

Seems like a fun hack to me.

Idea: the 30 day challenge (plugin)

Leah just posted a challenge:

Of course I instantly thought: why isn’t there a plugin for this? It would give you prompts on what to write about, possibly based on your previous posts, and reward you for a job well-done (meeting your word count, etc.). A bit like Plinky but built into your dashboard.

Maybe this will be my afternoon hack for Dev Day tomorrow…