WP-SimpleViewer Wordpress Plugin

The WP-SimpleViewer plugin allows you to easily create SimpleViewer galleries with WordPress. Images and captions can be loaded from the WordPress Media Library or from Flickr.

WP-SimpleViewer is currently onĀ version 2.2.0. View the version history..

Requirements

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

Installation

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

Upgrading from v1.5.4. Upgrading to the new plugin will cause galleries created with the old plugin not to display. Check here for the solution.

Adding a Gallery

  1. Add or Edit a WordPress Post.
  2. Click the 'Add SimpleViewer Gallery' or the SimpleViewer 'eye' icon button.
  3. Enter the required gallery options in the popup form. Check option descriptions here.
  4. Click 'Add Gallery' button. This will add the required gallery tag into your post. The gallery tag will look something like this:

    [simpleviewer gallery_id="4" bgcolor="ffffff" gallery_width ="100%" gallery_height ="600"]

  5. To set the gallery background color, width or height, edit the gallery tag directly in the Edit Post text window.

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 WordPress Media Library

  1. In the 'Add Gallery' screen, select Image Source: 'WordPress Library'. Note you can only include 1 Wordpress Library gallery per post.
  2. In the 'Add Post' or 'Edit Post' screen click the 'Add an Image' button, above the main post text window.
  3. 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 SimpleViewer caption.
  4. You uploaded images will show in the 'Add an Image' -> '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'.
  5. Return to the post and click 'Save Draft' or 'Publish' to rebuild the new gallery. Clear your browser cache to see the updated gallery.

Editing a Gallery

To Edit XML options

  1. 'Edit' the WordPress post which contains the gallery you want to edit. Make a note of the gallery_id parameter in the simpleviewer gallery tag.
  2. Select the 'Edit Galleries' link in the 'SimpleViewer' 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 XML options in the Edit Gallery Screen.
  4. 'Edit' the WordPress post which contains the gallery and click 'Update'.

To Edit Embed Options

  • To change the gallery background color, width or height, edit the 'simpleviewer' tag directly in the 'Edit Post' text window.

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 an Image' button. Click the 'Gallery' tab to view, delete and re-order images. Click 'From Computer' to add new images.
    • Click 'Save all Changes' on the gallery tab, then close the Image pop-up and click 'Update' on the post to rebuild the new gallery. Clear your browser cache to see the updated gallery.

Upgrading to SimpleViewer-Pro

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

  1. Purchase and download SimpleViewer-Pro.
  2. Replace the svcore folder in the WordPress plugin folder with the one from the SimpleViewer-Pro download. To do this - upload the /web/svcore/ folder from the Pro download folder to the /wp-content/plugins/wp-simpleviewer/svcore/ folder inside your WordPress install folder.
  3. Clear your browser cache. If you do not see the 'SimpleViewer' 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"

Upgrading from WP-SimpleViewer v1.5.4

The new version of the plugin (v2) is completely re-written from scratch and is therefore not backward-compatible. This means that galleries made with the previous version of the plugin will not display once you upgrade. If you would like to continue to run the old version (v1.5.4) simultaneously with the new version (v2) do this:

  1. Download this version of the v1.5.4 plugin. This is the old plugin, renamed to 'WP-SimpleViewer-v1'.
  2. Unzip the file and upload the plugin folder into your WordPress blog's /wp-content/plugins/ directory.
  3. Activate the 'WP-SimpleViewer-v1' plugin through the 'Plugins' menu in WordPress
  4. Old galleries will now be displayed.

Support

WP-SimpleViewer is supported via an online forum. Before posting a new question, please search the forum to see if your question has already been answered.

Version History

2.2.0

  • Fixed Gallery Sizing Issues.
  • Multiple Flickr Tags
  • Fixed API support [Mobile Player]
  • Multiple bug fixes and enhancements.

2.1.3

  • Fixed Gallery Sizing Issues.
  • Fixed Compatibility with different jQuery versions.
  • Fixed Page zooming on mobile devices.
  • Multiple bug fixes and enhancements.

2.1.2

  • Added Universal Playback.
  • Supports SimpleViewer v2.1.2.
  • Multiple bug-fixes.

2.0.5

  • Added ability to delete galleries.
  • Fixed extra quotes in Pro options.

2.0.4

  • Supports SimpleViewer v2.0
  • Supports loading images from the WordPress Media Library or via Flickr.
  • Compatible with WP 3.0