JJ NextGen JQuery Carousel

The ‘JJ NextGen JQuery Carousel’ allows you to create a ‘JCarousel’ (http://sorgalla.com/projects/jcarousel/) as a widget or as a shortcode.
This plugin uses the ‘NextGen Gallery’ plugin for its images.

Requirements:

• NextGen Gallery Plugin (https://wordpress.org/extend/plugins/nextgen-gallery/)

NextGen Gallery Integration:

• This plugin uses the original width and height of the image uploaded so make sure the images are the correct dimensions when uploaded.
• If a width and height are defined under the configuration all images will be resized to those dimensions (Highly recommended).
• Alt & Title Text Field: Provide a full url here and the image will link to this. Only works if alt field starts with either of these; /, http, or ftp.
• Description Field: Will be used as image alt text. If alt text is present but not a valid url alt text will be used instead for image alt text.

You can specify the following parameters:

NOTE: sc means shortcode:

• Title: Title. Leave blank for no title. (sc: title=”My Carousel”)
• Gallery: Leave blank to use all galleries or choose a gallery to use. (sc: gallery=”galleryid”)
• Order: Order to display results in. You can choose; Random, Latest First, Oldest First, or NextGen Sortorder. Random will still work when a page is cached. (sc: order=”random”|”asc”|”desc”|”sortorder”)
• Shuffle: If order is random and this is true will shuffle images with javascript. Useful if your are caching your pages. (sc: shuffle=”true”|”false”)
• Max pictures: The maximum amount of pictures to use. (sc: max_pictures=”6″)
• HTML id: HTML id to use. Defaults to ‘jcarousel’. Needs to be different for multiple instances on same page. (sc: html_id=”jcarousel”)
• Skin class: Class of skinning to use. Defaults to use the tango skin. (sc: skin_class=”jcarousel-skin-tango”)
• Image width: Width of image. Defaults to 75. (sc: width=”200″)
• Image height: Height of image. Defaults to 75. (sc: height=”150″)
• Image gap: Gap between images. (sc: gap=”5″)

JCarousel settings:

Please check the JCarousel home page for more details (http://sorgalla.com/projects/jcarousel/#Configuration).

• vertical: Specifies wether the carousel appears in horizontal or vertical orientation. Changes the carousel from a left/right style to a up/down style carousel. (sc: vertical=”setting”)
• rtl: Specifies whether the carousel appears in RTL (Right-To-Left) mode. (sc: rtl=”setting”)
• start: The index of the item to start with. (sc: start=”setting”)
• offset: The index of the first available item at initialisation. (sc: offset=”setting”)
• size: Size of existing elements if size is not passed explicitly uses the number of total items. (sc: size=”setting”)
• scroll: The number of items to scroll by. (sc: scroll=”setting”)
• visible: If passed, the width/height of the items will be calculated and set depending on the width/height of the clipping, so that exactly that number of items will be visible. (sc: visible=”setting”)
• animation: The speed of the scroll animation as string in jQuery terms (“slow” or “fast”) or milliseconds as integer (See jQuery Documentation). If set to 0, animation is turned off. (sc: animation=”setting”)
• easing: The name of the easing effect that you want to use (See jQuery Documentation). (sc: easing=”setting”)
• auto: Specifies how many seconds to periodically autoscroll the content. If set to 0 (default) then autoscrolling is turned off. (sc: auto=”setting”)
• wrap: Specifies whether to wrap at the first/last item (or both) and jump back to the start/end. Options are “first”, “last”, “both” or “circular” as string. If set to null, wrapping is turned off (default). (sc: wrap=”setting”)

Shortcode Examples:

• [jj-ngg-jquery-carousel html_id=”about-jcarousel” gallery=”1″]
• [jj-ngg-jquery-carousel title=”Hello” html_id=”about-jcarousel” gallery=”1″ vertical=”true”]
• [jj-ngg-jquery-carousel html_id=”about-jcarousel” gallery=”2″ width=”150″ height=”100″ visible=”2″ scroll=”1″ auto=”3″]

Try out my other plugins:

• JJ NextGen JQuery Slider (https://wordpress.org/extend/plugins/jj-nextgen-jquery-slider/)
• JJ NextGen JQuery Cycle (https://wordpress.org/extend/plugins/jj-nextgen-jquery-cycle/)
• JJ NextGen Unload (https://wordpress.org/extend/plugins/jj-nextgen-unload/)
• JJ NextGen Image List (https://wordpress.org/extend/plugins/jj-nextgen-image-list/)
• JJ SwfObject (https://wordpress.org/extend/plugins/jj-swfobject/)

Contributors