Ready to get started?Download WordPress

Plugin Directory


Onebox: A Fancy Hyperlink Display Plugin for WordPress

Plugin home page

What does this plugin do?

This plugin lets you use a shortcode [onebox url="http://example.com" title="optional title" description="optional description"] in place of a link that will display a lovely Facebook/Twitter-style box with additional information about the link.

WordPress has built-in support for some links like Google+ or Twitter, where it will generate a nice-looking embed from a link or shortcode, but what about other sites? Onebox aims to let you turn any link into an embedded box, with extra features for some special sites, and with a fully customisable HTML template.

How does the plugin work?

Many webpages now have metadata in their header with a description and image to help sites like Twitter or Facebook generate embeds. Onebox can read this same data to generate similar embeds. In addition, the plugin makes use of a number of "parsers" to scan for specific sites and pull out even more data to use.

Where can I see it in action?

A demo site is set up at http://onebox.surrealroad.com

The source is maintained on GitHub: https://github.com/surrealroad/wp-onebox


The following modules are optional, but highly recommended: * APC extension for PHP * GeoIP extension for PHP

Currently supported sites
  • Any web page with Twitter metadata
  • Any web page with Facebook (OpenGraph) metadata
  • GitHub (github.com)
  • Steam (store.steampowered.com)
  • iTunes (itunes.com)*
  • GOG (gog.com)*
  • Mac Game Store (macgamestore.com)*
  • Green Man Gaming (greenmangaming.com)*
  • Origin (origin.com)*
  • Lynda (lynda.com)*
  • Wikipedia (wikipedia.org)
  • Google Play Store (play.google.com)
  • Kickstarter (kickstarter.com)
  • Final Fantasy XIV: A Realm Reborn (FFXIV ARR) Database (xivdb.com)
  • Ebay (ebay.com)*

others to follow

(* site uses affiliate links)


This plugin renders affiliate links for some websites in order to support its development. You are more than welcome to fork or modify the source if you don't want to allow this.

TODO: * Comply with WordPress security guidelines * Add more parsers

Additional credits * Inspired by the "Onebox" ruby gem (https://github.com/dysania/onebox) * Open Graph Protocol helper for PHP * Amazon ECS PHP Library * forceutf8 * html5lib - php flavour * Vanilla template based on "Facebook Notify Widget" by Pixels Daily and GitHub-jQuery-Repo-Widget * Flat template based on "FlatPad" by Repix Design * PHPQuery * Icons by Symbly

Compatible up to: 3.9.2
Last Updated: 2014-4-29
Downloads: 672


4 stars
4 out of 5 stars


2 of 2 support threads in the last two months have been resolved.

Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.