WordPress.org

xili-floom-slideshow integrates the Floom slideshow in wordpress theme.

Floom slideshow designed by Oskar Krawczyk under MIT license is wonderful and amazing. For integration inside wordpress, it can be awesome ! xili-floom-slideshow tries to install it automatically but also allows personalizations.

How it works ?

xili-floom-slideshow inserts the javascript and css file inside the header of the theme. The images attached (but not inserted) to a post (or a page) are listed for the slideshow. And after adding a [xilifloom] shortcode inside the content of the post, the slideshow of the images of the gallery are automatically displayed. With the dashboard Settings page, it is possible to change some properties of the slideshow without changing the original javascript: by example, number of vertical 'venitian' blinds, speed, progress bar, visible captions, and more. Some properties can be attached to one post by using custom fields and to one shortcode by using params.

new 1.2 (2013-05-24)

• caution message in js if images unavailable, __construct - tests 3.5.1 & 3.6

1.1 (2012-07-22)

• by default display full size of attached images. But can also display other sizes as define by default (large, medium, thumbnail) or those set with add_image_size( 'my-size-example', 600, 210 ); function. Use 'floom_image_size' in custom post field or 'image_size' param in Shortcode.
• example of shortcode [xilifloom image_size="my-size-example"]. Be aware that current css is adapted !

roadmap

• style according image_size,
• default settings screen.

from 0.9.x to 1.0

• New xili wiki
• enable now to have more than one slideshow displayed one resulting webpage. Need a minimum of knowledges in WP (shortcode), CSS, JS to activate these "flooms" and avoid bad side effects when more than one slideshow.
• BE AWARE : now xili-floom-slideshow needs that theme have both wp_head() (as before) AND wp_foot() template tags in header and footer as in default theme like twentyten or twentyeleven or the most current well designed.
• Improved filter xili_floom_get_values has now 2 params : developers must read source.
• multiple flooms example here !
• OOP new source code
• new like function because changes in WP 3.0 when naming file and slug of attachment images. Possible to choose post column (post_name or guid or…) to sub-select with floom_subname postmeta
• developers using global $xilifloom_name_selector must change to function set_xilifloom_name_selector() - see code at end of source
• compatibility with child theme as visible in new theme of dev.xiligroup.com - child example of default twentyten -
• add thumbnail bar with shortcode [xilifloombar]
• Gold parameters added : ready to integrate a new child class of Floom see this post. Open to better events exchanged with theme UI. More modularity and possibility of setting. (Gold options are reserved for theme designer and webmaster with sufficient knowledge in php, js,...)
• CAUTION: after upgrading, if floom_subname is used in custom fields of some posts, to retrieve the images series, the wildcard must be wrapped with one or two chars '%' as in LIKE of sql query.
• add for pictures order by menu_order. If order is set in gallery linked to a post, displayed series is ordered by these numbers ascendant.
• more parameters.
• add hooks and filters : to allow better selection of floom values and choice of series of images (not necessary attached to a post) according the theme or cms architecture, two filters was added : xili_floom_get_values and xili_floom_get_images insertable in functions inside functions.php of the current theme. Very useful to personalize header according place inside the site architecture. example

prerequisite

• Minimun knowledges in WordPress architecture (and css).
• If others plugins use mootools framework, some modifications must be done through a added function named xilifloom_theme_header() inside functions.php - see source.
• Images for a slideshow must be selected with great precaution. (Same size adapted to the frame)