Featured Posts Scroll

January 04, 2012

Featured Posts Scroll Plugin

A basic javascript based scrolling display of post titles and thumbnails.

Live Demo
More Info
Comments/Suggestions
About Author

This will scroll a set of posts (either automatically or via user click) in any desired location within a template or a post.
The appearance is highly customizable via the admin options menu (colors, drop shadows, rounded corners, & more).

If there are any additional features or bug fixes you would like to see in future versions, feel free to contact me.

If you find this plugin useful please remember to rate it and comment.

Installation

Installation

  • Use the built-in WordPress plugin installer.

    OR

  • Download the zip file and extract the contents.
    Upload the ‘featured-posts-scroll’ folder to your plugins directory (wp-content/plugins/).

  • Activate the plugin through the WordPress ‘Plugins’ menu.
  • Recommendation: Refer to “How to Use” and “FAQ” for useful info.

How to Use

To use this plugin to display the most recent posts in any category and with any tag:

  • Copy and paste the code below to your desired template location:

If you would like to customize what posts are displayed:

  • Copy and paste the code below to your desired template location:
    ”,/* comma separated list of category ids to include (put ‘-‘ in front of ids to exclude) */
    ‘tag’ => ” /* comma separated list tag slugs to include */);
    echo fps_show($args);
    }?>
  • Modify the ‘$args’ array to filter out only the posts that you would like displayed. Delete any entries in the array you don’t want to use (be careful with the commas. See here(https://codex.wordpress.org/Function_Reference/WP_Query#Parameters) for more details on all valid query parameters. Contact me if you have any questions about getting just the posts that you want.
  • Recommendation: Create a new ‘featured’ tag and put it on the posts that you want to displayed and add that category’s slug to the array in the code above.

If you would like to display the featured posts scroll inside of a post:

  • Insert the following shortcode in your post:
    [fps]
  • Arguments can also be used with the shortcode to specify posts to display:
    [fps cat=”-3″ tag=”featured”]

Screenshots

  1. Admin Screen

    Admin Screen

  2. New Features: Slide Numbers, Alternate Arrow Position, Custom Sizing

    New Features: Slide Numbers, Alternate Arrow Position, Custom Sizing

  3. New in Release 1.13: Borderless Arrow Position, Drop Shadow Spread Parameter

    New in Release 1.13: Borderless Arrow Position, Drop Shadow Spread Parameter

FAQ

FAQ

Where do the images displayed come from?

Images are based on the “Featured Image” selected on the Edit Post screen. If the option is not displayed, click Screen Options in the top right of the Edit Post screen and check the “Featured Image” checkbox.

I changed the size of the post scroll, but my images didn’t change size. What do I need to do?

Any new image added to your site should have a thumbnail created in the correct new size. However, the old thumbnails will need to be regenerated. This can be done for all images on your site with the excellent “Regenerate Thumbnails” plugin.

What guidelines should I use when creating custom arrow images?

The easiest way to figure this out is just to look at the images included with the plugin (wp-content/plugins/featured-posts-scroll/images), and format your images in the same basic manner. For the default arrow position (sides of the image), the arrow image should be 46×100. For the alternate arrow position at the bottom of the scroll, the arrow image should be 48×48. For the “no border” position, the arrow image should be 70×120.

For any configuration, the image should be split into four evenly sized quadrants. The top row is left/right arrows as they normally appear and the bottom row are the arrows as they appear when hovered over. The left column should be arrows pointing left, and the right column should be arrows pointing right.

I’m getting an error: “Call to undefined function has_post_thumbnail()”, and I can’t add a “Featured Image” to my posts.

This issue is typically caused by templates that don’t enable post thumbnails. If your template’s functions.php file does not contain this, you must add it:

add_theme_support( 'post-thumbnails' ); 

I have the “Display Excerpts” option selected, but I’m not seeing anything

The plugin will currently only display manually entered excerpts. Automatically generated excerpts will not be displayed.

When I save my settings, I get an error that says statics JS and/or CSS files can’t be saved. What can I do to fix this?

If you get this error, it means that the permissions on your server aren’t setup to let WordPress write directly to a file. To resolve this you’ll need to temporarily change the permissions on this plugin’s css and js directories, click “Save Settings” on the admin page, and then change the permissions back.

You can change the permissions on your server either by using SSH or a config menu on your hosting service’s site (if they allow you to directly change permissions). With SSH access, navigate into the featured-posts-scroll directory and enter “chmod 777 css js”, click “Save Settings” on the admin page, and then change permissions back with “chmod 755 css js”.

Changelog

1.25

  • Corrected issue with plugin appearing on post/page templates.
  • Made caching to static CSS and JS files optional. Some users have reported issues with this feature.

1.24

  • Corrected issue with activation that was causing new variables to not be initialized to default values.

1.23

  • Reorganized/renamed some CSS and JS files. Removed files that are no longer used.
  • Corrected issue where plugin could interfere with post/page templates causing the wrong post data to be displayed.
  • Code refactoring and cleanup: activate/deactivate functions, admin page, js files.
  • Performance update. CSS and JS that were generated from PHP on every page view are now saved to static files every time an admin option is changed.
  • Removed !is_paged() check that prevented plugin from displaying on multiple pages of a list. To replicate old behavior, add if (!is_paged()){…} around the fps_show() call.

1.22

  • Fixed autoscrolling. (Corrected jQuery reference in autoscroll callback function)

1.21

  • Refactored JavaScript to prevent causing issues with plugins that assume “$” references jQuery.

1.20

  • Fixed slide numbers.

1.19

  • Fixed issue where autoscrolling would only work on one instance of a scroll at any one time.

1.18

  • Fixed auto-scrolling when arrows are at side positions.

1.17

  • Added option to always use the full size image instead of generated thumbnails.
  • Fixed IE 6/7 support.
  • Fixed original arrow position support.

1.16

  • Implemented tabbed admin page.

1.15

  • Corrected labeling of “Crop Mode” option and made it the default option.

1.14

  • Added admin option for image background color.
  • Fixed bug where bg didn’t appear behind arrows in bottom position when slide numbers were not also selected.
  • Added some admin options for controlling image scaling/cropping.

1.13

  • Added “Spread” parameter for drop shadows.
  • Added new “No Border” arrow position. Note that Slide Numbers are not currently available with this configuration.

1.12

  • Added user-defined auto-scroll interval, scroll speed, text fade in/out times.
  • Fixed some issues in versions of Firefox prior to 4.0 (broken scrolling, inconsistent text colors).
  • Addressed image tiling issue. Images now get centered in view if not large enough. Next version will have user specified background color.
  • Corrected minor admin page issues (typos).

1.11

  • Modified link formatting to enable the ability for the user to open links in alternate tab/window.
  • Added shortcode argument support.
  • Removed bold/italic options for slide numbers.
  • Added several font options for customizing appearnace of all plugin text.
  • Corrected issue with heading text not displaying (bug introduced in 1.10).

1.10

  • Reorganized admin page. Attempted to make arrangement more logical and remove clutter.
  • Removed elements from generated HTML. An external stylesheet is now generated based on admin options.
  • Addressed issue where title/excerpt could overflow container by ten pixels.
  • Addressed issue where title/excerpt would initially appear in a default position potentially in the middle of the post image.
  • Created separate settings for inner/outer box corner radii and drop shadows.
  • Removed drop-shadow and rounded-corners enable/disable settings. Disabling these features is now done by changing all related settings to zero.

1.9

  • Added alternate arrow location under main image.
  • Added options for displaying slide numbers under main image.
  • Added option to allow user to use their own custom arrow image.
  • Corrected an issue with right margin introduced by custom height/width code.
  • Other minor bug fixes.

1.8

  • User specified height/width.

1.7

  • Addressed issues caused by IE7 float bugs.
  • When text background alpha is set to “1.0”, specify color in standard hex format rather than newer rgba format which is not compatible with older browswers.

1.6

  • Minor CSS corrections.

1.4

  • Added capability to have multiple instances of the Featured Posts Scroll.

1.3

  • Corrected issue with title/excerpt underlining in Chrome.
  • Corrected issue where scrolling didn’t work in Firefox versions prior to 4.0.
  • Accounted for bug in non-webkit browsers where nested elements clip rounded borders.

1.0

  • Initial release.

Details

  • Version: 1.25
  • Active installations: 60
  • WordPress Version: 2.9.1
  • Tested up to: 3.3.2

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars