I’m no longer updating or supporting Photopress! Please try Photopress2, which adds an album and random image function that works with the WordPress Media Library.

Photopress is a plugin that adds a set of helper tools to WordPress to make working with images easier. It adds a pop-up uploader and a pop-up image browser to the posting page, a groovy random image function for your template, and a simple album to display the photos you’ve uploaded. Photopress is not really necessary now that WordPress includes pretty good image uploading tools, but I still like Photopress better because I get a bit more control than with the built-in uploader, and I think it’s easier to use than the built-in uploader. The latest version has a couple of tools to help migrate Photopress photos into the Media Library.

Latest version:

Previous version:


Photopress is tested to work with the latest production version of WordPress. You must have the GD module for PHP installed and working, but it should let you know if you don’t. You’re likely to have issues getting permalinks working if you are on something other than *nix + Apache. If something isn’t working, please try refreshing your WP permalinks.


To install, download and extract the archive in your WordPress plugins folder, or make a folder called “photopress” in your plugins folder and upload the files. Create a folder called “photos” in your wp-content folder and make it writable. Activate the plugin. A new table will be created in your database to store image information. If you used a previous version of Photopress your table will be modified if necessary, and your data should be imported. Configure the plugin at the Settings:Photopress admin page. There is information there about what each option does.

If you choose to use the album feature, create a new page which includes <!--photopress_album--> (use the HTML editor so the Visual editor doesn’t mess things up) and tell Photopress the slug name of the page at Settings:Photopress. If you enable permalinks and are using the album, make sure to update your permalink structure at Settings:Permalinks.

To upload images, click the new button at the end of your toolbar. Photopress saves information you enter about your images during upload in a table in your database. The information is used in the album and for alt and title text. You can edit the information at Tools:Photopress. To create a new category just give an image one that doesn’t exist yet. You can also rename categories and category slugs at Tools:Photopress.

Random Images:

By default the plugin inserts a link to the album and a random image in the sidebar at the bottom of the Meta list, but you can change that in the options. To insert a random image in a different spot, add < ?php pp_random_image_bare(); ?> to your template (I like to put it at the top of sidebar.php in the default theme). By default it will have the CSS class “centered,” but you can change that at Settings:Photopress. You can feed the function some options. Here’s a list:


Remember to test for the template function like this:

if (function_exists('pp_random_image_bare'))

Then your blog doesn’t break if you disable Photopress.

The included widget lets you do all this without dirtying your hands with PHP.

Customizing the Album:

The album may not look very good with your theme at first – it might not even work at all. To fix it, make sure the template file specified at Settings:Photopress exists. The default is page.php, which is included with the default WordPress theme. You may wish to modify page.php to remove the “edit this page” code – you can name your template something like photos.php and let Photopress know about it on the settings page. To change the colors and layout, modify pp_album_css.php. You can keep the customized file in your theme’s folder – Photopress will find it there and you won’t have to worry about writing over it during an upgrade.


Photopress uses code from all over the place. Florian Jung’s Image Browser plugin was the inspiration for the popup tool’s image browser. Alex King’s JS Quicktags (via the ContactForm plugin) added buttons to the toolbar for a while, but now Owen Winkler’s buttonsnap library is doing the job. The built-in WordPress upload functions, along with the excellent, gave shape to the uploader. The WordPress Codex has been invaluable. Many people have contributed bug reports, fixes and suggestions, including Randy, RobotDan, Alex, Jono, Paula, Frank, Roge, SHRIKEE, Hans, Marcus, and Claus. I appreciate your help!

Known issues and possible fixes:

  • Broken album: If you’re getting a “file not found” error when you try to view the album it’s probably because you need to update your permalinks at Settings:Permalinks.
  • Broken blog layout: Using the alignleft and alignright classes for images in posts may break your blog layout. They’re apparently intended to be used for images in paragraphs of text. Use centered or a custom class when posting images without (much) text.
  • Missing options: see this post for details, but you really should just upgrade WordPress.
  • Broken button: a weird browser problem… try enabling the ‘failsafe button’ at Settings:Photopress – it appears below the posting area but should work with old, clunky browsers.
  • Broken album layout: edit pp_album.php and pp_album_css.php, in the photopress folder, to match your theme (look at your theme’s index.php for inspiration). You can save the files in your theme’s folder to avoid overwriting when upgrading (PP looks there first, then reverts to the default).
  • Bad paths and/or addresses: the plugin tries to guess the right paths and addresses, but it sometimes fails – you can set the paths and addresses manually at Settings:Photopress.

