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!

Download

You can use Options->YARQ to change the display format, and Manage->Quotes to add, edit and delete the quotes. If my changes ever make it to the trunk I’ll stop distributing it here and just link to the main version. If Frank van der Brink ever reads this, get in contact with me at tech [at] einaregilsson.com and I’ll send you the patch for my changes.

I’ve been searching the web a bit for a way to make pretty permalinks work correctly on this site. The site is hosted on IIS so using mod_rewrite won’t work, and it’s on a shared server so the option of installing a mod_rewrite alternative for IIS won’t work either. I could get away with having almost pretty urls, with a index.php in them, like this: http://einaregilsson.com/index.php/2007/07/30/pretty-wordpress-permalinks-on-iis/ but I didn’t like it.

The Using Permalinks section on the WordPress page has a lot of info on this and it links to one solution that uses custom 404 pages to make this work but unfortunately I don’t think it’s a very good solution at all. What it does is parse the url from the 404 string, then re-implement all the rewrite url matching itself, make its own http request to the correct url, then write the data from that request into the response. It’s a good effort but it’s duplicating functionality already in WordPress and making a new http request for every page hit which I don’t like. After searching around some more I found another 404 page solution that is very simple and elegant. All you have to do is create a 404 page and put the following 4 lines in it:

<?php
$qs = $_SERVER['QUERY_STRING'];
$pos = strrpos($qs, '://');
$pos = strpos($qs, '/', $pos + 4);
$_SERVER['REQUEST_URI'] = substr($qs, $pos);
$_SERVER['PATH_INFO'] = $_SERVER['REQUEST_URI'];
include('index.php');
?>

All this does is fix the REQUEST_URI and PATH_INFO variables and then include index.php, so WordPress will do the rest. It’s simple, it doesn’t duplicate functionality already in WordPress and it doesn’t have the overhead of another http request for every page hit. The installation steps are:

1. Create the file wp-404-handler.php in your base WordPress folder. (you can also download it here).
2. Set your sites 404 page to point to the wp-404-handler.php url. Most control panels at web hosts allow you to do this. If you’ve got the option to select between FILE and URL then choose URL.
3. Go to Options -> Permalinks in your WordPress admin page, and choose an appropriate structure for your links. I chose Custom with this pattern:

   /%year%/%monthnum%/%day%/%postname%/ 

4. Enjoy!

Now, you can manually enter the post-slug when you write a post, but I don’t wanna have to do that every time I post, so I dug around the WordPress code and found the replacement function. It’s called remove_accents and is in the file wp-includes/formatting.php. There, right before the line ‘// Decompositions for Latin Extended-A’ I added the following code:

    chr(195).chr(144) => 'D', chr(195).chr(176) => 'd',
    chr(195).chr(158) => 'TH',chr(195).chr(190) => 'th',
    chr(195).chr(134) => 'AE',chr(195).chr(166) => 'ae',

Now the characters are replaced automatically like this: Ð => D, ð => d, Þ => TH, þ => th, Æ => AE, æ => ae. I don’t know if everyone has this problem, or if it just has to do with the character set settings on my webhost but this works great for me. No more manually fixing page slugs! I’m gonna create a bug report with WordPress and hopefully this will be accepted into the next version.

Few words in icelandic to help people find this post : Íslenskir stafir í wordpress linkum post slug permalink permalinks

Update 02.08.2007: Just found out that there’s already a plugin that does the same thing, and it doesn’t require you to mess with your WordPress files. You can get it at http://wordpress.is/saekja/ibaetur/iceslugs.tar .

Update 13.08.2007: I made a patch for this and submitted it to WordPress. The changes should come in WP 2.3. The patch is on ticket #4739 .