Title: Scrollarama
Author: maltpress
Published: <strong>March 31, 2011</strong>
Last modified: May 12, 2011

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/scrollarama.svg)

# Scrollarama

 By [maltpress](https://profiles.wordpress.org/maltpress/)

[Download](https://downloads.wordpress.org/plugin/scrollarama.zip)

 * [Details](https://pcd.wordpress.org/plugins/scrollarama/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/scrollarama/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/scrollarama/#installation)
 * [Development](https://pcd.wordpress.org/plugins/scrollarama/#developers)

 [Support](https://wordpress.org/support/plugin/scrollarama/)

## Description

This plugin creates a widget which loops up to ten recent posts and cycles through
them with your selected jQuery Cycle effect.

### Settings

You can change the following settings:

 * **Title:** Widget title
 * **Category:** Category to draw posts from – the list is automatically populated.
   Make sure the category you want to use exists before you start! You can select
   any number of categories – use ctrl and/or shift to select more than one
 * **Number of posts:** Number of posts used – if there are fewer posts, that’s 
   fine. It’ll just use the ones in your chosen category
 * **Slider effect:** jQuery Cycle effect to be used. To see a preview of all effects,
   check out [jQuery Cycle Effects Browser](http://jquery.malsup.com/cycle/browser.html)
 * **Timeout:** the amount of time each slide will show for, in milliseconds. For
   example 3000 = 3 seconds
 * **Transition speed:** how long it takes for each transition, again in milliseconds.
   For example, if you set this to 1000 it will take one second for a post to fade
   out and the next to fade in
 * **Width:** Add a width here _if needed_. By default, the widget should fit the
   sidebar you drop it in to. If not, you can override this by setting a width in
   pixels (don’t include the units, just the number)
 * **Height:** Set the height of the widget in pixels. Don’t include the units.

Add images to posts as follows:

 * Edit the post to add the image to
 * Add a custom field called “slider”
 * Use the path to an image for the custom field value. This can be one in your 
   media library or use an absolute path from another site if you have permission
   to do so.
 * That’s very important – image leeching is naughty.
 * Update your post.

## Screenshots

 * [[
 * The widget menu
 * [[
 * The widget in action

## Installation

 1. Upload the folder named ‘scrollarama’ to the ‘/wp-content/plugins/’ directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Drag and drop the widget to the right sidebar and change the settings as appropriate.

## FAQ

  What categories are used?

You can specify any number of categories to use. Select multiple categories in the
widget control panel using shift and/or ctrl.

  What images are used?

The widget looks for a custom field called “slider” – which you should assign an
image URL (you can grab this from the image details in the media library, or use
an external image if you have permission).

If this custom field isn’t set, the first image attachment assigned to a post is
used.

If neither is in place, the background of the slider will be blank.

  How big should the image be?

The height should match the height you specify in the widget, and width needs to
match the width you set or the width of your sidebar. If it’s bigger than this, 
the background image will be centered. If smaller, you’ll have some blank space 
around it, so try to make it big enough.

  How can I restyle the widget?

You can edit scrollarama/styles/scrollarama_style.css – just make sure you read 
the notes or you might break it! A white .png (to replace the default black background
behind the post header) is provided, so you can easily swap that out.

  The widget doesn’t do x, y or z…

There are several bits of functionality I’d like to add when I get time – mainly
to make it a bit more flexible and easy to style and adapt. If you want it to do
anything in particular, though, get in touch via [my site](http://www.maltpress.co.uk)

Version 1.2 should include better styling options. I’m trying to keep the widget
controls tidy and simple, though.

  It doesn’t show in IE8!

There’s possibly a conflict with other plugins using jQuery Cycle, possibly only
if their Cycle plugin version isn’t the same (2.99 at plugin version 1.1). I’ve 
seen it once but can’t replicate the issue at the moment. If this happens to you,
please contact me via [my site](http://www.maltpress.co.uk) or in the forum for 
this plugin.

  What’s with the name?

I couldn’t think of one, so I asked on Twitter and @michlan came up with it. I’m
going to make this a thing. If you want to name a future plugin, follow @maltpress

  Marry me?

Maybe.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Scrollarama” is open source software. The following people have contributed to 
this plugin.

Contributors

 *   [ maltpress ](https://profiles.wordpress.org/maltpress/)

[Translate “Scrollarama” into your language.](https://translate.wordpress.org/projects/wp-plugins/scrollarama)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/scrollarama/), check
out the [SVN repository](https://plugins.svn.wordpress.org/scrollarama/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/scrollarama/) by
[RSS](https://plugins.trac.wordpress.org/log/scrollarama/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1.1

 * Fixed bug on new WP and Scrollarama installs where category array chucks an “
   implode: Invalid arguments” error

#### 1.1

 * Added timeout (time each slide shows for) editing
 * Added speed (time it takes for transition to complete) editing
 * Added custom jQuery Cycle option editing
 * Can now select multiple categories to slide through
 * Now select up to ten posts

#### 1.0

 * Plugin launched

## Meta

 *  Version **1.1.1**
 *  Last updated **15 years ago**
 *  Active installations **10+**
 *  WordPress version ** 3.0.1 or higher **
 *  Tested up to **3.1.4**
 *  Language
 * [English (US)](https://wordpress.org/plugins/scrollarama/)
 * Tags
 * [cycle](https://pcd.wordpress.org/plugins/tags/cycle/)[featured posts](https://pcd.wordpress.org/plugins/tags/featured-posts/)
   [jquery](https://pcd.wordpress.org/plugins/tags/jquery/)[posts](https://pcd.wordpress.org/plugins/tags/posts/)
   [widget](https://pcd.wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/scrollarama/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/scrollarama/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/scrollarama/reviews/)

## Contributors

 *   [ maltpress ](https://profiles.wordpress.org/maltpress/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/scrollarama/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=CMGXVNG4MKQYU)