43 Responses to Photopress

  1. Pingback: His Story » Blog Archive » The Wordpress Plugins I am Using

  2. Pingback: Clint’s TiddlyWiki Thoughts » Nifty Wordpress Plugins

  3. Pingback: The Unlawyer » Blog Archive » Another Added Attraction - Updated

  4. Pingback: Neil’s General Blog » Blog Archive » This site

  5. Pingback: Hercos » Nueva galeria

  6. Pingback: » Miner Changes

  7. Pingback: » Blog Archive » I have not been slacking off …

  8. Pingback: SHRIKEEs Overrated Trash of High Quality data » Blog Archive » Current plugins used on this site

  9. Pingback: Global Advanced Media WeBlog » Testing Wordpress Photo Plugin

  10. Pingback: » NEW PORTFOLIO (and sketchbook uploaded!)

  11. Pingback: The iSYS Weblog » Archive du blog » Ok, Now I’m trying it in Firefox

  12. Pingback: Vanilla Journal » Blog Archive » Welcome 2006

  13. Pingback: La otra bola de cristal » Blog Archive » Wordpress 2.0

  14. Pingback: w.y.06

  15. Pingback: WordPressã?§ãƒ?イライトå¼?サムãƒ?イル一発生æˆ? — OpenStratus Archive

  16. Pingback: Roge Photo Home - Wordpress 2.0, Photopress, redesign

  17. Pingback: familypress-dot-net » Blog Archive » Photopress 0.9

  18. Pingback: familypress-dot-net » Blog Archive » Photopress 0.9.2

  19. Pingback: Minds Eye » Blog Archive » Testing new plugin with larger pics

  20. Pingback: marcus’ tagebuch » PhotoPress Plugin erweitert

  21. Pingback: Raúl Vera » Blog Archive » Los plugins adoptados

  22. Pingback: JoaoVagner » Nova Galeria.

  23. Pingback: Gutermann Net » Blog Archive » WordPress Photogallerie

  24. Pingback: Blog of a crazy man » Blog Archive » Reintroducing Photos

  25. Pingback: caramel*vanilla » Blog Archive » WordPressã?§Lightboxを超簡å?˜ã?«ä½¿ã?£ã?¦ã?¿ã‚‹

  26. Pingback: familypress-dot-net » Blog Archive » Photopress 0.9.4

  27. Pingback: » Photopress Plugin

  28. Pingback: The White Blog - The Personal Weblog of Oliver White » Erm, stuff: Part II

  29. Pingback: » Gallerian paluu

  30. Pingback: Oldstone Place » Cool WordPress Plugins

  31. Pingback: Materie » Images plaatsen gelukt

  32. Pingback: Really Bad Eggs »

  33. Pingback: Really Bad Eggs » Photoblogging with Wordpress: in my own words

  34. Pingback: This is » Photopress/Lightbox Patch

  35. Pingback: The House of Yo » Photopress Working!

  36. Pingback: Raining Updates: Ads on RCG, Contributing Update, Footer Candy, New Feed, Email Tools, the HUGE list of RCG plugins and more! | Rain City Guide

  37. Pingback: Images, thumbnails and custom fields in WordPress | Wordpress Garage

  38. shadow says:

    hello, well my idea is to change the position in which these two images are displayed, I want to show the side and not down.

    If anyone knows … I could say which part I modified to show me in that position?
    I have plugins: photopress 1.5.2 and photopress widget
    WordPress version: 2.7.1

    greetings, do a great job I congratulate you.

  39. Pingback: Portal FIMES

  40. Renato says:

    Nice job on the plugin! It works pretty well.

    I’ve noticed that there was no translation available for Brazilian Portuguese so i took the liberty and extracted the strings and translated them to pt_BR.
    Also i had to make a small change to the include.php file to allow WordPress to load the language file correctly.

    The .mo and .po can be found here:

    and the patch to the include.php here:

  41. raoul says:

    with php 5.3 i get some errors:


    • isaac says:

      Thanks for the report – I’ll investigate further. It looks like the error has something to do with the album, so if you’re trying to use the migration tools in the latest version (1.8) those should still work.

  42. LordPan says:

    I stiull have problems with the album – page not found.
    I use WordPress 3.0 and tried differend Permalinks options, but you never specify what is the best option to use with PhotoPress

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>