= Photopress =

Tags: images, upload, album

Contributors: isaacwedin

Photopress is a plugin that adds some image-related features to Wordpress. A new button on the toolbar launches a pop-up image uploader and browser which can insert code for tagged thumbnails or full images into posts. In addition, the plugin includes some template functions, a simple photo album, and some management tools.

== Requirements ==

Photopress should work with the current version of WordPress (wordpress.org/download), and may not work with older versions. If in doubt, try upgrading - you really should anyway.

== Credits ==

Photopress uses code from Florian Jung's Image Browser (not anymore, but that certainly inspired the present code), Owen Winkler's buttonsnap.php, the built-in Wordpress upload functions, and much from codex.wordpress.org. Many people have contributed bug reports, fixes and suggestions, including Randy, RobotDan, Alex, Jono, Paula, Frank, Roge, SHRIKEE, Hans, and Claus. I appreciate your help!

== Installation ==

1. Extract the archive into the wp-content/plugins folder on your server, or
FTP the extracted folder and files there.
2. Create a wp-content/photos folder and make it writable by your server (if this doesn't make sense, get help).
3. Customize the appearance of the album by editing pp_album.php and pp_album_css.php in the photopress folder. You can store the customized files in your theme's folder (to prevent overwriting during an upgrade).

== Upgrade ==

1. Deactivate the plugin.
2. Remove all of the old plugin files (retaining your album template files if you modified them).
3. Re-activate the plugin.
4. Check for any new options to configure at Options:Photopress.

== Usage ==

=== Uploading ===

Upload images by clicking the new button on the toolbar. This will launch a popup window with Upload and Browse tabs. Select an image and upload it. Optionally, enter information about the image and/or insert it into your open post. 

=== Browsing ===

The Browse tab browses previously uploaded images. Various sort options are available. Any of your previously uploaded images can be inserted into your open post.

=== Managing ===

Manage your uploaded images at Manage:Photopress. Enter information about images, delete images, and perform a few other maintenance tasks.

=== Random Images ===

To use the random image template function add it where you want the random image(s) in your template. The function has several options:

pp_random_image_bare($number_of_images,$before,$after,$class,$category);

Here are the default options, which will be used if you don't specify anything:

pp_random_image_bare(1,'','<br />','random');

'random' isn't a class but a keyword that will use the random image class from Options. If you leave out the category the function will use all of your images.

=== Album Template ===

The appearance of the album can be customized by editing pp_album.php and
pp_album_css.php. The files have some comments which should help, but you'll
mostly be trying to make pp_album.php look something like your theme's
index.php, and maybe changing the colors in pp_album_css.php to match your
theme. Store the modified files in your theme's folder to avoid overwriting
them during an upgrade.

=== Localization ===

The localization template (the POT file) and any contributed translations (MO files) are available at familypress.net. If you make a translation, please share it. To use a translation, place the MO file in your plugins folder. It should be named photopress-<your locale>.mo, and <your locale> should match what you've got for WPLANG in wp-config.php. If there are untranslated things, it's probably because your MO file is older than your Photopress version. To fix that, get the current PO file for your language from familypress.net and update it.

== Frequently Asked Questions ==

=== Why doesn't the button work!? ===

This is a mystery. The button works fine in various browsers on Linux, and both Firefox and IE in Windows XP. Check your pop-up blocking settings. Let me know if you figure out why it doesn't work! I've added an option to enable a "failsafe" button, which isn't placed well but is more likely to work (for example, I've heard that it works in IE on MacOS 9). I haven't heard any reports of a non-working button lately, so either the problem is fixed or people who had the problem have been driven away.

=== The album breaks my template/theme!? ===

It's designed to work well with the default theme, so if your theme is creative it may break. If so, edit pp_album.php and pp_album_css.php as indicated above.

=== Why add the random image to the Meta list? ===

Because there's a plugin hook in Wordpress to do that. If you don't like that, disable it on the Options:Photopress page and use the random image template function instead as indicated above.

=== I've already got a bunch of images in a folder, how can I add them to Photopress? ===

At Manage:Photopress:Maintain there's a simple import tool. If you put your photos in the photos folder Photopress will resize them and create thumbnails to fit your settings. Check the permissions of your images if something doesn't work.

=== How do I delete an image? ===

Go to Manage:Photopress and click through to an image. Depending on how you've set up Options:Photopress, there could be a delete button or a list of posts that use the image, or both. You can delete multiple images in the Mass View at Manage:Photopress (if you've set the option to do so).

=== Why aren't the Photo Album link and random thumb showing up in Meta? ===

You probably haven't uploaded any images yet, or you need to re-activate the plugin (or use the maintenance tools at Manage:Photopress) to import your existing images.