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

Version 1.4.2.1

  • Fixed bug whereby defaults could not be set and galleries could not be edited in WebKit browsers
  • Fixed bug whereby 'NextGEN Gallery' and 'Picasa Web Album' galleries did not display
  • Fixed bug whereby submission could be performed remotely

Version 1.4.2.0

  • Upgraded Juicebox-Lite to v1.4.2
  • Added support for using Picasa Album Id as well as Picasa Album Name
  • Fixed 'PHP Notice' in WordPress Debug Mode
  • Improved gallery settings window layout
  • Removed deprecated code

Version 1.4.1.0

  • Upgraded Juicebox-Lite to v1.4.1
  • Fixed 'PHP Notice' in WordPress Debug Mode
  • Ensured all external CSS and JavaScript files are loaded only when required

Version 1.4.0.1

  • Fixed bug whereby XML data was not generated dynamically under certain WordPress installations

Version 1.4.0.0

  • Upgraded Juicebox-Lite to v1.4.0

Version 1.3.3.1

  • Added support for adding gallery in QuickPress widget on Dashboard page via media button
  • Added support for CKEditor and FCKEditor
  • Added support for reversing image order for 'Media Library' galleries
  • Added tooltip text on 'Manage Galleries' page
  • Fixed bug whereby default Pro Options appeared in gallery Pro Options text area in edit gallery form
  • Fixed bug whereby Picasa Web Album did not display if Picasa User Id or Picasa Album Name contained whitespace
  • Fixed HTML errors on 'Manage Galleries' page
  • Fixed server paths in backup and restore Pro 'jbcore' folder routines
  • Fixed visual input field issues in WebKit browsers
  • Ensured all XML files use UTF-8 encoding
  • Ensured only accepted images are included in galleries
  • Ensured only required attributes are included in dynamically generated XML files
  • Ensured only required resource files are included in administration pages
  • Ensured only single Juicebox shortcode tag is inserted in page or post when user clicks 'Add Gallery' button multiple times
  • Improved support for WordPress capabilities
  • Improved error handling when unable to include Juicebox shortcode in page or post
  • Removed deprecated code
  • Clean numeric gallery configuration option values
  • Disabled non-layout and gallery-specific options on 'Set Default Values' page
  • Moved all inline CSS to external stylesheets
  • Optimized code

Version 1.3.3.0

  • Upgraded Juicebox-Lite to v1.3.3

Version 1.3.2.0

  • Upgraded Juicebox-Lite to v1.3.2
  • Clean color and opacity values
  • Removed 'default.xml' file
  • Optimized code

Version 1.3.1.0

  • Upgraded Juicebox-Lite to v1.3.1
  • Lite Options from the Pro Options text area are no longer entered into the output XML files

Version 1.3.0.0

  • Upgraded Juicebox-Lite to v1.3.0
  • Added support for new Juicebox-Lite configuration options textColor, thumbFrameColor, useFullscreenExpand and useThumbDots
  • Custom default values no longer overwritten when updating plugin
  • Media Library gallery message displays 'Upload/Insert' or 'Add Media' depending on version of WordPress installed
  • Fixed bug whereby plugin does not activate successfully under certain conditions
  • Fixed bug whereby gallery does not display under certain conditions

Version 1.2.0.1

  • Added support for 'Include Featured Image' in 'Media Library' galleries
  • Fixed bug preventing Dashboard menu links from being displayed in certain installations
  • Pro Options are now case-insensitive
  • Removed meta 'viewport' tag from head section
  • 'Delete All Galleries' button changed to 'Delete All Data'

Version 1.2.0

  • Upgraded Juicebox-Lite to v1.2.0
  • Added support for 'Picasa Web Album' as source of images
  • Added support for WordPress installations on https:// secure servers
  • XML file now created dynamically so no need to edit gallery or post to rebuild static XML file
  • Made distinction between pages and posts throughout plugin
  • Gallery Id displayed in 'Add Juicebox Gallery' pop-up window
  • Fixed bug allowing multiple gallery shortcodes to be entered into each post
  • Fixed bug whereby duplicate calls were made to certain methods
  • Fixed bug whereby corrupt NextGEN Gallery installation caused NextGEN-sourced gallery to fail
  • Fixed 'PHP Deprecated' message
  • Fixed 'PHP Notice' in WordPress Debug Mode
  • Fixed W3C Markup Validation issue on admin page
  • Fixed compatibility issue with WordPress v3.5 Beta 2

Version 1.1.1

  • Upgraded Juicebox-Lite to v1.1.1
  • Added support for 'NextGEN Gallery' as source of images
  • Added ability to delete all galleries and reset Gallery Id to zero
  • Added ability to set/reset default values for gallery options
  • Improved and restructured code
  • Bugfixes

Version 1.1.0

  • Upgraded Juicebox-Lite to v1.1.0
  • Improved escaping of XML entities
  • Fixed bug whereby phantom XML file could be generated
  • Fixed bug relating to single quote in gallery title
  • Fixed bug causing error message when XML file does not exist
  • Fixed bug causing error message with incorrectly formatted Pro Options
  • Fixed compatibility issues with other plugins
  • Scripts now called inside appropriate hooks
  • Removed redundant code

Version 1.0.2

  • Upgraded Juicebox-Lite to v1.0.2

Version 1.0.1

  • Initial release