Add a jQuery Coda slider to any WordPress post or page
PHP JavaScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
css
images
js
lib
README.md
wpcodaslider.php

README.md

WP-Coda-Slider

##Plugin Name Contributors: c3mdigital
Tags: coda slider, featured content, featured content slider, jquery, coda slider, js, no conflict, shortcode, coda, panic slider Donate link: http://c3mdigital.com/donations/
Requires at least: 3.0
Tested up to: 3.4
Stable tag: 0.3.2

Add a jQuery Coda Slider to any WordPress post or page configured with custom metabox options or shortcodes

###Description

WP Coda Slider is a plugin that adds Niall Doherty's jQuery Coda-Slider v2.0 plugin to WordPress using shortcodes a custom metabox on the post edit screen with all options to insert a slider.

###Demo:

The WP Coda Slider Demos can be found at http://c3mdigital.com/wordpress/wp-coda-slider/demo

###Metabox Options

All options to configure individual sliders are available through custom meta boxes on all WordPress posts and pages

###Shortcode: The short code accepts the following arguments: id, cat, show, args. id= a unique name for each slider that will be assigned as the div id cat= the category containing the posts to display in the slider show= the number of posts to show in the slider args= the settings for the slider which can be found at http://www.ndoherty.biz/forums/viewtopic.php?f=4&t=2 Please Note: the args in the shortcode must be wrapped with double quotation marks to work.

###Example:

[wpcodaslider id=myslider cat=4 show=6 args="autoSlide:true, dynamicTabs:false, autoSlide:true"]

This would add a slider with the <div id="myslider"> showing 6 posts from the category id of 6 with dynamic tabs set to false, auto slide set to true with an autoslide interval of 8000 milliseconds.

###Template Tag

Add <?php if ( function_exists('c3m_wpcodaslider') ){ c3m_wpcodaslider($id, $cat, $show, $args);} ?>

to any of your themes templates.

you must supply the variables when you add the function to your template.

<?php if ( function_exists('c3m_wpcodaslider') ) { c3m_wpcodaslider('myslider', '81', '4', 'dynamicArrows:false');} ?>

this would add a slider with the id of myslider and show 4 posts from category 81 with dynamic arrows set to false. all the variables must be present and in the same order.

###Installation

  1. Upload the wp-coda-slider folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Add shortcode to any post or page you want to display your slider on. Make sure to specify the category id, slider id(each slider requires you to give it a unique id) and the number of posts to show. ie: [wpcodaslider id=myslidername cat=4 show=3 args="autoSlide: true"] This would display a slider containing the first 3 posts in a category with the id of 4 with autoslide set to true.

Shortcode & Template tag args:

The args= is optional.(For the template tag you must supply at least one arg)
If none are set the plugin will use the default values specified below:

Here is a full listing of settings you can add to args=

autoHeight Values: true, false, 1, 0 Default: true Description: Dynamically adjusts slider height according to the height of the content in each panel. Notes: If set to false or 0, the height of the slider will be set to the height of the tallest panel.

autoHeightEaseDuration Values: Any amount of milliseconds. Default: 1000 Description: Duration of autoHeight easing effect. Notes: Ideally, this should use the same value as slideEaseDuration (see below). Depends on autoHeight being set to true or 1.

autoHeightEaseFunction Values: See Robert Penner's Equations Visualizer for the full list. Default: "easeInOutExpo" Description: Easing method used for autoHeight effect. Notes: Value must be enclosed in quotes. Depends on autoHeight being set to true or 1.

autoSlide Values: true, false, 1, 0 Default: false Description: Specifies whether slider should move between panels automatically.

autoSlideInterval Values: Any amount of milliseconds. Default: 7000 Description: Time to wait before auto sliding. Notes: Depends on autoSlide being set to true or 1.

autoSlideStopWhenClicked Values: true, false, 1, 0 Default: true Description: Determines whether the autoSlide function should stop when user interacts with the slider. Notes: Depends on autoSlide being set to true or 1.

