Pocket WP

Pocket WP allows you to embed your Pocket links into a WordPress page or post via a shortcode or a widget.

Download from WordPress Plugin Directory

View a demo or read blog posts

I would love feedback and feature requests! Let me know on Twitter

Description

Pocket WP connects to the Pocket API and pulls in your latest saved links with tags and excerpts into a WordPress page, post or widget.

Setup

Due to the way Pocket’s API works, you need to complete a few steps before you can use the plugin.

  1. Install and activate the plugin.
  2. Create an application on the Pocket Developers website, enter your Consumer Key into the Pocket WP settings page and click Save Changes to start the authorization process.
  3. Click the Get Access Key link to complete the authorization.

Shortcode

The shortcode embeds a list of Pocket links into a page or post.

The basic shortcode is [ pocket_links ] (without spaces) and it accepts some optional arguments:

1
2
3
4
5
count: [any number] // How many links to display. Default is all.
excerpt: yes, no // Whether or not to display the excerpt extracted by Pocket. Default is yes.
tag: [any one of your Pocket tags] // Choose to show links from one tag. Supports one tag only. Default is all links, tagged or untagged.
credit: yes, no // Choose to add author credit. Default is to not show credit links.
tag_list: yes, no // Whether or not to show a list of tags after each link.
count: [any number] // How many links to display. Default is all.
excerpt: yes, no // Whether or not to display the excerpt extracted by Pocket. Default is yes.
tag: [any one of your Pocket tags] // Choose to show links from one tag. Supports one tag only. Default is all links, tagged or untagged.
credit: yes, no // Choose to add author credit. Default is to not show credit links.
tag_list: yes, no // Whether or not to show a list of tags after each link.

Widget

The Widget is available to drag and drop into any widgetized sidebars. It has some options:

1
2
3
4
title: // the title for the widget
count: // the number of links to show. Default is 5
tag: [any of your Pocket tags] // Choose to show links from one tag. Currently supports one tag only. Default is all links, tagged or untagged.
author credit: yes, no // Choose to give author credit. Default is to not show credit links.
title: // the title for the widget
count: // the number of links to show. Default is 5
tag: [any of your Pocket tags] // Choose to show links from one tag. Currently supports one tag only. Default is all links, tagged or untagged.
author credit: yes, no // Choose to give author credit. Default is to not show credit links.

Installation

  1. Activate the plugin through the ‘Plugins’ menu in WordPress.
  2. Follow installation instructions on the plugin options page or at the plugin website.

Frequently Asked Questions

None yet… Ask me! me [at] ciaranmahoney [dot] me


Screenshots

Pocket WordPress settings page.
Pocket WordPress settings page.
Screenshot of the widget as it displays in a sidebar.
Screenshot of the widget as it displays in a sidebar.
Screenshot of the widget settings box.
Screenshot of the widget settings box.
Screenshot of the shortcode in the editor.
Screenshot of the shortcode in the editor.
Screenshot of the shortcode as it displays in a page.
Screenshot of the shortcode as it displays in a page.

Changelog

0.4.1

  • Adding error checking on pocket feed retrieval.

0.4

  • Fix so shortcode doesn’t always display above text.
  • Fixing activation message to only show once on first install.

0.3

  • First public release
  • Made author credit opt-in (was opt-out)
  • Code clean up
  • Added settings link in plugin list
  • Added activation notice

0.2

  • Second beta version (not public)
  • Fixed bugs and cleaned up code
  • Removed option to use multiple tags as Pocket didn’t seem to support this

0.1

  • Beta version (not public)

Upgrade Notice