Introducing: WordCycle

Edit: For more information on WordCycle, examples, and support, please see the WordCycle page.

I mostly develop two kinds of websites: WordPress sites and not-WordPress sites. In these not-WP sites, I find that I use Alsup’s jQuery Cycle Plugin on a regular basis. For a new project, my client has a slideshow on their homepage using the  ubiquitous Smooth Gallery, which works quite well, but sticks out like a sore thumb on most sites, and is very difficult to simplify.

Part of the re-design for this client is to switch him from his current custom PHP CMS to WordPress, so I could have used the WordPress SmoothGallery Plugin but that wouldn’t go with my theme or be as fun as developing a plugin that uses my JavaScript slideshow of choice: Cycle.

So in steps WordCycle…

WordCycle is a wrapper for the jQuery Cycle Plugin. After installing WordCycle, you can use the slideshow shortcode to insert a Cycle slideshow into your WordPress post or page, no JavaScript necessary!

To setup a WordCycle slideshow, upload images to your post and set them up as you would for a gallery.

Flash Uploader

Give the files names, captions, and order them using the gallery view.

When you’re done, add the slideshow to your page using the slideshow shortcode and publish.

slideshow shortcode

Options include transition effect, speed, image size, pause on hover (or not), gallery id, slideshow position (float), and slide order.

The plugin includes a super simple stylesheet, and I might give it some default styles at some point, but for now at least, the stylesheet is just meant to be a guide.

To see the README, visit WordCycle’s home on GitHub.

I’ve submitted the plugin to the WordPress Plugin Directory, so it’ll go up there soon as well.

Example (using only defaults):

Screenshot showing Flash Uploader Gallery options.
Screenshot showing Flash Uploader Gallery options.
Screenshot showing slideshow shortcode usage.
Screenshot showing slideshow shortcode usage.
This entry was posted in wordpress and tagged , , . Bookmark the permalink. Comments are closed, but you can leave a trackback: Trackback URL.

13 Comments

  1. Posted May 18, 2009 at 10:44 am | Permalink

    Hola Esther
    I just installed the plugin and works great.
    Thanks!

    ¡Adiós!

    • Esther
      Posted May 18, 2009 at 11:42 am | Permalink

      That’s great to hear! Thanks for letting me know it’s working for you.

  2. Posted June 3, 2009 at 5:48 pm | Permalink

    Hello Esther,
    I am very happy to have found this plugin. I am using it now and have pause=’0′ . I thought this would prevent pausing the cycle on mouse-over, however it still pauses when I mouse-over. Am I wrong in thinking that pause=’0′ prevents a pause on mouse-over?
    Thanks for your help and thanks for a great plugin! I love the simplicity of it.

    Jane Forrester

  3. Posted June 4, 2009 at 10:47 am | Permalink

    Hello Again Esther -
    I still think this is a great plugin – works great on Safari, Firefox (both MAC OS & current updates).
    However – when I checked on a PC – Internet Explorer 7 – the images didn’t cycle… Any thoughts?
    Unfortunately had to revert to just a gallery for now. Hope you can help. Thank you.

    Jane

    • Esther
      Posted June 8, 2009 at 4:16 pm | Permalink

      Jane –
      The problem there was with a comma at the end of the cycle options which IE has problems with. The fix is here: http://github.com/esther/WordCycle/

      Your question about pausing — the default for Cycle & for WordCycle is 0: do not pause on hover.
      This site uses wordcycle like this: [slideshow pause='1' float='right' size='full' timeout='4000'] to enable pause on hover.

  4. Posted June 8, 2009 at 7:32 pm | Permalink

    Esther
    Thanks for your help, I’ll try your fix – I really want to use this plugin!

  5. Posted June 9, 2009 at 7:28 pm | Permalink

    Working great on IE now – Thank You.

  6. Posted July 7, 2009 at 11:02 am | Permalink

    I’ve been searching for a plugin like this for ages. One question though, is it possible to do prev and next “click transitions” similar to those detailed on the JQuery Cycle plugin site? Example here – http://malsup.com/jquery/cycle/int2.html

    I have tried replicating the settings but to no avail.

    Thanks

    Paul

    • Esther
      Posted July 27, 2009 at 2:27 pm | Permalink

      WordCycle doesn’t have those settings built in — but if you edit lines 80-90 of wordcycle.php with the cycle options you’re interested in, you’ll be in business.

  7. Posted August 2, 2009 at 12:02 pm | Permalink

    Would love to use word-cycle to replace my existing slideshow (the current one doesn’t work on the iphone).

    Can it be used in a sidebar? How?

    Also, can you link each image to it’s own url (a page of my site)?

    Thank you for developing such an intelligent plugin -
    wwwindi

    • Esther
      Posted August 3, 2009 at 9:03 am | Permalink

      In it’s current state, the WordCycle plugin can only be used where a shortcode works (posts and pages). It takes the gallery of that post and creates a slideshow based on that.

      You can specify a link for each image by adding links to the image’s properties in the Image Upload/Insert modal box.

  8. Posted August 7, 2009 at 9:39 pm | Permalink

    Esther –
    this is a great plugin, and I like what you have done with washingtonisland – looks cool!

    I have a template that has an already created home.php within the theme…

    thus, when adding your plugin (because I too am a big fan of jQuery Cylce!) to the active plugins in the admin, how would I go about getting the plugin to work with the page, it is some sort of hand code, but I do not see any reference to any of that advanced editing here.
    Yes, it is probably more on the lines of theme development, but for some reason, I am attracting two instances of jquery which is causing one of my two plugins on the site to fail…

    any help is appreciated.

    http://floorstore.rayflores.com/blog/

    thanks,

    • Esther
      Posted August 10, 2009 at 9:53 am | Permalink

      Ray — all you need to do is use the shortcode. Checkout the README

      If you’re having problems with jQuery, it might be another one of your plugins — check that they include jQuery the “right way”.