PhotoQ WordPress Photoblog Plugin v1.2 – Ready for WordPress 2.5

Update: PhotoQ v1.5 is a newer version of the same plugin but offering more features. Please check out and download the new version instead of this one, you won’t regret it.

In a few hours, version 2.5 of WordPress will be released. Here is already an update of the PhotoQ WordPress photoblog plugin which will make it compatible with WordPress 2.5. This is one of the biggest updates PhotoQ has seen so far, so it is recommended to update. For those who don’t know yet, PhotoQ is the WordPress photoblog plugin that makes your photoblogging life easier. It is most suited for “one photo a day”-style web pages i.e., classical photoblogs.

With PhotoQ you can mass upload several photos at the same time thanks to its batch upload functionality. PhotoQ places uploaded photos in a queue which gives you a convenient way to manage photos to be posted. The plugin then gives you the possibility to have the top of the queue automatically posted at a given interval. In short, PhotoQ was designed to automate and simplify your photo posting process as much as possible. It takes away the hassle of browsing uploaded image files and embedding them into posts: You simply upload your photo to the queue and enter desired information about the photo. PhotoQ then automatically generates the post based on this information.

An example of a photoblog running on WordPress and PhotoQ can be found at

Feature List

  • Queue-based photo management
  • Batch upload photos to your photoblog
  • Hassle-free, fully automated posting of photo posts
  • Possibility to add custom metadata to photo posts
  • Automatic thumbnail generation
  • Automatic posting through cronjobs
  • Integrates with Lightbox, Shutter Reloaded and similar libraries/plugins

What’s New

The biggest changes in this version of PhotoQ happened under the hood and are thus only indirectly visible to the end-user. Nevertheless, there are some visible neat new features like, e.g., drag-and-drop queue reordering.

  • Compatible with WordPress 2.5
  • New batch upload script for greater stability
  • Ajax Queue Management
  • Lightbox integration


PhotoQ WordPress Photoblog Plugin - Screenshot “Batch Upload”


PhotoQ is somewhat experimental and I consider it nowhere near of being perfect. Still, I think that PhotoQ can be useful to someone who tries to set up a photoblog with WordPress and that’s why I decided to make it public. However, I take no responsibility of what might happen if you choose to use it: You use PhotoQ at your own risk. On the other hand, do not hesitate to ask questions concerning PhotoQ if you get stuck – I would be glad to help.


PhotoQ 1.2 has been tested successfully under WordPress 2.5 and 2.5.1. Note that due to a change in how WordPress handles categories, you need to update to WordPress 2.5.1 if you want to use PhotoQ versions 1.2.5 and higher. So, if you are running WordPress 2.5, just download PhotoQ 1.2.4 and it will run just fine.

No version of PhotoQ 1.2 runs on any WordPress versions < 2.5 and it never will. If you need to run PhotoQ with WordPress < 2.5, download version 1.1.5b of the plugin. Note however that I stopped developing the 1.1 branch, so there will be no updates in this case.

PhotoQ makes more and more use of JavaScript and Ajax. So I guess, I also have to include a list of tested browser/platform combinations. PhotoQ 1.2 requires a web browser with at least Flash Player 9 installed and has been successfully tested under Firefox 2.0, Firefox 3b and Safari under MacOSX; Firefox 2.0 and IE7 under Windows XP. There is, however, no reason to believe it won’t also work with other common combinations. It would be nice if the first people who test it with other browser/platform combinations could drop me a line or post a short comment. This would allow me to extend this compatibility list.

PhotoQ has been tested with both, PHP4 and PHP5. At the moment PhotoQ only runs on web servers with PHP safe_mode turned off. If your web hosting provider has safe_mode turned on you can try to ask them to turn it of. Most web hosting providers will disable safe_mode for your web page on request.

Version History

  • 15.07.2008 – 1.2.6: Compatible with WordPress 2.6.
  • 06.05.2008 – 1.2.5: Category handling adapted to WordPress 2.5.1. Two new settings to choose default category and author of PhotoQ posts.
  • 22.04.2008 – 1.2.4: Bugs fixed: Problems with filenames containing special characters; Disappearing Media Library update links in Write panel caused by PhotoQ.
  • 16.04.2008 – 1.2.3: Bugs fixed: PHP4 compatibility restored, no more lost settings; Now compatible with localized WP versions, no more “swfu not defined”. Now also compatible with IE7; SWFUpload updated to 2.1.0b2.
  • 04.04.2008 – 1.2.2: Bugs fixed: Ajax queue ordering did not work if dashes present in filenames; Header of queue no long sortable; Correct authentication of Ajax queue manipulations; Cookies no longer sent during Ajax calls.
  • 15.03.2008 – 1.2.1: Fixes a bug that could under some conditions provoke empty width and height attributes
  • 09.03.2008 – 1.2: Compatible with WP 2.5. Migrated batch uploads to SWFUpload 2 for greater stability. Ajax Queue Management. Lightbox Integration. Runs on Reusable Options.
  • 25.11.2007 – 1.1.5b: PhotoQ is now able to truly resize photos. It now also integrates with existing themes more easily because of the new option to directly include the description in the post content. Category display bug when updating queue has been corrected.
  • 07.11.2007 – 1.1.4b: PhotoQ is now again retro-compatible with WordPress versions that do not have built-in tagging support. Only update if you use a WordPress version prior to 2.3.
  • 04.11.2007 – 1.1.3b: PhotoQ now supports WordPress’ native tag handling introduced in WordPress 2.3. Please read this post to see how to import tags from meta fields to the new structure.
  • 20.10.2007 – 1.1.2b: changed require_once statements so that the plugin also runs on web servers that don’t like relative paths in these statements. Update only if you encountered problems with version 1.1.1b.
  • 17.10.2007 – 1.1.1b: “Largest Side” image/thumb-size option is now a “Smallest Side” option. “Largest Side” can still be mimicked by setting both values in the “Maximum Dimensions” option equal to the desired value.
  • 14.10.2007 – 1.1b: first major update. Features mass uploads via SWFUpload. New options for image/thumbnail sizes. Better photo preview in admin section. Enhanced security due to use of wp_nonces. Under the hood, big parts of the code have been restructured.
  • 07.10.2007 – 1.0.2b: patch to make it compatible with WordPress 2.3.
  • 22.01.2007 – 1.0.1b: fixed a bug that caused PhotoQ to handle some paths and urls improperly. Anyone wanting to use PhotoQ should update to this new version.
  • 11.01.2007 – 1.0b: first public release.


  1. Get the latest version of the PhotoQ WordPress Photoblog Plugin (WP 2.6). (PhotoQ for WordPress 2.5.1)
  2. Unzip the downloaded file, you should end up with a folder called “photoq-photoblog-plugin”.
  3. Open this folder, you should see a folder called “whoismanu-photoq” and a file called “wimpq-cronpost.php”.
  4. Upload the “whoismanu-photoq” folder to your “plugin” directory (wp-content/plugins).
  5. If you plan to use the automatic posting capability, save the file “wimpq-cronpost.php” in the same directory as your wp-config.php file.
  6. You now have to create a directory on your web server where temporary image files, corresponding to the photos in your queue, will be stored. By default this is the directory “/wp-content/qdir” (called “qdir” directory from here on).
  7. Make sure that the file permissions of the “qdir” directory are such that the plugin is allowed to write to it (otherwise, uploaded photos cannot be stored).
  8. Once posted, photos are moved from “qdir” to another directory. PhotoQ organizes posted photos by year and month. Photos posted in January 2007 are consequently moved to an automatically generated directory with name “2007_01″. We’ll call the directory that contains these “YYYY_MM” subdirectories “imgdir”. By default “imgdir” equals “/wp-content”. If you want to use some other directory as “imgdir”, you have to create it now.
  9. Make sure that the file permissions of the “imgdir” directory are such that the plugin is allowed to write to it (otherwise, the “YYYY_MM” directories cannot be created and posted photos cannot be moved there from “qdir”).
  10. If your web hosting provider enabled the mod_security Apache module on your web server, you need to add the following directives to your .htaccess file in order for batch uploads to work:
    <IfModule mod_security.c>
    SecFilterEngine Off
    SecFilterScanPOST Off

    See the Troubleshooting section for more information.
  11. You are almost done. Just go to the “Plugins” WordPress admin panel and activate the Photoq plugin.

