This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



Popeye presents images from the WordPress media library in a nice and elegant way within your posts and pages. Use it to save space when displaying a collection of images and offer your users a simple way to show a big version of your images without leaving the page flow.

It is based on Christoph Schuessler’s jQuery.popeye which was designed as an alternative to the often-seen JavaScript image lightbox (see Lightbox 2, Fancybox or Colorbox, just to name a few). In contrast to them it does not employ a modal window to display the large images, thus disrupting the workflow of the user interacting with a webpage, but takes a different approach: not only allows it for browsing all thumbnails as well as the large images in a single image space, it also repects the page flow and stays anchored and rooted in the webpage at all times, thus giving a less disruptive user experience than modal windows.

The plugin is very easy to set up and integrates automatically into your posts or allows you to use a shortcode. It comes with several styles but can be also easily customized to integrate into your blog’s design.


  • This is an example how popeye displays your images within the text using the example-green style.
  • This is another one using example-blue.


  1. Unzip into /wp-content/plugins/popeye
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Choose your insertion mode & style in the ‘Settings’ menu


Is there any integration with NextGEN gallery?

Currently no. But you are very welcome to give me some insight on how the NextGEN gallery works and how I can hook up on their galleries and pictures.

Does it work with PHP4?

Finally, yes.

Contributors & Developers

“wp-popeye” is open source software. The following people have contributed to this plugin.


Translate “wp-popeye” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • added [nopopeye] shortcode to suppress the automated insertion of popeye into every post for this specific post


  • added navigation display mode (hover or permanent) as an option in the wordpress backend settings
  • removed a bug: ppy could not display when using shortcodes due to a missing class-attribute set to ppy
  • thanks to Raoni Del Persio from for giving feedback!


  • allow custom order of images
  • added include & exclude attributes for inclusion or removal of specific image ids
  • checked wp 3.0 compatibility
  • added some simple usage help
  • thanks to Raoni Del Persio from for sponsoring this release!


  • replaced jQuery.popeye with current version 2.0.4
  • now uses the description of an image as it’s caption (or the caption as until now when the description is empty)
  • solved the “only 5 pics” issue – see here:
  • now orders the images by title descending so you can edit the order by renaming the images (e.g. 10_bla, 11_blup, 12_foo, etc.)


  • script is now PHP4 compatible
  • replaced jQuery.popeye with current version 2.0.3, solves some IE6 issues
  • added some links to the ‘Manage Plugins’ page of wp-admin
  • fixed the “Enlarged size” dropdown on the settings page which jumped to “Large” when the current selection was “Original”