[ Latest: Roster Slider Version 1.4.1 ; Compatible with WordPress 3.0 and above i.e. with latest version ]
Roster Slider is a highly customizable WordPress plugin that will help you adding a horizontal carousel (with single or multiple slides visible at a time) to your WordPress site's front page, other pages and posts.
The posts, pages and the media library images can be easily added to the slider thru the edit panel on the admin panel.
The slider can be easily inserted anywhere on the site either using a template tag in the respective template file or using Roster Slider shortcode or using a simple widget. Also you can create multiple sliders, so that you can display different content in slider on different pages.
The slider can be very easily customized using the easy admin panel options. You can also create your own beautiful implementation by just tweaking a few styles.
Index
Frequently Asked Questions
roster-slider.zip
folder.roster-slider
folder to your /wp-content/plugins
directory.<?php if ( function_exists( 'get_roster_slider' ) ) {
get_roster_slider(); } ?>
In case you use multiple sliders option,
<?php if ( function_exists( 'get_roster_slider' ) ) {
get_roster_slider('2'); } ?>
Where '2' is the slider ID
, which you can get from the 'Sliders' settings panel.
Put the below shortcode in the post/page editor to embed the Roster Slider in the post/page content.
[rosterslider]
In case you use multiple sliders option,
[rosterslider id='2']
Where '2' is the slider ID
, which you can get from the 'Sliders' settings panel.
You have got a 'Roster Slider Simple' widget on Widget administration panel. Just insert the widget in any of the active widget of your theme.
You can use the below template tag to display the posts under particular category in chronologically reverse order:-
<?php if ( function_exists( 'get_roster_slider_category' ) ) {
get_roster_slider_category($catg_slug); } ?>
Real World Example:
<?php if ( function_exists( 'get_roster_slider_category' ) ) {
get_roster_slider_category('social-media'); } ?>
where 'social-media' (don't forget the quotes) is the slug of the category from which you wish to pull the posts in reverse chronological order (latest is shown first).
Put the below shortcode in the post/page editor to embed the Roster Category Slider (Slider displaying Category specific posts in chronologically reverse order) in the post/page content.
[rostercategory catg_slug='social-media']
where 'social-media' (don't forget the quotes) is the slug of the category from which you wish to pull the posts in reverse chronological order (latest is shown first).
You can use the below template tag to display the recent posts added to your WordPress site/blog in chronologically reverse order:-
<?php if ( function_exists( 'get_roster_slider_recent' ) ) {
get_roster_slider_recent(); } ?>
Put the below shortcode in the post/page editor to embed the Roster Recent Posts Slider (Slider displaying latest posts on the blog in chronologically reverse order) in the post/page content.
[rosterrecent]
You can set the Slide transition speed, time between two transitions, Transition Effects, number of posts (slides) in the slider, background color, width and height of the content slides, border settings here.
Complete Slider Width : If you enter 0, the slider will take the width of the container. If you eneter numeric value greater than 0, it would be the width of the slider.
Slide (Item) Width : Width of each item in the Slide.
Slide (Item) Height : Height of each item in the Slide.
Here you can specify the main title of the slideshow, like 'Featured' or 'Recommended' or so on. By default it is 'Featured Slides'. Also you can change the font, color and looks of this title thru these settings.
These settings control the look of the title of the content in each slide.
These settings apply to the images extracted for the slides.
Image Pick Preferences : This setting indicates in what priority you want the images extracted for the post or the page. There are four entries, if all the checkboxes are checked that means the post/page will be scanned for the images in following sequence:
Say if you uncheck the 'Consider Images attached to the post ... Order of the Image attachment to pick ' checkbox, it will skip the step 3 above.
Say, if you do not want the scanner to look to thumbnails and featured image and just directly pick the image from the post content, just untick the first three boxes and keep the fourth box checked.
Other settings include, the alignment of the image (left, right or center), Image extract size, Display Image Size (width of the image, Original or Custom), Maximum Height of the Image and border settings.
You can tick the check box saying 'Make pure Image Slider' in case you want only images in the slides and no content.
Show content in slides below title : Checking this box will enable the content/excerpt to be displayed below the title of the slide. By default this is OFF.
You can customize the looks, font, color etc. of the Slide Content area here.
You can customize the looks, font, color etc. of the Slide Content area here.
You can choose how you would want the slider to pull the content i.e. 'From Post Content', 'Post Excerpt' or 'Slider Content Custom Field'. If you set it to 'Slider Content Custom Field', you should assign the value to 'slider_content' custom field as the content for the slide.
Maximum content size : You can specify the maximum content size in the slide either in number of characters or in number of words. The 'number of words' value if entered will override the 'number of characters' value. So if you want the maximum content size in 'number of characters' leave the 'numer of words' setting to blank (do not enter any value in it).
Retain these html tags : You can retain links and br tags in the slider posts. Against this settings, put all the html tags that you wish to retain in the 'Retain these html tags' input field. Put the tags in the following manner,
<br><a><p>
Do not separate them using commas, neither use ⁄ anywhere.
Continue Reading Text : Enter the value of the continue reading text here, default being 'Read More'. You can enter 'more...' or 'continue reading..' here or keep it blank in case you do not want any such link and text.
Minimum User Level to add Post to the Slider : This seeting indicates which users can add or remove the posts/pages/media images to the slider. You can give the permission to editors but not authors or keep the access restricted to the 'Administrator' from here.
Randomize Slides in Slider : You can randomize the slides added to the slider, so that everytime the page on which slider is embedded loads, the slides would appear in random order to the reader.
Text to display in the JavaScript disabled browser : If the Javascript support is disabled or JS is not supported by the visitor's browser, this text would be displayed to the visitor saying that here is a slideshow which you can view in proper format if you enable the JS support on your browser.
Roster Slider Styles to Use on Other than Post/Pages : You can creae your own styles for Roster Slider. From here you can select which stylesheet should be used on general templates (i.e. like index.php or category.php or archives.php) of your site (other than single posts and pages). For the sliders embedded on posts and pages, the stylesheet specified in this settings field would be default stylesheet, but you can individually select another stylesheet from the edit post/page panel for that specific post/page.
Multiple Slider Feature : Tick this box to enable the switch to create and embed 'multiple sliders'. Once this checkbox is ticked, you would get an option to create a new slider on the 'Sliders' admin page under 'Roster Slider' settings. Also, you can add posts to various created sliders and embed different sliders on different pages.
Enable FOUC : In case you tick this option, while the page with the slider is loaded, you can see the Flash of Unstyled content (i.e. the content in the slider will appear without any styling while the web page is loading). This box is uncheked by default, which means the complete slider with its content will be loaded at once when the complete DOM elements (html page) is ready and loaded.
Through this panel, you can remove the post/page/media image added to the slider directly or completely empty the slider. Also in case you enambe the 'Multiple Sliders Feature', you can create new sliders from this panel and delete the sliders.
Also, you can reorder the entries in the slider thru this settings panel.
From Roster Slider version 1.4 onwards, the custom fields (Post Meta) can be displayed after the post content in the Slide in Roster.
Go to Roster Slider 'Settings' => Miscellaneous settings => Custom fields to display for post/pages => Enter the custom field names separated by comma (,). Save the settings.
For example, you can enter value like item_number,item_price
The field will be displayed in a 'div' element with class equal to the field name. You can style the div as per your needs using CSS styles.
For the posts/pages/media images which will not have that custom field set, there will be no issue. The custom field div will not be displayed.
On the 'Settings' admin panel of Roster Slider, at the top you would see 'Create New Settings Set' button. Click the button, you would be asked to confirm that you need to create a new settings set
Once you create a new settings set, you would still be served the current settings. You can access and modify the new settings using the settings link on the right sidebar named 'Setting Panels'.
Before modifying the settings, do check on which settings panel you currently are. You can check this using the title of the Settings page which would be such as 'Roster Slider Settings Default', 'Roster Slider Settings 2' and so on
If you have created a lot of setting sets and now it has become a little confusing for you, you would need to delete the settings set. From version 1.4 of Roster Slider, you get an option to delete the created settings set.
On the 'Settings' admin panel of Roster Slider, go to the settings set that you wish to dlete. At the top you would see 'Delete this Set' button. Click the button, you would be asked to confirm that you really want to delete the settings set. If you click OK, the settings set will be deleted.
<?php if ( function_exists( 'get_roster_slider' ) ) {
get_roster_slider($slider_id='1',$set='2'); } ?>
In case you use multiple sliders option,
<?php if ( function_exists( 'get_roster_slider' ) ) {
get_roster_slider($slider_id='2',$set=''); } ?>
Where '2' is the slider ID
, which you can get from the 'Sliders' settings panel.
In case you enter ''
(empty) for the $set, it will take the default settings.
Put the below shortcode in the post/page editor to embed the Roster Slider in the post/page content.
[rosterslider set='2']
In case you use multiple sliders option,
[rosterslider id='2']
[rosterslider id='2' set='3']
Where '2' is the slider ID
, which you can get from the 'Sliders' settings panel and '3' is the ID of the settings created.
You can use the below template tag to display the posts under particular category in chronologically reverse order:-
<?php if ( function_exists( 'get_roster_slider_category' ) ) {
get_roster_slider_category($catg_slug,$set=''); } ?>
Real World Example:
<?php if ( function_exists( 'get_roster_slider_category' ) ) {
get_roster_slider_category($catg_slug='social-media',$set='2'); } ?>
where 'social-media' (don't forget the quotes) is the slug of the category from which you wish to pull the posts in reverse chronological order (latest is shown first).
Put the below shortcode in the post/page editor to embed the Roster Category Slider (Slider displaying Category specific posts in chronologically reverse order) in the post/page content.
[rostercategory catg_slug='social-media' set='2']
You can use the below template tag to display the recent posts added to your WordPress site/blog in chronologically reverse order:-
<?php if ( function_exists( 'get_roster_slider_recent' ) ) {
get_roster_slider_recent($set='2'); } ?>
Put the below shortcode in the post/page editor to embed the Roster Recent Posts Slider (Slider displaying latest posts on the blog in chronologically reverse order) in the post/page content.
[rosterrecent set='3']
(Feature availbale from Roster 1.4.1)
On Settings => Basic Settings tab => Miscellaneous => Feature Support Needed => Select 'Scroll Value will differ from Visible items value' => Save the Settings. After saving again go to Basic Settings tab => Basic Settings => Number of Items to Scroll in one transition => Enter 1 as the value and Save the settings. Now the slider displayed with this settings set will scroll one item on transition or autosliding.
On Settings => Basic Settings tab => Miscellaneous => Roster Template Tag for Preview => Select 'Category Slider' and for 'Preview Slider Params' => Category Slug in case of Category Slider => Enter the Category Slug of the category you would like to preview. To Preview the Custom Slider with ID 2, Roster Template Tag for Preview => Select 'Custom Slider with Slider ID' and for 'Preview Slider Params' => Slider ID in case of Custom Slider => Enter the Slider ID of the slider you would like to preview.
You should have FTP access to your site's folder in oredr to create your own styles.
Go to wp-content => plugins => roster-slider folder => css => skins
Create a new folder with a name say... 'custom'. Copy the content of 'sample' folder into 'custom' folder. Now go to custom folder => > style.css file. Open it with Notepad or Notepad++ or the editor you use to edit CSS files and modify/remove or add your own CSS rules. Also, you would need to add the CSS on Roster Slider Settings admin panel => Generated CSS => CSS Generated thru these Settings, for the CSS generated by a particular settings set (from Roster ver 1.4 and above).
Save the CSS file. Upload the complete custom folder to the server, inside the skins folder.
Now on the Roster Slider settings page => go to 'Miscellaneous' settings => You would get value as 'custom' in dropdown for the setting 'Roster Slider Styles to Use on Other than Post/Pages'. Select 'csutom' and save the settings.
As well, on Post/Page edit panel, you would get an option saying 'Stylesheet to use if slider is displayed on this Post/Page ' under 'Roster Slider' custom meta box. Select the value as 'custom' and save the post/page.
You can create any number of style folders as 'custom' and name them whatever you want.
Go to Edit Media thru Media => Library and open the image in edit mode. You would get an option to add the media image to the Roster Slider, you can assign the link URL to which the lside will link and you can also choose not to link a particular image to any URL.
In case you select multiple sliders option, you are able to create and embed different sliders with different content on various pages of your WordPress site. You may wish to have different Slider Titles for different sliders created (mostly when you are inserting the slider thru Roster Slider Widget). Yes, you can do that!!
When you create a new slider, you can give different names to different sliders created, which can be used as slide title. Go to Roster Slider 'Settings' => Slider Title settings => Pick Slider Title From => and select 'Slider Name' for the settings. Save the settings.
On the Edit Post/Page/Media image panel under Roster Slider fields, you would get an input field named 'Slide Link URL', you can input whatever URL you want the slide to link to in this field. Save the entry.
On the Edit Post/Page/Media image panel under Roster Slider fields, you would get an checkbox named 'Do not link this slide to any page(url)', you can uncheck the box to choose not to link the slide to any url. Save the entry.
Go to Roster Slider 'Settings' => Miscellaneous settings => Slide Link ('a' element) attributes => Append/Enter the necessay rel attribute like rel="nofollow" or so. Save the settings.
Go to Roster Slider 'Settings' => Miscellaneous settings => Slide Link ('a' element) attributes => Append/Enter the necessay target attribute like target="_blank" . Save the settings.
Template Tags
To skip the first five posts that would be displayed in the slider:-
<?php if ( function_exists( 'get_roster_slider' ) ) {
get_roster_slider($slider_id='2',$set='',$offset=5); } ?>
<?php if ( function_exists( 'get_roster_slider_category' ) ) {
get_roster_slider_category($catg_slug='social-media',$set='2',$offset=5); } ?>
<?php if ( function_exists( 'get_roster_slider_recent' ) ) {
get_roster_slider_recent($set='2',$offset=5); } ?>
Note: Remember to enter all the parameters in template tags, in case you are using offset parameter. This is because the template tags identify the parameters by order in which they are provided and not name.
Shortcodes
[rosterslider id='2' set='3' offset='5']
[rostercategory catg_slug='social-media' set='2' offset='5']
[rosterrecent set='3' offset='5']
Go to Roster Slider 'Settings' => Miscellaneous settings => Show Promotionals on Admin Page => and select 'No' for the settings. Save the settings.
Once you purchase the slider, you would be provided with a support ticket entry, to which you can reply anytime if you get any issue while implementing the plugin.
Please read the licensing terms at http://slidervilla.com/licensing/
This plugin is copyrighted to Tejaswini Deshpande.
2010 – 2011 © SliderVilla. All rights reserved.