Using PhotoQ – The Basics

Now that you successfully installed PhotoQ, you are ready to go. First you need to setup some of PhotoQ’s settings:

  1. In the “Settings” panel of the WordPress Administration you should now have a subpanel labeled “PhotoQ”. Go there.
  2. The first two fields tell PhotoQ where to look for the “qdir” and “imgdir” directories. If you did not stick to the default options during installation, you need to specify these directories here.
  3. For now skip the “Meta fields” options
  4. For every uploaded photo, PhotoQ automatically generates a thumbnail. With the “Thumbnail size” option you specify its size. PhotoQ always keeps the proportions of the generated thumbnail the same as in the original photo. To fit in with a wide range of photoblog templates, PhotoQ gives you three possibilities to define the size of the generated thumbnails:
    • “Maximum Dimensions”: you define a rectangle of maximum width and maximum height. Whatever constraint is met first determines the value of the other dimension. You can also use this option to mimic the “Fixed height” or “Fixed width” options of earlier versions of PhotoQ (e.g. to mimic “Fixed height” you can set the “height” to the desired value and the “width” to some huge value such as “99999″. For “Fixed width” you of course do the same but the other way round). The “Largest Side” option of earlier versions can be mimicked by setting “width” = “height” = “Largest Side”.
    • “Smallest Side”: you fix the smallest side of the thumbnail to some value and have PhotoQ adapt the other side
    • “Fixed Width”: you fix a maximal width. If your thumbnails orientation is “landscape”, it will have this width. If your thumbnails orientation is “portrait”, its height will be adjusted such that it matches the height of a photo with “landscape” orientation. Note that this is not the same as “Fixed width” in earlier versions of PhotoQ (check the comment under “Maximum Dimensions” to see how you can mimic the “Fixed width” option of earlier PhotoQ versions).
  5. “Image size” specifies the size in which uploaded photos are shown on your photoblog once they are posted and works essentially the same as “Thumbnail size”. If you check the option “Resize only in web browser”, the actual image file stays untouched i.e., it is not resized. The new image widths and heights are only used as “width” and “height” attributes of the HTML <IMG> tag and resizing is thus left to the web browser. If you don’t check “Resize only in web browser”, PhotoQ resizes the photo according to the “Image size” settings. Last but not least, you have the option to keep the original image size by checking the corresponding checkbox.
  6. If you are all confused now, I suggest that you set “Thumbnail size” to “Fixed height: 80px” and “Image size” to “Keep original image size” for the time being and play with the other options later.
  7. You might want to check “Deleting Posts: Delete image files from server when deleting post”, otherwise the image files associated with a post are left on the server if you delete the post.
  8. “Show thumbs in post management admin panel”: Allows you to see a preview of the photo in the list of already posted posts.
  9. “Enable Batch Uploads”: Allows you to toggle the batch upload capability on and off.
  10. “Include photo description in post content”: If you check this option, the description of the photo is included in the content part of the post, just after the photo. The description is then placed in a <p> tag with class name “photo_description” to allow for easy styling via CSS. If you do not check this option, the description is placed in a custom field with name “descr”. In short: if you do not know how to or do not want to tweak themes, check this option. If you know how to access a custom field from a theme and want greater flexibility, don’t check this option.
  11. “Replace images with image links”: If you check this option, the photo in the post is replaced with a link linking to the original photo but showing the thumbnail. This allows for integration with libraries like Lightbox that show JavaScript pop-up images. Just install, e.g., the Shutter Reloaded plugin, check this option and see what happens. You can specify what special attributes that are needed by the JavaScript library should be added to the link. The default option works for Lightbox and Shutter Reloaded.
  12. Skip the cronjob options for now and you are done. Click on “Update options” to save the changes.

