The program is ONLY meant for uploading albums for the first time, not for working with albums once they are uploaded. The main features of the program are:

• Create new albums (with descriptions) and upload images (obviously)
• Resize photos before uploading
• Rotate photos
• Order photos in album
• Remove photos from album and optionally delete the file itself
• Save titles and descriptions for photos
• Keyboard shortcuts for almost all actions

The program is very much “me-ware”. I made it to scratch my own itch, it may not fit or feel right to anyone else. It was thrown together and is fixed as I run into bugs while using it. It may well contain errors and might crash horribly. That said, everyone is welcome to use it and improve upon it if they wish. Just know that you are using this at your own risk. I cannot be held liable for any damages or problems this program may cause. It contains commands that you can use to delete photos from your hard disk, use it carefully and think about what you are doing.

Probably my favorite feature of the program is the ability to do everything from the keyboard. The available shortcuts are:

• CTRL+U: Open the upload dialog
• CTRL+UP, CTRL+DOWN: Move to previous/next photo even though the listbox is not selected
• CTRL+SHIFT+UP, CTRL+SHIFT+DOWN: Move a photo higher or lower in the list
• CTRL+T: Give focus to the Title textbox
• CTRL+D: Give focus to the Description textbox
• CTRL+LEFT, CTRL+RIGHT: Rotate the currently selected photo
• DEL: Remove or delete the currently selected photo. There is a confirmation dialog that asks if you want to remove the photo from the album, or delete the photo. Do not choose “delete” unless you really want to delete the photo from your hard disk forever!

You can download the source here, it is licensed under the GPL v3.0. It is written in C# and requires .NET 3.5 to compile. There is a build.bat file in the root folder that can be used to build the program.

Finally, you can DOWNLOAD ZenPhotoUploader here, it is a single executable, no dependencies other than the .NET framework 2.0 or higher. The only version of ZenPhoto I’ve tested it against is v1.2.2, others may not work. Enjoy, and let me know if you have any problems with it.

1. Edit the file auth_zp.php under the zen folder in your ZenPhoto installation, throw away everything in the file, and replace it with this:

<?php
require_once("functions-db.php");

$wp_include = "../wp-config.php";
$i = 0;
while (!file_exists($wp_include) && $i++ < 10) {
  $wp_include = "../$wp_include";
}
require_once($wp_include);

function zp_loggedin() {
  //Only considered logged in if it's someone with more rights
  //than a Subscriber
  return is_user_logged_in() && wp_get_current_user()->user_level >= 2;
}

if (isset($_GET["logout"]) || isset($_POST["logout"])) {
  header("Location: " . get_option("siteurl")
       . "/wp-login.php?action=logout");
  exit();
}

?>;

This technique assumes that your Zenphoto folder is a subfolder of your WordPress folder. Like here, my WordPress install is at http://einaregilsson.com/ and my Zenphoto install is at http://einaregilsson.com/photos/. It can be at most 10 levels deep in the folder hierarchy under WordPress, but it MUST be under the WP folder.

2. Edit the admin-function.php file thats also under the zen folder in your ZenPhoto installation. Find the function printLoginForm and replace it with this:

function printLoginForm($redirect="/zen/admin.php") {
  if (is_user_logged_in() && wp_get_current_user()->user_level == 0) {
    //User is logged in as Subscriber

    $logoutUrl = get_option('siteurl') . "/wp-login.php?action=logout";
    echo "<p><img src=\"../zen/images/zen-logo.gif\" title=\"Zen Photo\" /></p>";

    echo "\\n  <div id=\"loginform\">";
    echo "<div class=\"errorbox\" id=\"message\">"
       . "<h2>Error: Insufficient privileges.</h2>"
       . "You are currently logged into WordPress as a <strong>Subscriber</strong>. "
       . "Subscribers can't access ZenPhoto Administration. In order to do "
       . "so you must <a href=\"$logoutUrl\">log out of WordPress</a> and "
       . "then log in again with an account that has more rights."
       . "</div>";
    echo "\\n</body>";
    echo "\\n</html>";
  } else {
    $redirect = WEBPATH . $redirect;
    header("Location: ".get_option('siteurl')."/wp-login.php?redirect_to=$redirect");
    exit();
  }
}

