WordPress.org

Ready to get started?Download WordPress

Plugin Directory

!This plugin hasn't been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Ajax Post Carousel

Widget that displays posts as a carousel, using jQuery. It preloads a few posts and Ajax is used to load more posts as the carousel advances.

BETA

Be adviced we are releasing this software as beta software. Our initial intention is to gather feedback and collaboration.

After testing and approval the plugin will launch oficially.

Send us your comments to plugins@8manos.com

HOW TO

  • Carousels can be added using Widgets, Shortcodes or a PHP function.
  • You can use the default styles included in the plugin or use your own css. Explained below.

Widget

This is the easiest way to add carousels to your site. Just drag the "Ajax Post Carousel" widget to an available area and configure all settings.

Shortcode

You can use it to include carousels in your posts or pages. Add [apc-carousel] to use the default values.

All the options in the widget can also be used with the shortcode:

  • random: Accepts 0 or 1. (default 0)
  • visible_posts: Number of posts visible in the carousel. (default 3)
  • init_posts: Number of preloaded posts. Equals number of visible posts + number of posts in the background. (default 9)
  • show_title: Whether to show the title of the post. Accepts 0 or 1 (default 0)
  • show_excerpt: Whether to show the excerpt of the post. Accepts 0 or 1 (default 0)
  • loop: Accepts 0 or 1 (default 0)
  • post_type: Slug of the post type. Accepts 'post', 'page', 'all' or any custom post type. (default 'post')
  • category: Slug of the category. (default 'all')
  • Posts can be filtered by taxonomy using: taxonomy-slug=term-slug

Example:

[apc-carousel visible_posts=2 init_posts=8 show_title=1 show_excerpt=1 my-taxonomy=my-taxonomy-term]

PHP Function

The PHP function can be used in a theme template. The options and defaults are the same as in the Shortcode:

Ajax_Post_Carousel::show_carousel($random=0, $visible_posts=3, $init_posts=9, $show_title=0, $show_excerpt=0, $loop=0, $post_type='post', $category='all', $tax_filter='')

$tax_filter uses this format: 'my-tax-1=my-term-1&my-tax-2=my-term-2'

Example that returns the same output as the Shortcode example:

Use your own CSS

There are to ways to style the carousels using your own css.

  1. Copy the css file from wp-content/plugins/ajax-post-carousel/ajax_post_carousel.css into your theme directory and edit the copy.
  2. Define your own styles in your theme stylesheet. Just use the carousel id, so your rules have a higher priority than the rules from the plugin (for example: #apc_carousel_0 .apc_thumb{border:none;})

Requires: 2.9 or higher
Compatible up to: 3.0.5
Last Updated: 2011-1-17
Downloads: 8,660

Ratings

2 stars
2.7 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,2,2
0,1,0
0,1,0
100,1,1
0,2,0
33,3,1
0,1,0
100,2,2