Now comes the fun part, you are ready to manage your photo queue:

  1. In the “Manage” panel of the WordPress Administration you should now have a subpanel labeled “PhotoQ”. Go there.
  2. As you have not yet uploaded any photos the queue is empty. To upload a photo click the button “Add photo to queue”.
  3. I think that the upload process is pretty self-explanatory. If you have batch uploads enabled, click on “Select photos…”. You can then choose several photos (via the standard cmd-click on MacOSX and ctrl-click on Windows) in the “Select Files” dialog box that pops up. The selected photos are queued for mass upload. Once the dialog box is closed, uploading starts automatically. You then have the possibility to add more photos to the upload queue, delete individual photos from the upload queue or clear the entire upload queue. Once the upload is completed you can start entering information on the uploaded photos by clicking on the “Enter Info” button that should have appeared.
    Choose the categories for this photo, add a title, a short description and some tags if you want. If the title is too long you might want to enter a shorter slug. Sometimes it is nice to see a photo in detail when entering information about it. PhotoQ easily allows this: if you click on a thumbnail, the corresponding photo will open in all its beauty in a new window. Once you entered the desired information, hit “Save Batch Info”. Don’t worry all the information can still be changed at a later stage.
    If you have batch uploads disabled, the process is similar only that you choose the file to upload via the “Browse” button.
  4. If everything went smoothly, you should now see the photos you just uploaded in the queue. You can add other photo to the queue if you like.
  5. Each entry in the queue can be edited by clicking on “Edit”. This gives you the possibility to alter all the fields.
  6. As of PhotoQ 1.2, entries in the queue can be easily reordered via drag-and-drop.
  7. You can remove photos from the queue by clicking on “Delete”.
  8. To publish the photo at the top of your queue on your photoblog, hit “Post top of queue”. PhotoQ then automatically generates a post where the photo is placed in the content part and the thumbnail is placed in the excerpt. The description is stored in a custom field called “descr”. You have thus access to the photo and the thumbnail in any of your templates via the template tags the_content and the_excerpt, respectively, and you can access the description via the custom field “descr”. Note that you also have the option (if you check the option “Include photo description in post content” on the PhotoQ settings page) to directly include the description in the content part of the post in a <p> tag with CSS class name “photo_description”.
  9. The entry at the top of your queue should now be removed from the queue and appear as a new post on your photoblog.
  10. Check the result directly on your photoblog or in the “Manage->Posts” section of the WordPress Administration panel.

Meta Fields

If you want to add more information to your photo posts than just the title and description provided by default, you have the possibility to do so via “Meta Fields”. Assume you want to associate each photo with the place where the photo was taken:

  1. Go to “Options->PhotoQ” in the WordPress Administration Panel.
  2. Click “Add Meta Field”.
  3. Give it a name, e.g. “place” and hit “Add Field”.
  4. For every photo you upload you will now have an additional field called “place” where you can enter the desired information. Once posted, the field is saved as a custom field with the same name.
  5. The list of Meta Fields can be edited by clicking on “Rename” or “Delete”.
  6. The three options “Upon Add/Delete/Rename” define whether changes you make to a Meta Field are also applied to the corresponding Custom Field of already posted photos. Example: Assume you already posted 20 photos and only then decide to add a new Meta Field called “place”. If you check “Upon Add, Add to already posted as well”, a Custom Field named “place” (with an empty value) will be added to all of the already posted photos as well.

Automatic Posting Via Cronjobs

PhotoQ allows you to have the top of your queue posted at regular intervals. This is especially useful if you go on a vacation and still want your photoblog to go on. Just fill up the queue before you leave and have PhotoQ do the rest. To set up automatic posting, you need to do the following:

  1. Set the frequency at which the posts should occur. This can be set in “Options->PhotoQ->Further Options”.
  2. Remember where on your web server you saved the file “wimpq-cronpost.php”.
  3. Setup a cronjob to execute “wimpq-cronpost.php” at your desired interval. Don’t worry, most often your webhost will set this up for you if you tell him/her the URL of your “wimpq-cronpost.php” file and when and how often you want the cronjob to be executed.
  4. Upon each execution of “wimpq-cronpost.php”, PhotoQ checks whether the last post occurred more than X hours ago (where X is the value you set in the PhotoQ Options panel). If so, the top of your queue is posted automatically.
  5. It might thus be a good idea to set the “PhotoQ Cronjob Frequency” slightly lower than the interval of the actual cronjob. E.g., assume you want a post once a day. Setup your cronjob to execute the “wimpq-cronpost.php” file once a day at the desired time and set the “Cronjob Frequency” in the “PhotoQ Options” to “23h”.
  6. Note: If your webhost does not allow you to setup your own cronjob you might be able to do something similar with a WordPress plugin such as WP-Cron (I have not tested this, so should you be able to make PhotoQ work together with such a plugin, please drop me a line).
  7. A neat alternative solution to the above has been brought to my attention by Phil from If your webhost does not allow cronjobs you can alter the WordPress index.php file in the following way:
    /* Short and sweet */
    define('WP_USE_THEMES', true);
    This then emulates a pseudo-cron executed every time a user visits your website. Thanks Phil, for pointing this out.

Troubleshooting – Help it doesn’t work!

Here is a short checklist in case something doesn’t work as expected. Please go through this before asking me for help.

  1. Did you check the requirements?
  2. Did you check the PhotoQ options? Especially, are the paths to your “qdir” and “imgdir” correct?
  3. Are you sure “qdir” and “imgdir” file permissions are set correctly?
  4. Do you have other plugins installed? If so, disable all other plugins and check whether it works now. Should you find any incompatibilities with other plugins please let me know. So far I know about the following plugins that are not compatible with PhotoQ: “Lighter Admin Drop Menus v2.3″.
  5. Does it work with batch uploads disabled? If not, try to make it work with batch uploads disabled first.
  6. “Everything seems to work but even if I enable batch uploads, I only get the option to upload one file at a time!” Is JavaScript enabled in your web browser?
  7. “I get a HTTP 403 error message when trying to do a batch upload?” Most probably, your web hosting provider enabled mod_security on your web server. Batch upload makes use of Flash and Flash is known to send malformed http headers which are rejected by mod_security. The only solution seems to be to turn off mod_security by adding the directives given above to your .htaccess file. Anyone having a better solutions is most welcome to let me know about it.
  8. “I am getting a ‘Warning: set_time_limit() has been disabled for security reasons…’ or similar. Some web hosting providers limit the execution time of PHP scripts and do not allow you to change it. PhotoQ tries to remove the limit because if you have a large batch upload, it might take some time. If you get warnings like the one above, you can comment the line set_time_limit(0); in the beginning of the whoismanu-photoq.php file by replacing it with //set_time_limit(0);Huge batch upload jobs might then however sometimes be aborted if they take longer than the maximum execution time allowed by your web hosting provider.