The only tricky thing here was dealing with WordPress users that only have Subscriber rights. Subscribers shouldn’t be able to administer ZenPhoto of course, but I didn’t want to log them out automatically or anything. So I added a special case for them, if a Subscriber tries to access ZenPhoto Administration he will get an error message saying he needs to log in with higher privileges and link to log out of WordPress. If you already have the basic ZenPhoto integration working then you’ll have the ZenPhoto link in your WordPress admin pages. Subscribers however won’t see this link, it will only be shown to users with a role of Contributor or higher.

And that’s it. Now I have my photos using my WordPress theme, I can edit them in my WordPress admin, I have a link to the ZenPhoto admin and I can use WordPress authentication. The integration is complete .

His method works great but there were a few things that bugged me about it. First, my ZenPhoto javascript didn’t work with it, so the inline editing of album descriptions didn’t work. Also I wanted to be able to edit my ZenPhoto theme files in the WordPress theme editor. I tweak my theme all the time and I thought it would be much more convenient to be able to do it all in one place. So I figured out a way to make it work. Steffen gets full credit for coming up with the method, my contribution is simply making the javascript and theme editor work correctly, creating a link to the ZenPhoto admin interface from the WordPress admin interface and packing it all up in a zip file with easy installation instructions. I won’t explain all the code here, it’s done quite nicely in Steffens article but for those interested in the implementation it’s basically this:

1. Make the files in the ZenPhoto theme basically do nothing but include zp-index, zp-image and zp-album from the current WordPress theme folder. This allows us to edit the theme using the WordPress theme editor.
2. Add hooks in WordPress so the ZenPhoto stylesheet will be included in the <head> element of the page.
3. Add hooks in WordPress so the zenJavascript function from ZenPhoto is called on the pages, so the inline editing will work (see head.php for this).
4. Create a small WordPress plugin that creates a link to ZenPhoto from the WordPress admin interface, and gives the zp files pretty names in the WordPress theme editor (‘ZenPhoto Index’ for zp-index.php, ‘ZenPhoto Image’ for zp-image.php etc.).

For those that just want to get it working, here are the installation instructions:

1. Download the zip file and unzip.
2. Copy the wordpress-integration-zp-theme folder into your zenphoto/themes folder.
3. Go to your ZenPhoto admin web, choose Options and activate the theme called ‘WordPress Integration Theme’.
4. Copy the files (zp-index.php, zp-image.php, zp-album.php, zp-style.css) from the wordpress-theme-files folder into your current WordPress theme folder, /wp-content/themes/yourthemename.
5. Copy the zen-integration.php file into your WordPress plugin folder, /wp-content/plugins .
6. Goto your WordPress admin interface, choose Plugins, and activate the ‘Zen Integration’ plugin. Note that the plugin assumes that your zenphoto folder is directly below your WordPress folder and is called ‘zenphoto’, ‘photos’ or ‘gallery’. If it’s not, and you want to get the ZenPhoto link from the WordPress admin interface working you’ll need to edit the zen-integration.php file, find this line:

   $zp_admin_url = ''

   And change it to the full url of your ZenPhoto admin page, e.g.

   $zp_admin_url = 'http://example.com/foo/bar/zenphoto/zen/admin.php'

7. There is no step 7, you’re done!

Now you should be able to go to your WordPress theme editor and see the files ‘ZenPhoto Index’, ‘ZenPhoto Album’, ‘ZenPhoto Image’ and ‘ZenPhoto Stylesheet’ and you can edit them right there. The files included in the zipfile are meant to be used with the default WordPress theme, Kubrick, and will probably not look very good on any other theme. It’s the simplest thing I could come up with, I mostly just changed the default ZenPhoto theme a bit. You should change it to fit your current WordPress theme. In the files, the ZenPhoto part is always wrapped in a <div id=”zenphoto”>, and the ZenPhoto stylesheet prefixes everything with #zenphoto, this is so your ZenPhoto stylesheet won’t start affecting other parts of your blog.

So, that’s it I think . You can download the zip file with all the needed file here, let me know if you have any problems with it. You can view it in action at http://einaregilsson.com/photos (Yes, I know it’s the same picture over and over, it’s just for demonstration purposes ).

UPDATE 01.09.2007: Fixed bug where error message didn’t appear when comment was invalid on an image page.
UPDATE 02.09.2007: …and now I fixed the fix, because it was displaying the error message even if there was no error!