Created: 2012-02-28, revision 4
By: Web factory Ltd
Support: via CodeCanyon
Thank you very much for purchasing our WordPress plugin. If you have any questions that are beyond the scope of this help file, please feel free to email us via our user page contact form. Have a good one!
<?php the_featured_posts_slider(); ?> under your menu or on any other appropriate place depending on your theme's layout.After positioning the FPS in your theme, using it very easy. Be sure to select a featured image for each of your posts because otherwise FPS won't know what image to associate with it. If you're displaying the latest content there's no need to manually select featured posts. The slider will simply show the last n posts. If you're displaying featured posts be sure to mark all content as featured that should be displayed in FPS.
All options are easily configurable via the options GUI and have inline help.
Global FPS options are configured in WP Admin – Appearance – Premium Featured Posts Slider.
| Option name | Description | Default |
| Width | Slider container width - this option has to be configured. Set the value according to your theme layout. Any CSS parsable value is accepted. We don't recommend using "100%". | 600px |
| Slider Content | You can feature content that's been manually selected or use the latest content. This option has full support for custom post types and custom taxonomies. | latest posts |
| Number of Slides | Number of posts shown in slider. If the number of "featured" posts is greater than "number of slides" the later will take precedence. | 5 |
| Thumbnail Size | List of thumbnail sizes your theme supports. Select the size that best fits your site's layout and selected FPS layout. FPS registers it's own additional thumbnail size which can be customized. Thumbnail size can be chosen on a per-post basis while editing individual posts. Once the size is changed you have to re-build or re-upload the images. We suggest using Image Sizes Manager. |
medium |
| Layout | FPS comes with 6 predefined layouts:
|
layout 2 |
| Auto Generate Previous and Next Buttons | If checked previous and next buttons will be placed on left and right edges of the slider. | enabled |
| Auto Generate Pagination Buttons | Choose from two pagination types below the slider: circles and thumbnails; or disable pagination. | circles |
| Autoplay | Time between each automatic slide switch. | 5 seconds |
| Transition Effect | Effect used for transitioning between slides - slide or fade. | slide |
| Transition Effect Speed | Duration of transition effect/animation in milliseconds. | 350 milliseconds |
| Stop on Hover | If checked autoplay will be stopped once user hovers over the slider. | enabled |
| Randomize | Randomize slides order. By default they are orderd by publishing date, descending. | disabled |
| Include CSS | If you wrote your own CSS for slides or copy/pasted our CSS code into some other file then disable this option, otherwise leave it enabled. | enabled |
| Include jQuery | If your theme doesn't already have jQuery included enable this option to have FPS include it. | disabled |
| Include Slides JS | If your theme already has Slides JS included uncheck this option. | enabled |
| Shortcode Name | Write only the shortcode name, without brackets. If the shortcode name you want is already taken you'll be notified after saving. | fps |
| Additional Image Size | Width, height and cropping option for FPS custom image size. Please note: changes to image size are not "retroactive" meaning they will only affect newly uploaded images. Use Image Sizes Manager to re-build images. | 330x330px, cropped |
| Pagination Thumbnail Image Size | Width and height option for FPS navigation thumbnail image size. Please note: changes to image size are not "retroactive" meaning they will only affect newly uploaded images. Use Image Sizes Manager to re-build images. | 50x50px |
| Show Slider | If you want FPS shown only on certain pages but you placed FPS code in ie header.php set this option to enable conditional display on selected pages. | always display FPS |
Per-post (page / custom post type) options are configured while editing and creating new content. Three variables can be set:
In post / page / custom post type list (table) you'll see a new column "Featured". By checking / unckecking the checkbox for a selected post you'll mark it as featured / not featured.
When writing custom layout code you can use the following variables. The code itself is plain HTML. Please note that the code you enter is the code for a single slide not the whole slider. To get some ideas how to write code look at the code of 6 predefined layouts.
FPS features two theme functions:
Both functions have no parameters so in most cases to implement FPS in your theme use:
<?php the_featured_posts_slider(); ?>
FPS shortcode ([fps]) is basically just a wrapper for the_featured_posts_slider() function. You can use it in text widgets to enable FPS. If you have a widget area in site's header implementing FPS is merely a matter of using the shortcode in a text widget.
If your site's front-page is a static page you can of course put the shortcode in that page.
FPS comes with two PSD files: fps-arrows.psd and fps-pagination.psd. First one contains the left and right navigation buttons, and the second one active and non-active pagination bullets that are usually placed below the slider.
FPS will not custom style your slides! It uses default WordPress CSS classes which your theme should already have defined such as post and entry title. It's alsoimportant that you choose the right image size to fit the current layout.
Each slider has "fps-slide" class so you can easly target any elements with your CSS or write inline styles using the custom layout editor.
If you still can't get it to work please contact us. We'll gladly help you!
Changes to image size are not “retroactive” meaning they will only affect newly uploaded images. Use Image Sizes Manager to resize the old images.
No! There can only be one slider per screen at a time. You can place multiple sliders on different places ie: on homepage it shows below the header,on category pages it's in the middle ... But, only one per screen!
No it won't. FPS has a minimal footprint and uses only one standard WP query to fetch featured posts. Everything else is a bit of JS and CSS.
No external PHP related assets were used in this script's code.
Other copyrighted assets used:
Once again, thank you so much for purchasing this WordPress plugin. As stated at the beginning, we'd be glad to help you if you have any questions relating to this theme. We'll do our best to assist. If you have a more general question relating to the themes on ThemeForest, you might consider visiting the forums and asking your question in the "Item Discussion" section.
Web factory Ltd.