If nothing helps, don’t hesitate to ask – I would be glad to help. In order to be able to help you, I need to at least know the versions of WordPress and PhotoQ you are using, your browser/platform combination, whether it works with batch uploads disabled and of course the potential error message you are getting. If you get an error message of any kind, it might also be helpful to know what you were trying to do just before you got the error message. But please check the points above before writing about a problem. At least double-check the requirements. It will save me (and you!) a lot of time that is better spent improving PhotoQ than looking for imaginary problems. Thanks.

Making PhotoQ Better

Any comments, suggestions, bug reports, feature requests, contributions to future versions, compatible themes, etc., etc. are highly appreciated. Any help to improve PhotoQ is more than welcome.

Also, should you decide to make a photoblog using PhotoQ, please let me know. I would be more than happy to let the world know by linking to your site.


Thanks to all the PhotoQ users who help to keep up my motivation to continue this project. Thanks for all the kind comments and helpful bug reports. Special thanks to Manu from for the helpful comments and suggestions and to Monika at for pointing out that WordPress 2.5 was imminent and PhotoQ not ready (hey, I made it in advance ;-)). Many thanks to the guys at Without their great SWFUpload script, there would be no batch uploads in PhotoQ.

Comments (93)

  • 1

    Georg writes:

    so the integration with lightbox/Shutter Reloaded means that the uploaded file is not being resized and linke to with lightbox? Only a thumbnail of adjustable size is being displayed? Thats exactly how I wanted it to be :) Great, thx!

  • 2

    whoismanu says:


    whether the image is resized or not depends on the photoq settings you choose. you can have it resized if you want or you can keep it the way you uploaded it – your choice. other than that yes, that’s exactly what it does.

  • 3

    Klaus thinks:

    Hi there,

    Your plugin is just what the doctor ordered for a lazy guy like me. Trouble is – I can’t get it to work.
    Wordpress 2.33 on a Linux Server, PHP 4.4
    Single upload works – batch doesn’t – gives me 403 and 500 error, regardless of changes in .htaccess.
    Can live with that – but when testing to post the top in queue – I get this error message:

    Warning: rename(/home/virtua/public_html/wp/wp-content/qdir//adonis.thumbnail.jpg,/home/virtua/public_html/wp/wp-content/imgdir//2008_03/adonis.thumbnail.jpg) [function.rename]: No such file or directory in /home/virtua/public_html/wp/wp-content/plugins/whoismanu-photoq/classes/PhotoQ.php on line 1846

    Warning: copy(/home/virtua/public_html/wp/wp-content/qdir//adonis.thumbnail.jpg) [function.copy]: failed to open stream: No such file or directory in /home/virtua/public_html/wp/wp-content/plugins/whoismanu-photoq/classes/PhotoQ.php on line 1847

    Unable to move adonis.thumbnail.jpg, posting aborted.

    I can’t tell if the Cronjob works – haven’t gotten that far.

    I would be grateful for any input.

  • 4

    Tim thinks:

    I´m getting an upload error 500 after the upload has been performed. Any solution?

  • 5

    whoismanu says:


    wp version? photoq version? does it work with batch uploads disabled?

  • 6

    whoismanu says:


    photoq version? v1.2 does NOT work with WP < v2.5. If you have WP < v2.5 you have to use PhotoQ v1.1.5b. Check out the requirements on this page.

  • 7

    Tim says:

    WordPress 2.3.2

    photoq 1.2

    When disabeling batch, it works…but then there is no point of using the plugin :)

  • 8

    Niels thinks:

    Nice dude!
    I hope to update my 1.1.5 to 1.2 this weekend.
    I have integrated EXIF into it so i maybe is a bit of work but the queue works a lot better i think.

  • 9

    whoismanu says:


    for your problem, see comment number 6 above. and i disagree with you about batch uploads being the only useful feature of photoq…

  • 10

    whoismanu says:


    if you are the niels from comment number 4 of this post, thanks first of all for sharing your way of integrating exif and photoq. better exif support is somewhere on my todo list as well, we’ll see. if you implemented exif in the way described in above comment, your update should go smoothly, i cannot remember having touched any of the parts in question.

  • 11

    Niels thinks:

    Yes I’m that niels :)

    Cool to hear that.

    The first thing i have to do is wait for wordpress 2.5 and then in a test environment testing all the plugins.

  • 12

    Georg thinks:

    I’m trying to integrate exif from the post of niels. But I dont understand the part with the template:

    “$exif = unserialize(c2c_get_custom(’exif’));”

    What do you mean by template? index.php? And what can I do, if I dont know what I’m doing :P ?


  • 13

    PhotoQ Wordpress Photoblog Plugin Update 1.2.1 writes:

    [...] is a small bugfix for PhotoQ 1.2 fixing a bug that could under some conditions provoke empty width and height attributes. Thanks [...]

  • 14

    smokie says:

    my problem this : public_html/wp-content/plugins/whoismanu-photoq/classes/PhotoQ.php on line 1140

    picture uploding and error uploading 403

    help me ..

  • 15

    Georg writes:

    Same here. It seams as this is due to not having WordPress 2.5 because it is not yet released.

  • 16

    Niels writes:

    @Georg from post nr 12,

    You can do that the index but I use it in the single.php

    <?php $exif = unserialize(c2c_get_custom(‘exif’));
    //do this to see the contents of $exif to work with it
    echo”"; print_r($exif);
    echo “”;

    keep in mind that you have to have the ‘get custom field values’ plugin.

    for example,
    $exif['EXIF']['FNumber'] contains the aperture.

    to display that as a nice number:

    $aperture = explode(“/”,$exif['EXIF']['FNumber']);
    $apertureGetal = $aperture[0] / $aperture[1];
    echo “f/”.$apertureGetal;

  • 17

    Hashim thinks:


    thanks for your great plug in
    I have done every steps in the installation instructions , but when I click the button “Add photo to queue” no thing changes! , button looks inactive
    I tried many browsers but it seems to be JS error
    I need quick help please

  • 18

    Georg says:

    Thx Niels! Unfortunately I get an error when uploading a file with exif data. But it’s not high priority atm. I’ll try again later.

  • 19

    whoismanu says:


    wp version? photoq version? it most certainly is no js error as when clicking “add photo to queue” there simply is no js involved ;-).

  • 20

    Niels thinks:

    @Georg nr 18, You can also mail me so we can try to fix it. Just so you know.

  • 21

    Gaurav writes:

    PhotoQ works great! love it…
    But would like to change my wordpress theme to look like a photoblog. are there any PhotoQ compatible themes

  • 22

    whoismanu says:


    photoq doesn’t introduce any special template tags, but basically relies on the standard wordpress the_content and the_excerpt. so it should work with virtually any wordpress theme (an exception are of course themes that do rely on special template tags provided by some plugins).

    for photoblog specific themes you can use whatever theme makes the same assumptions as photoq does: image in content, thumbnail in excerpt. you could e.g. try nishita. from what i see from their homepage, it makes exactly this assumption (haven’t tried it myself though).

    let us know what you chose, what worked for you, it could be interesting for others too.

  • 23

    whoismanu says:


    ah yeah and there is of course this one which even explains how to use it with photoq. i also once quickly tried this one, and it worked well.

  • 24

    Fotos de Carros says:

    I tried to use your plugin. Although it is really nice and it worked right away, I couldn’t get it to auto resize the image while it is displayed on the blog main page or in its own post. Maybe this feature is not provided, but it shouldn’t be all or nothing. The plugin should be able to detect if an image is bigger than X width/height and add the HTML tag to make it fit on the post page without having to modify the actual file.

    I hope this was just some random bug i got.

  • 25

    Fotos de Carros thinks:

    After using your plugin a little more I noticed something else:

    1- Before adding a batch, it would be great to be allowed to choose the category for all the images you are adding in that moment. I’m surprised nobody has requested it.

    2- It would be great to be able to add more than one image per post. Let’s say I have 40 new images, instead of creating 40 new posts, maybe I want to split them half or post 3 images per posts, or whatever, as long as a choice is given.

    If these feature are available somewhere and I missed them, please let me know.

  • 26

    Georg thinks:

    @Fotos de Carros – Have a look at the option page. There you can set the size the images are resized to. The category for all photos is a good idea and not implemented yet. More images per post is not possible or planed as fas as I know.

  • 27

    Brandy says:

    Well, took me some putzin’ to get it to work, but that was my issue, not yours- I just had to take the time to read your instructions, and disable the batch upload.

    This is simply fantastic. I have been avoiding using images in my blog because of the time it takes to embed an image. Wonderful, fantastic, great job.

  • 28

    Georg says:

    After a loooong search inside the wp-functions and photoq itself I found the solution to the compression-problem:

    I think ~88 is a good compromise between size and quality.

  • 29

    WordPress 2.5 : Working Plugins at STCFX - Web Everything says:

    [...] PhotoQ Photoblog 1.2 [...]

  • 30

    Почти все про блоги » Blog Archive » Wordpress не для блогов: 16 вариантов says:

    [...] плагин для создания галереи рисунков и/или PhotoQ Photoblog Plugin .Зажиточные блоггеры могут также озаботиться [...]

  • 31

    whoismanu says:

    Fotos de Carros,

    for your first comment, see georg’s answer (comment 26). for your two proposals, they have been both on my list for quite some time. just need to find the time to add them. thanks for your input anyway, it’s good to see that planned features are really needed.

    entering some info (e.g. the categories as proposed by you) concerning all photos in a batch prior to uploading is planned together with more than two image sizes for the next version already. multiple images per posts are planned for the version after the next. this roadmap might of course be subject to change…

  • 32

    whoismanu says:


    thanks for sharing this with us.

  • 33

    ghebro writes:

    I’m very interested in this plugin but
    i have the same problem of Hashim,
    i get no action when pressing the SELECT PHOTOS, and the firefox error debug reports this eror

    “swfu is not defined”

    is there any solution ?

    Thank you very much

    WP version 2.3.3
    photoQ version 1.2.1

  • 34

    whoismanu says:


    yes, either update wordpress to 2.5 or use photoq 1.1.5b until you do. see the requirements above.

  • 35

    Klaus thinks:

    Hi there. Now that I have upgraded to WP 2.5 batch upload works and I’m happy.
    Cron job has yet to be tested..
    I have two suggestion however for the general settings:
    1. Would it be possible to pre-define the category, instead of it automatically setting the deafult category?
    2. The Post Header. It would be neat to have some config options for that, too.
    For example: All the post I post with Photoq have the header “Picture of the day” + the date.
    Automating this area would be cool and would make thing go along a bit faster.

    Thanks so far! Good work!

  • 36

    whoismanu says:


    thanks for the input. point 1 is planned. point 2 sounds useful, thanks. let me think about it…

  • 37

    PhotoQ Wordpress Photoblog Plugin Update 1.2.2 writes:

    [...] update is a major bugfix for PhotoQ 1.2. Anyone using PhotoQ 1.2 or higher should perform the update as it also fixes some security related [...]

  • 38

    Oliver thinks:

    I tried to install the PhotoQ Photoblog Plugin v1.2.2 with a fresh copy of WordPress 2.5. (1&1 Webspace, PHP 4.x, mySQL 5) I read the requirements – no problem. Additionally I deactivated all the other plugins to give your batch upload a try.

    Unfortunately it doesn`t work for me. So I wanted to inform you about two things:

    1. I have the same problem as Ghebro has had before me. Firebug let`s me know that swfu is not defined. Some required parameters seem to be empty so that pressing the upload button is like pressing in the air. Nothing happens…

    2. There also seems to be an issue with plugin parameters that seem not to be saved (or shown) correctly. After changing the width parameters for pics and thumbnails I was shown correct values. But if I reload the plugin options later I still see the default values. (Flag fields seem to work but not the values left behind radio buttons.)

    I already tried to completely delete and reinstall the plugin and saved the new options values several times. Hmmm… I can`t make your plugin work for me. May be it currently doesn`t work with PHP4? A few weeks ago I made a test with a PHP5 Server where everything worked excellent.

  • 39

    Diseño Web thinks:

    I had some issues in cron jobs. but in the other side works fine. I still testing and I notice the progress later.

  • 40

    whoismanu says:


    thanks a lot for your comment. i am able to confirm your bug number 2. there seems to be a problem with photoq settings under php4. i am working on a fix. however i was not yet able to recreate your bug number 1. i’ll get back to you on this.

  • 41

    [每日精彩] 2008-04-08 | 时光漫步 says:

    [...] – PhotoQ WordPress Photoblog Plugin v1.2 – Ready for WordPress 2.5 (tags: plugin wordpress photoblog [...]

  • 42

    PhotoQ WordPress Photoblog Plugin Update 1.2.3 writes:

    [...] update contains many bugfixes for PhotoQ 1.2. Anyone who had problems with earlier PhotoQ 1.2 versions should perform the [...]

  • 43

    Ascanio writes:

    Hi, I’ve installed PhotoQ and it looks pretty neat!

    I have some feedback though.

    1) PhotoQ has been designed in a very rigid way: you should consider refactoring it to let users choose whether to post photos or to include photos in posts (which requires a view within the WRITE and EDIT post page, so users can pick and include pictures).

    2) PhotoQ is missing the 3rd image size, which is very important these days. Especially with it’s current use limitations (post body is packed with the full images, which will break most of blog layouts out there). It is extremely important to give the ability to use thumbnails, previews and full images.

    3) Talking about usability again: in the batch edit page, at least in the “after batch upload” page, category checkboxes should be tiled horizontally, with global switches at the top and bottom, to assign categories automatically to the whole batch. This is obviously a minor improvement, that might not be worth while.

    A part from these issues it looks really great!
    I haven’t tested it on Mac yet.
    I’m not a WordPress guy, but I am a Drupal guy (I implemented SWFUpload in Drupal 5 at low level successfully: will be posting a module/tutorial soon).


  • 44

    whoismanu? photoblog - PhotoQ WordPress Photoblog Plugin Update 1.2.4 says:

    [...] update is another bugfix for PhotoQ 1.2. Anyone who had problems with earlier PhotoQ 1.2 versions should perform the update. This update [...]

  • 45

    whoismanu says:


    thanks for the valuable feedback. i agree on most of your points and most of them are already planned for one of the coming versions.

    1) true to some extent, but photoq’s main intent was for sites with a separate photoblog, which generally means post=photo. i am aware, however, that a lot of users started to use it withing their regular blog as well, so you might be right, a tighter integration might be welcome. not sure yet how i could integrate the queue though which in my opinion is one of photoq’s most important features, setting it apart from other solutions. any ideas are welcome…

    2) definitely true and i already announced this in other comments. just have to find the time to realize it. i don’t see however why it would break blog layouts?? on the contrary by not using any special photoq template tags it should work with most existing themes…besides, there is an option to replace images with image links…

    3) applying categories (and other info) to whole batchs definitely makes a lot of sense and has also already been announced. again, i just need to find the time ;-) and i disagree that it might not be worth it as this is one of the features i personally miss most.

    Should work on a Mac without major problems as it was developed on a Mac.

    Currently I am also doing some first steps with drupal for another site. Reason is the new multilingual features in drupal 6. However out of the box image support seems quite bad and the add ons all didn’t really keep pace with the upgrade to drupal 6. got the feeling that wordpress people are faster when adapting to new versions (ok, maybe at the cost of introducing more bugs, see e.g. this plugin ;-) )

  • 46

    Ascanio thinks:

    Hi whoismanu,

    what a warm welcome.. you must have some good spare time there (or huge will)!

    I will quickly answer (I’m at work right now):

    1) “Alternate Usage” is a key in product marketing, it must be analyzed wisely, and some times it may become the “Predefined Usage”. A part from big terms that tell simple concepts, you should understand how people will mostly use your stuff, and give them what they need. It’s not about how you (or I) would use it. I personally would find it IMMENSELY more useful as a plugin for regular blogs.

    2) The big pictures may break the layout for this reason (I’ll take my personal example): a layout designed for XGA displays (about 900px wide) with 3 columns, will not have space to accommodate any large pictures, while still I would like to show my images at SVGA resolution (at the least). To do this, I would need small thumbnails for excerpts, small previews for the post pages and full sized images for lightbox, pop-up, Flash fullscreen or any kind of show.

    3) you are right, this is in fact a time consuming limitation.

    Drupal sucks in so many ways… the problem with it is that core modules have changed little since the early versions, and have never been designed with flexibility in mind.
    Nearly all the Drupal-based project I worked on required intensive core-refactoring and redesigning for things to work the right way. So they are all stuck with no option to upgrade the platform.

    Keep the good work up!

    And email me, should you need help thinking about how to make PhotoQ work for normal blogs!

  • 47

    Sammy writes:

    Hey whoismanu,

    After I press the “Add photo to que” button and upload one or more photos, I press the “enter info” button. When I do that, I get the “save batch info” button and when I click that one, I get the following error: Warning: Invalid argument supplied for foreach() in …/wp-content/plugins/whoismanu-photoq/classes/PhotoQ.php on line 1144

    Result: no photos are uploaded and I can start over again. Do you know what I can do to fix this?


  • 48

    whoismanu says:


    what wp version are you using? probably 2.5.1? i think they changed something in the way categories are managed in 2.5.1. I didn’t have a chance to look at it yet. guess your error comes from this. i’ll try to do it soon.

  • 49

    Mark writes:

    I get the very same error, I’m using Version 2.5.1 and using the same process I get “Warning: Invalid argument supplied for foreach() in /home/dom27189/public_html/wp-content/plugins/whoismanu-photoq/classes/PhotoQ.php on line 1144″

    Also, you mention setting the correct permissions, do you know what the permission numbers are for:


    eg. 755, which appears to be default for new directories



  • 50

    Sammy thinks:

    I’m still using WP version 2.3.3

  • 51

    Mark thinks:

    Sammy, what permissions are you using for the following folders:


  • 52

    Mark writes:

    Right well I solved the first issue by changing the permissions for the /wp-content/qdir and /wp-content/imgdir folders to 777, which is read, write and execute for the three types: user, group and others. I’m not sure if that’s correct to use 777, so whoismanu if you could confirm that would be great.

    Sammy: It’s pretty easy to do in any good ftp client, just right click the folders listed and it should be in the options.

    I can now edit the uploaded file details, but there is another error in the Manage PhotoQ – Enter Info section. Under the text “No fields so far. You can add some if you like” there are two of the following errors:

    Warning: usort() [function.usort]: Invalid comparison function. in /home/dom27189/public_html/wp-content/plugins/whoismanu-photoq/classes/PhotoQ.php on line 1525

    Any suggestions?


  • 53

    whoismanu says:


    if you want to use the latest versions of photoq, you need to upgrade to at least wp 2.5, see the requirements above. thanks.

  • 54

    whoismanu says:


    thanks for your comments. concerning permissions, it depends on the settings of your server. both folders need to be writable. Quoting wordpress documentation: “In some cases, this may require assigning 755 permissions or higher (e.g. 777 on some hosts)”.

    concerning the usort thing. it is actually not an error but only a warning ;-). everything should work fine despite this message. it is caused by the fact that the way wordpress handles categories slightly changed in the last update (to 2.5.1) and photoq doesn’t yet fully account for this (as its latest update was released before the release of 2.5.1). if it bothers you and you don’t want to wait for the next upgrade of photoq to get rid of it, you can open the file classes/PhotoQ.php in a text editor and replace line number 1525 with

    //usort($result, ‘sort_cats’);

    i.e. you comment out the call to usort (alternatively you can of course also delete the line entirely which will have the same effect).

  • 55

    Mark thinks:

    Many thanks for the info!

    As for permissions, this maybe something you might want to elaborate on with your installation instructions. I know it does vary depending on the server but some general advice would help make it a smoother process for people who are not quite as technically minded! I had quite a few issues while setting it up, almost all of them solved by changing the permissions of a folder.

  • 56

    Sammy says:

    First of all, sorry for overlooking the requirements about version 2.5. I now upgraded to the latest version of WP. When I checked in my FTP client for the folders qdir and imgdir in the wp-content folder, I noticed they weren’t even there. I created them manually and set the permissions to 777, but without any improvement. Still the same warning, still not able to upload pictures.

  • 57

    whoismanu says:


    thanks a lot for your comment. must be another wp 2.5.1 feature. i am able to recreate something similar locally when not choosing any categories upon uploading. however in my case the photos are still added to the queue. i’ll try to look into these category issues introduced by wp 2.5.1 one of these days.

  • 58

    Cobb thinks:

    Is there a way for the plugin to take a different title for the blog post other than the file name?

  • 59

    whoismanu says:


    sure, when entering information you can enter whatever name you want. same when you edit a photo that is in the queue.

  • 60

    PhotoQ WordPress Photoblog Plugin Update 1.2.5 thinks:

    [...] update adopts category handling of PhotoQ 1.2 to WordPress 2.5.1. Only perform the update if you are using WordPress 2.5.1 or higher. If you use [...]

  • 61

    Jeannie Bernard says:

    Everything went perfectly until I hit the button Post Top of Queue. Then the image does not appear. And, my wp-content/img directory is not creating the 200805 directories. Maybe my path to the secondary img directory is wrong, but I don’t think so. that is my path to the secondary image folder. Since the thumbnails and the links to the large pictures are good, I am assuming that the problem must be in that secondary foler not being able to create the folders and place the queue pictures there.

  • 62

    whoismanu says:


    3 possibilities:

    1.) imgdir is wrong. with the url you gave above your imgdir setting in photoq should be “wp-content/img”. i assume your qdir worked, so just make sure you define the imgdir analogous to your qdir
    2.) imgdir correct but not writable. set permissions of img dir to 777 like you did for your qdir
    3.) imgdir exists and is writable but the folders cannot be created because php safe_mode is turned on. to check if safe_mode is on or off do the following:

    With a text editor create a file containing:

    <?php phpinfo(); ?>

    save it calling it, e.g., info.php and place it on your webserver. run the file from web browser (e.g. by pointing the browser to assuming that you saved the info.php file in your wp-content folder). In the output generated search for “safe_mode” and check that safe_mode is ‘off’. If it isn’t contact your webhost and have them disable it.

    hope this helps.

  • 63

    Wordpress 2.5 versiyonu ile uyumlu Eklentiler | Fırtına 30 05 thinks:

    [...] PhotoQ Photoblog 1.2 [...]

  • 64

    bluemike807 thinks:

    I’ve setup everything according to the instructions – and Im not running any other plugins.

    The directories for the images and queue are setup with 777 permissions.
    I can upload images – I can see that hey are deposited into the qdir folder – but photoq reads only an empty queue after that. It is as if I never uploaded them – at least from wordpress’ perspective.
    What am I doing wrong??

  • 65

    Tyrone thinks:

    Hi whoismanu,

    This plugin rocks! Thanks for creating it. The latest version doesn’t have multi picture per post feature yet, right? Any thoughts on how would that be possible?

  • 66

    whoismanu says:


    thanks, good to hear you like it. i have thoughts on how i will implement this. but i am not there yet. so right now there is unfortunately no way to put more than one photo into one single post.

  • 67

    lukas writes:

    Hi there,

    I have the same problem as many people here. I’m using the newest version of photoq and newest of wordpress.

    What happens is the folllowing:

    I upload files and they get stored in qdir (and i see the nice upload completion bar), but when I click enter info, it goes straight to save batch info, and when i click that to an empty que again, showing 0 files uploaded.

    permissions on qdir and imgdir are 777.

    what am i doing wrong?

  • 68

    Anne says:

    I’m looking for the theme you used on your photo blog. I have installed photoq, but don’t like anything I’m finding. Help would be appreciated.


  • 69

    whoismanu says:

    people having similar problems to the one lukas and bluemike807 describe above, should check that they run PHP with the GD library installed/activated. without GD support neither photoq nor wordpress are able to resize images. once you have GD support the problems with empty queues and photos that don’t get uploaded should go away.

  • 70

    whoismanu says:


    the theme i am using is a custom one, which is not currently publicly available. did you check out the ones mentioned in comments number 22 and 23 above?

  • 71

    Make WordPress Dance to your Tune | Blog Oh Blog writes:

    [...] Another Photo Blog PhotoQ WordPress Photo Blog plugin PhotoXhibit plugin WP Photo [...]

  • 72

    mozey says:

    THANK YOU very much for your work. REALLY impressive.

    I have an application which i want to “talk” to PhotoQ. The application runs on the same server, and i would like to somehow copy the photos into a dir, ALONG with the meta data. And be ONE click away from posting.

    I would have rated this plugin at %115 instead of current standing at %110 IF, i could have dropped the image in there along with an XML that would be understood by the PhotoQ.

    I will see what is the best way i can achieve this and HOPEFULLY i’ll have it working, and then send you a patch of my crappy code. is a lolPics animator, You can create multiple lolPics (frames), and then combine them, which will give you an animated gif.

    Thanks a million, Please do reply to me if you have found a way to inject the meta data automatically.

    Thanks again for your gem, :)

  • 73

    Koushik thinks:

    I am getting Upload Error : 403 while uploading image in the queue.

  • 74

    M thinks:

    I might just be missing something here but I cannot seem to get lightbox to work with PhotoQ. It will not recognize the rel=”lightbox” even if I manually add it. (What I do get upon clicking an image… is the previous image via link) I have checked everything I can think of, read over and double checking the requirements… even resetting everything several times to no success.

    One other thing: is there a way to get the EXIF info into the description or anywhere within the post?

  • 75

    whoismanu says:


    please check the troubleshooting section above.

  • 76

    whoismanu says:


    can you tell me what kind of lightbox-style plugin you are using so i can test it myself? i tested successfully with shutter reloaded.

    concerning exif, it will come in the next version. until then you might want to check niels’ instructions in comment no 4 of this post

  • 77

    luxury furniture thinks:

    I need to rename images of posts with title name

  • 78

    Øyvind thinks:

    why did you delete my question?

  • 79

    whoismanu says:


    i am very happy about all comments and i thus never delete any unless it is obviously spam. i didn’t touch yours either, it is still where it always has been:

    btw, you will also find an answer to your question there.

  • 80

    John writes:

    Is it possible to let give access to PhotoQ to other roles other than the Administrator e.g. let an editor use PhotoQ?

    Gr. John

  • 81

    whoismanu says:


    right now this is unfortunately not possible. photoq right now only works in a “single-user” setting but i might have to change this in one of the coming versions.

  • 82

    PhotoQ WordPress Photoblog Plugin Update 1.2.6 says:

    [...] is only a small fix that makes PhotoQ 1.2 compatible with WordPress 2.6. Only perform the update if you are using WordPress 2.6 or higher it [...]

  • 83

    ryn thinks:

    I”m trying to use the batch upload feature (it loads single photos just fine) and I keep getting the 403 message. I edited my .htaccess file to no avail.
    (I also haver problems with the WYSIWYG flash photo uploader in the WP post page, if that’s any indication…)

    Any other suggestions? I’d really love to use this feature!


    I’m running PhotoQ 1.2.6 on WP 2.6
    Firefox 2 on mac OS 10.5.4

  • 84

    ryn thinks:

    OH! Additional info: this is one of three different WP installations I have on this server. None reside in the root directory.

    I’ve tried:
    Creating a new .htaccess in the directory of my photoblog (this gives me an Internal Server Error 500). Any help in this way would be awesome.
    Changing the .htaccess in the root dir.
    Changing the .htaccess in another WP installation.

  • 85

    whoismanu says:


    sorry for my late reply, was not around the last few days. most probably your server is running with mod_security. wordpress uses the same batch upload mechanisms photoq uses, so that explains why you have the problem in wp post upload and in photoq. normally this goes away if you edit your htaccess file ( see the following link to see where your .htaccess file should be: ) as detailed in the installation section of this post. now, are you saying, that this is exactly what you did but the problem doesn’t go away?

  • 86

    ryn thinks:

    Yup. Specifically, when I modify the .htaccess file I encounter an Internal Server Error (500), which only goes away if I delete the modification.

    Any ideas?
    Like I said in my previous comment, this is one of a few WP installations on this server, all in different folders and directed to different subdomains. Could there be permissions conflicts?

  • 87

    whoismanu says:


    hmm, i just came across this:

    check the bottom of the following page

    looks like mac client + subdomains + swfupload can be a bad combination due to a bug in the mac version of the flash player. both wordpress and photoq use swfupload. so maybe that’s what you are experiencing. might also explain your error 500 assuming that mod security is not running on your server. the error might then be due to you trying to disable something your webserver doesn’t know about.

    is there any chance you can try with a windows client (ouch! ;-)) ? like this we can be sure this is/is not the problem.

  • 88

    ryn writes:

    Ok, got on my window machine and gave it a shot; enabled batch uploads and then tried a few photos. Instead a 403 error now after every photo I get a 404 error!


  • 89

    Björn Hahnefeld (TYPO3 Webdesign Regensburg) says:

    Thank you very much for the good work.
    It is a very useful Plugin and our users appreciates it!

  • 90

    PhotoBlogging - OddJob’s IT WebLog writes:

    [...] PhotoQ, WordPress Photoblog Plugin [...]

  • 91

    Jacob Tekiela says:

    GREAT features…….my only trouble is that I have a LOT of cats and subcats (approx 300!!!) – would it be possible to somehow limit the cats e.g by excluding other cats having chosen one….or maybe even just handwrititng the catids…??

    assign tags and cats to a FOLDER of pictures, so you basically say: the content of this folder is in CAT1. cat1:sub1, cat1_sub2, tag1, tag2


  • 92

    whoismanu says:


    what do you mean by limiting cats? is your issue a visual one i.e., you are annoyed by long category lists that are being displayed? and you would like to e.g. be able to fold away the subcats?

    your second request for batch tags and cats will be there in the next version of photoq that is currently in beta testing. so if everything goes well you should have it in about two weeks…

  • 93

    Jacob Tekiela thinks:

    Hi Who,
    GREEEEEEAT NEWS ‘ bout batch…..REALLY looking forward!!!!

    yesfolding away would be one solution
    or maybe simply something like wp_dropdown_categories???

    This Plug is VITAL to my future website – I have a huge backlog ’bout 800 pix

    - NEW categories on the fly – so you dont have to “go out” and create them
    - BATCH-(back)dating
    -POSTING (e.g “POST ALL”) and possible disabling of “are you really sure you want to”…..
    -LIGHTBOX-publishing can you add a SERIES of pictures to the lightbox??
    - CROPPED SQUARE thumbs

    I really would like to go deeper into this, do let me know if you need beta-testers….

    thanks so VERY VERY much!


serving fresh homemade photographs