November 2009 Posts
404 Errors When Integrating Zenphoto With WordPress
The Problem
In my previous post, 'A Basic WordPress And Zenphoto Integration', I noted that my Zenphoto integration had a problem with silent 404 errors. Although the pages of the gallery were being displayed nicely skinned with my WordPress theme and everything looked okay, behind the scenes they were being delivered to the browser with a HTTP status of 404, "not found". Obviously this is a very bad thing, as once I manage to get search engines indexing my site they would see the 404 and assume that the pages were not available, ignoring the fact that the content was actually there.
The Details
Some comments on the original post that I used to aid my integration suggested that this was being caused by the URL rewriting used by both WordPress and Zenphoto. Taking this lead, I did a few simple tests to narrow the location of the problem. First I disable the URL rewriting in Zenphoto. No change. Second, I disabled the URL rewriting in WordPress. Bingo; the gallery pages were now being served with a HTTP status of 200, but now my WordPress URLs were decidedly less than friendly.
Time for a bit of digging into how WordPress handles URL rewriting. Actually, not much digging was needed in this case. As the gallery is located in a sub-folder under the WordPress installation, I figured all that was needed was to make WordPress ignore this entire sub-folder when it comes to parsing rewritten URLs. This led me to 'WP_Rewrite' in the WordPress Codex. This class, defined in wp-includes/rewrite.php, handles all of the URL rewriting rules used by WordPress.
A Basic WordPress And Zenphoto Integration
Having installed both WordPress and Zenphoto, it is now time to see how to integrate the two. A bit of searching through the WordPress Plugin Directory and quick session on Google led me to the work of three people that would help me to accomplish a pretty damn good integration.
ZenphotoPress
The first step was to install the ZenphotoPress plugin by Alessandro Morandi found in the WordPress Plugin Directory. This awesome plugin provides shortcode support and a dialog in the WordPress editor for inserting images from Zenphoto directly into posts and pages. For example, here are a few shots I took at a big cats workshop back in March 2009:
The plugin gives a variety of options when inserting, such as whether to insert the image, it's textual name or custom link text. You can choose whether to link to the album, the individual picture page, a custom URL or even no link at all. Other options include such things as text wrapping and image size. In the example above, I have opted for thumbnail sized images linking to the main gallery page.