WP-Juicebox Plugin for WordPress

The WP-Juicebox plugin allows you to easily create Juicebox galleries with WordPress. Images and captions can be loaded from the WordPress Media Library, Flickr, NextGEN galleries or Picasa Web Albums.

Requirements

Before installing, please confirm that your web server meets the following requirements. If you are not sure, contact your web host tech support.

  • WordPress version 2.8 or higher.
  • PHP version 5.2.0 or higher.
  • The '/wp-content/uploads/juicebox/' folder must exist and have full access permissions (777).
  • PHP DOM extension enabled. (This is enabled by default. However some web hosts may disable it.)
  • Active theme must call the wp_head function in it's 'header.php' file.

Installation

  1. Download the WP-Juicebox plugin. Unzip the plugin folder on your local machine.
  2. Upload the complete plugin folder into your WordPress blog's '/wp-content/plugins/' folder.
  3. Activate the plugin through the 'Plugins' menu in WordPress.
  4. If the the '/wp-content/uploads/juicebox/' folder does not exist, create it and give it write permissions (777) using an FTP program.

Adding a Gallery

  1. Add or Edit a WordPress Post.
  2. Click the 'Add Juicebox Gallery' or the Juicebox icon button.
  3. Enter the required gallery options in the popup form.
  4. Click the 'Add Gallery' button. This will add the required gallery tag into your post. The gallery tag will look something like this:
    [juicebox gallery_id="4"]

Adding Images From WordPress Media Library

  1. In the 'Add Gallery' screen, select Image Source: 'Media Library'. Note you can only include 1 Media Library gallery per post.
  2. In the 'Add Post' or 'Edit Post' screen click the 'Add Media' button, above the main post text window.
  3. The following steps depend on your version of WordPress.

    WordPress prior to 3.5:
    • In the 'From Computer' tab, click 'Select Files'. Upload images from your local machine. Enter text in the 'Caption' field to be displayed as the Juicebox caption.
    • Your uploaded images will show in the 'Add Media -> Gallery' tab. Image order is determined by the order of the images as displayed in the list. To change the order, drag and drop the images. When done, click 'Save All Changes'.
    WordPress 3.5 or later:
    • Go to the 'Insert Media' section.
    • Upload images from your local machine by clicking 'Select Files' or by dragging and dropping the images into the media window.
    • Wait until the images have finished uploading.
    • Reorder the images (if necessary) by going to the 'Insert Media -> Media Library' section, selecting 'Uploaded to this post' and then dragging and dropping the images into the order you require.
    • Close the media window using the cross at the top right (do not click 'Insert into post' or 'Create a new gallery').
  4. Return to the post and click 'Save Draft' or 'Publish' to rebuild the new gallery. Clear your browser's cache to see the updated gallery.

Adding Images From Flickr

  1. In the 'Add Gallery' screen, select Image Source: 'Flickr'.
  2. Enter the required Flickr username and tags. Gallery images will be automatically updated if new images are added to Flickr.
  3. Click 'Save Draft' or 'Publish' to view your gallery.

Adding Images From a NextGEN Gallery

  1. In the 'Add Gallery' screen, select Image Source: 'NextGEN Gallery'.
  2. Enter the Gallery Id of the NextGEN gallery you wish to load images from.
  3. Click 'Save Draft' or 'Publish' to view your gallery.

Adding Images From a Picasa Web Album

  1. In the 'Add Gallery' screen, select Image Source: 'Picasa Web Album'.
  2. Enter the required Picasa user id and album name. Gallery images will be automatically updated if new images are added to the album.
  3. Click 'Save Draft' or 'Publish' to view your gallery.

Editing a Gallery

To Edit Options

  1. 'Edit' the WordPress post which contains the gallery you want to edit. Make a note of the 'gallery_id' parameter in the Juicebox gallery tag.
  2. Select the 'Manage Galleries' link from the 'WP-Juicebox' menu in the left column of WordPress.
  3. Find the required gallery from the list via the 'gallery_id' parameter. Click 'Edit Gallery'. Modify your gallery options in the 'Edit Gallery' screen. Click 'Save'.

To Edit Images

  • Flickr galleries will be automatically updated when your Flickr photostream changes.
  • For WordPress Media Library galleries:
    • 'Edit' the post that contains the gallery.
    • Click the 'Add Media' button.
    • The following steps depend on your version of WordPress.

      WordPress prior to 3.5:
      • To add new images, go to the 'From Computer' tab.
      • To view, reorder or delete images, go to the 'Gallery' tab.
      • When done, click 'Save all changes' on the 'Gallery' tab and close the 'Add Media' window.
      WordPress 3.5 or later:
      • To add new images, go to the 'Insert Media' section and click 'Select Files' or drag and drop the images into the media window.
      • To view, reorder or delete images, go to the 'Insert Media -> Media Library' section and select 'Uploaded to this post'. Images can be dragged and dropped into a new order.
      • When done, close the media window using the cross at the top right (do not click 'Insert into post' or 'Create a new gallery').
    • 'Update' the post.
    • Clear your browser's cache to see the updated gallery.

Upgrading to Juicebox-Pro

Juicebox-Pro supports advanced customization options, no branding, unlimited images and more. To upgrade the WP-Juicebox plugin to Juicebox-Pro, do the following:

  1. Purchase and download Juicebox-Pro.
  2. Replace the 'jbcore' folder in the WordPress plugin folder with the one from the Juicebox-Pro download. To do this, upload the '/web/jbcore/' folder from the Pro download folder to the '/wp-content/plugins/wp-juicebox/' folder inside your WordPress install folder, overwriting the existing 'jbcore' folder.
  3. Clear your browser's cache. If you do not see the 'Juicebox' badge at bottom-right of your gallery, you have successfully upgraded to Pro.
  4. You can now enter Pro config options into the 'Pro Options' text area. Pro options are added one per line in the following format:
    optionName = "optionValue"

WP-Juicebox Version History

View WP-Juicebox Version History