WP-ImageFlow2 Wordpress Plugin
Display nice looking ImageFlow galleries within posts and pages. Link each image to either a Lightbox preview or an external URL. The Lightbox pop-up supports cycling through all the photos – left/right arrows appear when hovering over the photos.
NEW FEATURES
- Provide an option to start at a specific slide number
- Provide an option to turn on/off rotate for each instance of a gallery
- Support full text description in the popup window of a built-in gallery
- Support full path for gallery directory
There are two ways to insert such a gallery.
1. Use the built-in Wordpress media library use the shortcode [wp-imageflow2]
2. Upload your pictures to a subfolder and use the shortcode with dir argument [wp-imageflow2 dir=FOLDERNAME]
You may configure the background color, text color, container width and choose black or white for the scrollbar. Auto-rotation of the images is now supported.
When using the built in Wordpress gallery, the photo title will be displayed below each image. When using a subfolder gallery, the image name will be displayed below each image. For a built-in gallery, the image may link to either the large size image or an external url.
Auto Rotation
When auto rotation is enabled, the images will automatically rotate through the carousel. You may configure the pause time between rotations. Once the end of the gallery is reached it flows back to the beginning and starts again. The rotation will pause when the mouse hovers over the bounding div. Once an image is clicked and expanded into the Lightbox display the auto rotation is suspended.
Installation
- Download Plugin and unzip.
- Copy the Plugin Folder in your WordPress-Installation.
- Activate the Plugin in your WP-Admin.
- Choose your configuration settings.
Using the built-in Wordpress library:
- Upload images using the Wordpress image uploader on your post or page or into the media library. Enter a title to display, and optionally enter a description that may be used as an external link.
- Use the shortcode “wp-imageflow2” anywhere in the post or page
- If you want the image to link to an external url, enter the url in the description field of the image (as http://www.website.com) and enable the checkbox in the options. If the description field does not contain an url, the image will link to the full size popup image with the description (if any) displayed as text below the image.
These standard gallery options may be used:
- id
- order (default is ASC)
- orderby (default is menu_order ID)
- include
- exclude
- size (applies to RSS feed only)
These additional WP-Imageflow2 specific options may be used:
- mediatag – Corresponds to Media Tags plugin by Paul Menard. This option will pull matching media out of your media library and include it in the gallery. Example use:
mediatag=mymedia - startimg – Gives the starting slide number to center in the gallery, the default is 1.
- rotate – Turns on/off auto-rotation for this instance (overrides the setting from the admin panel). Values are ‘on’ or ‘off’.
For galleries based on a subfolder:
- Create a folder for your galleries within your WordPress installation, wherever you want. The location has to be accessible from the internet – for example you could use wp-content/galleries.
- Upload your image galleries to a subfolder of this folder, for example you might upload your images under “wp-content/galleries/subfolder“.
- Set the “Path to galleries from homepage root path” in the settings admin page for WP-ImageFlow2. Enter the path with trailing slash like: “wp-content/galleries/“. NEW – alternatively you may also enter the full path like “http://www.mywebsite.com/wp-content/galleries/” – this works around problems on some server configurations. Note that the gallery must reside on the same server as the blog. If you have entered the gallery path correctly you will see a list of the sub-directories on the settings page.
- Insert a gallery on a page by specifying the shortcode “wp-imageflow2 dir=subfolder” on your post or page.
This gallery style will display the image names as the captions, and will link to the full size image.
These WP-Imageflow2 specific options may be used:
- startimg – Gives the starting slide number to center in the gallery, the default is 1.
- rotate – Turns on/off auto-rotation for this instance (overrides the setting from the admin panel). Values are ‘on’ or ‘off’.
Inserting a gallery into a template
You can insert any shortcode into a template using the following (enclosed in standard PHP tags):
echo do_shortcode('[shortcode option1="value1" option2="value2"]');
Notes
- If your reflected images don’t show up, you might have a server that generates 404 errors on the reflected images. In this case select the option in the settings for strict servers.
- If you are upgrading from 1.3.1 or prior and you used custom styling on your wp-imageflow2 divs, you must update your custom styles:
- The main WP-ImageFlow2 divs are now CLASSes instead of IDs in order to support multiple instances, so any custom styling must be changed from #wpif2… to .wpif2…
- If you are upgrading from 1.2.6 or prior, you must edit your gallery shortcodes:
- Use “wp-imageflow2″ shortcode instead of “gallery”
- Use”wp-imageflow2 dir=SUBFOLDER” shortcode instead of “wp-imageflow2=SUBFOLDER”
How can I help support this plugin?
A donation to support this plugin would be greatly appreciated. I also appreciate a rating on the Wordpress plugin directory.
Versions
Version 1.6.2 (May 17, 2010)
- Fix bug when gallery has only one image
Version 1.6.1 (May 14, 2010)
- Support directory paths specified as URLs to provide support to more server configurations
Version 1.6.0 (May 13, 2010)
- NEW FEATURE – Provide an option to start at a specific slide number
- NEW FEATURE – Provide an option to turn on/off rotate for each instance of a gallery
- NEW FEATURE – Support full text description in the popup window of a built-in gallery
- Handle files with special characters in the name
Version 1.5.4 (May 7, 2010)
- Fix potential conflict
Version 1.5.3 (May 7, 2010)
- Fix dragging the scrollbar on galleries beyond the first on a page
- Update overlay div creation
Version 1.5.2 (May 4, 2010)
- Fix rotation issue with Internet Explorer
Version 1.5.1 (May 4, 2010)
- Fix black slider on built-in galleries
Version 1.5.0 (May 3, 2010)
- Support gallery based on Media Tags (plugin by Paul Menard)
- Support auto-rotation (default is disabled, enable using the settings page)
Version 1.4.9 (April 17, 2010)
- Fix the slider styling added in 1.4.8 – it caused other problems.
Version 1.4.8 (April 16, 2010)
- Use stronger styling on slider to override some theme styles
- New option – to be used on servers with more secure settings to prevent reflected images generating 404 errors
- Fix Lightbox when last image in gallery has an external link
Version 1.4.7 (April 14, 2010)
- Drop Scriptaculous library since it clashes with MooTools, now only uses the basic jquery library
- Support transparency as a background colour. In this case the image reflections will be black over a transparent div.
Version 1.4.6 (April 13, 2010)
- Define PHP_EOL if not found
- Fix black scrollbar
Version 1.4.5 (April 13, 2010)
- Fix dragging scroll bar (don’t know how I missed that one!)
- Hide dashed outline of prev/next links in Lightbox on Firefox
Version 1.4.4 (April 11, 2010)
- Admin menu – fix possible missing text
Version 1.4.3 (April 11, 2010)
- Fix class on outer div.
Version 1.4.2 (April 9, 2010)
- Improve image path construction for galleries based on a subdirectory, to hopefully work on all servers.
Version 1.4.1 (April 8, 2010)
- Fix captions when cycling through the Lightbox view
Version 1.4 (April 8, 2010)
- Support multiple instances of WP-Imageflow2 galleries on a single page. You must update your custom styles when updating from a previous version (see Installation notes).
- Lightbox pop-up now supports cycling through the images directly with left/right arrows appearing when hovering over the photos.
- Fix color-code check in settings page (broken on version 1.2)
- Style changes in the method used to display the flow gallery – should be compatible with more themes
Version 1.3.1 (March 26, 2010)
- Fix potential loading issue in IE
Version 1.3.0 (March 25, 2010)
- New shortcode method: [ wp-imageflow2 ] for the built-in gallery and [ wp-imageflow2 dir=subdir ] for a subdirectory
- Dropped support for prior shortcode method
- Organize code into a class to prevent potential collisions with other plugins
- General code clean-up
Version 1.2.6 (March 10, 2010)
- Fix issues on legacy version of Internet explorer
Version 1.2.5 (March 7, 2010)
- Fix overlay size and position on scrolled screens
Version 1.2.4 (March 5, 2010)
- Fix problem with include/exclude built-in gallery options
Version 1.2.3 (March 4, 2010)
- Use a different method to extract image info so it works on servers with url access disabled
Version 1.2.2 (March 2, 2010)
- Remove the need for PHP 5
- Add option to turn off reflections (if your server doesn’t support GD or you just don’t want them)
Version 1.2.1 (February 18, 2010)
- Add a “close” link to the overlay div of the image Lightbox in case the full size image never loads
Version 1.2 (February 16, 2010)
- Use a Lightbox effect for the large size image display rather than opening a new window
- Don’t load scripts on admin pages
- Trim spaces from the galleries url entered on the settings page
- Display simple thumbnail gallery on browsers with Javascript disabled
Version 1.1 (February 8, 2010)
- Fix problem with image paths on some servers
Version 1.0.1 (February 3, 2010)
- Fix typo in readme.txt
Version 1.0 (January 29, 2010)
- Initial version
Credits
- Easy Reflections by Richard Davey
- ImageFlow javascript version 0.9 by Finn Rudolph
- The discontinued WP-ImageFlow plugin by Sven Kubiak
Jules – Maybe there is a conflict with your theme or another plugin.
Hi Bev,
Firstly, tanks for a great plug-in!
I’m having some issues displaying some of the galleries. I’m using NextGEN to create the folders with images – wp-content/gallery/ as standard. However, with some galleries, all I get is a small band with a question mark on the carousel – once you click on the images they display fine.
Do you know why this might be? Is it a height/width issue. It only appears on some of the images – although all are resized to 700px width before I add them.
Any ideas would be greatly appreciated!
Thanks,
Oli
Hi Bev,
I just figured out what the problem was – some of my image filenames had the wrong characters in – ( , – etc. I removed them and now all is good.
On another question, is there a way to remove both captions from the Lightbox when clicked? I have added a line in my css to remove one, but ideally not like to see any filename there.
Best,
Oli
Hi Bev,
I am a bit new to Wordpress customization and I was wondering how I can center my Wp-Imageflow2 gallery on the page? When I search the templates, I am finding center in a number of locations and I can’t seem to find on that centers the entire gallery on the page. Can you help? Thanks and thanks for a terrific plugin!
Yos
Hi Oli, I’m glad you resolved your image name issue. I plan to make a new release to address the issue of double titles in the near future.
Hi Yos, Centering your gallery really depends on your theme. You likely need to add css to center the class “wpif2_imageflow” to your theme’s style.css
I love your plugin. I wanted to see how I could put multiple galleries on one page? I want to have a page with each month having it’s own gallery. I can only get this code to work: [wp-imageflow2] I can’t get the: [wp-imageflow2 dir=FOLDERNAME] code to work. The subfolders path is: wp-content/galleries/August2010 so I tried putting this path on the plugin info on WP and putting the code: [wp-imageflow2 dir=August2010]on the page but it won’t work. Thanks for your help.
Hi Mike. Your settings page should have “wp-content/galleries/”. The plugin will then find all directories below there and list them for you on the settings page.