Blip recognizes the following shortcodes:
- [blip-slideshow] – the Blip Slideshow shortcode.
- [blip_slideshow] – if you are still using WordPress 2.9 or earlier, you should use an underscore instead of a hypen for the Blip Slideshow shortcode.
- [slideshow] – (deprecated) because of the potential for another plugin on your site to also define a conflicting [slideshow] shortcode, it is recommended you use instead.
Blip recognizes the following options in the
- captions – (boolean: default true) Whether to show captions.
- center (0.2 and higher) – (boolean: default true) Whether the show should attempt to center images.
- color (1.2 and higher) – (string: default “#FFF”) colours (separated by commas) to cycle through for the flash slideshow
- controller – (boolean: default true) Whether to show controller.
- delay – (integer: default 2000) The delay between slide changes in milliseconds (1000 = 1 second).
- duration – (integer: default 750) The duration of the effect in milliseconds (1000 = 1 second).
- fast – (boolean or integer: default false) Affects how the show behaves when the user is navigating via the controller or keyboard: if false/0 the show will always use transitions; if 1 the show will skip transitions if paused; if true/2 the show will skip all transitions and update the slide change instantly.
- height – (integer) Optional height value for the show as a whole integer, if a height value is not given the height of the default image will be used. If you change the height of the default slideshow, you must use CSS to match the height of div.slideshow as well.
- id – (string: default internally managed) Specify the <slideshow> element id here when you have two or more slideshows in the same page and wish to style each one individually. Remember, CSS dictates that element id’s must be unique per page!
- link (0.2 and higher) – (boolean or string: default full) Determines what happens when a slideshow image is clicked:
- full or true – Links each slide to the fullsize image, useful when mashing Slideshow with Slimbox, Lightbox, etc.
- lightbox (0.3 and higher) – Links each slide to a WordPress Lightbox plugin. Requires Slimbox or WP-Slimbox2.
- none or false – Disables hyperlinking altogether.
- href – Links to the permalink given in the RSS, e.g. the original SmugMug or Flickr gallery.
- link=http://www.someurl.com/ links to the specified URL
- loader – (boolean: default true) Show the loader graphic for images being loaded.
- loop – (boolean: default true) Should the show loop.
- overlap – (boolean: default true) Whether images overlap in the basic show, or if the first image transitions out before the second transitions in.
- pan (1.2 and higher) – (integers: default “100, 100″) controls the pan positioning for the Ken Burns slideshow
- paused – (boolean: default false) Whether the show should start paused.
- random – (boolean: default false) Random show, combined with thumbnails equals very cool!
- resize (0.2 and higher) - (boolean or string: default “fill”) Whether the show should attempt to resize images, based on the shortest side (default) or longest side (“fit”) or resize without preserving proportions (“stretch”). Set to false to disable image resizing.
- rss – (string: default is the internal slideshow) The media RSS feel URL to load. Currently supports SmugMug, Flickr and MobileMe feeds only.
- slide – (integer: default 0) Slide from which to start the show.
- thumbnails – (boolean: default false) Whether to show thumbnails.
- titles – (boolean: default false) Whether to use captions for image and thumbnail title attributes.
- transition (1.2 and higher) – (string: default “sine”) transition to use with base and push type shows
- type (1.2 and higher) – (string: default “base”) the type of slideshow
- flash – Flash (see the color option)
- fold – Fold
- kenburns – Ken Burns (see the pan and zoom options)
- push – Push (see the transition option)
- width – (integer) Optional width value for the show as a whole integer, if a width value is not given the width of the default image will be used. If you change the width of the default slideshow, you must use CSS to match the width of div.slideshow as well.
- zoom (1.2 and higher) – (integers: default “50, 50″) controls the zoom positioning for the Ken Burns slideshow
Here is an example of the slideshow shortcode with all the options:
[slideshow captions=true center=true controller=true delay=2000 duration=750 fast=false height=300 id=myShow link=full loader=true loop=true overlap=true pan="100, 100" paused=false random=false resize=fill slide=0 thumbnails=true titles=false transition=sine type=base width=400 zoom="50, 50"]