crossLinking Values: true, false, 1, 0 Default: true Description: Allows permalinking to each slider panel via a URL hash (e.g. http://www.myslider.com/#4). Notes: Works best if autoSlide (see above) is disabled. Only numbers can be used for the hash values; they are automatically generated by the script. If this cross-linking is enabled and a valid URL hash is presnt, and setting specified for firstPanelToLoad (see below) will be overruled.

dynamicArrows Values: true, false, 1, 0 Default: true Description: Places left and right buttons alongside the slider. Notes: Set this to false or 0 and you can still hardcode the left and eight buttons in the HTML, giving you more flexibility with positioning. See Example 4 in the demos.

dynamicArrowLeftText Values: Anything you want. Default: "« left" Description: The anchor text used for the dynamic "slide left" button. Notes: Depends on dynamicArrows being set to true or 1.

dynamicArrowRightText Values: Anything you want. Default: "right »" Description: The anchor text used for the dynamic "slide right" button. Notes: Depends on dynamicArrows being set to true or 1.

dynamicTabs Values: true, false, 1, 0 Default: true Description: Adds tabbed navigation to the slider. Notes: panelTitleSelector (see below) lets you specify what anchor text is used in each tab.

dynamicTabsAlign Values: "center", "left", "right" Default: "center" Description: Specifies the horizontal alignment of the tabbed navigation, relative to the slider. Notes: Depends on dynamicTabs being set to true or 1. Value must be enclosed in quotes.

slideEaseDuration Values: Any amount of milliseconds. Default: 1000 Description: Duration of slide easing effect. Notes: Ideally, this should use the same value as autoHeightEaseDuration (see above). Depends on autoHeight being set to true or

slideEaseFunction Values: See Robert Penner's Equations Visualizer for the full list. Default: "easeInOutExpo" Description: Easing method used for slide effect. Notes: Value must be enclosed in quotes.

###Frequently Asked Questions

####Whats new in version 0.3? 0.3 is a complete code rewrite. You will now find a metabox on your post and page screens that give you complete control of all the slider options. Once configured the slider will be automatically added to the page. CSS options: You can control the css using the options and can even include a block of custom css.

shortcodes are deprecated but will still work as before

existing template tag function has been deprecated and replaced with a new one. The new one takes the arguments as an array.

####What does the id argument do?

The id argument is the div id that will be assigned to the slider. Make sure each slider has a unique id.

####What is the cat argument? This is the WordPress post category the slider will pull from and display in your slider.

####Where can I use the shortcode? The short code will work on posts, pages, and Wordpress 3.0 custom post types.

####How can I change the style of the slider or modify the width? Open the coda-slider-2.0.css located in the css folder of the plugin and make any changes you wish. The CSS file is well documented on where changes can be made.

####Where can I find all the values available for the shortcode args? The full description of the shortcode arguments can be found on the orginal jQuery plugin page at: http://www.ndoherty.biz/forums/viewtopic.php?f=4&t=2

####Where can I get support or help? Support will be provided on the WordPress.org support forums and may also ask for support at http://wp-performance.com/wp-coda-slider/

###Screenshots###

See demo at: http://c3mdigital.com/wordpress/wp-coda-slider/demo

###Changelog

####0.3.2 Complete code rewrite. All slider options are now available through a custom metabox added to each WordPress post and pages. jQuery easing plugin enqueued separately to avoid conflict with other plugins that use jQuery easing shortcodes have been deprecated. They will still work as before but will no longer be supported template tag function has been deprecated. It will still work as before but will no longer be supported. Next version will include a new template tag function

####0.2.5 Fixes the shortcode inside a shortcode bug Props: Morten Ydefeldt

####0.2.4 Updated query strings to arrays. This won't change anything for most users.

Please Note: The next version will see a complete code rerwite. If you rely on this plugin please plan accordingly. Current short tags will continue to work in the next version but template tags will be deprecated with a new options API to replace ####0.2.3 Bug fixes: Fixed documentation error for template tag function call Props:Bira Fixed path to ajax-loader.gif Props:shootingstar.co.uk Added direction:ltr; to css for compatability with rtl languages Props:Bira

####0.2.2.1 Add a template tag method to call the slider to use when calling posts that contain other shortcodes.

####0.2.1 Added the description for the arguments in the shortcode

####0.2 Fixed the readme file to display full description

####Upgrade Notice

= 0.2.2.1 = Upgrade to have option to use template tags or shortcodes. Using template tags allows posts containing other shortcodes to work.

= 0.2.1 = Please upgrade and check the readme.txt file for a full description on using the plugin shortcode arguments

= 0.1 = Hey this is the first version. No need to upgrade until a new version comes out