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.



MudSlideShow is free software, and you can use it in commercial and non-commercial sites, but this plugin uses Highslide, Lytebox, Fancybox or prettyPhoto to display images, and each one would require or not a special license to be used in commercial sites. Be a fair user with the developer of the library you choose if you are going to earn money with your site. In Configuration > MudSlideShow you can define the viewer to use.

In order to use any of those viewers, this plugin would require you to install another plugin or to upload the specific library inside the 3rdparty directory. See FAQ for mor details.

I suggest you to use the button in the post editor to facilitate the process to add a mudslideshow tag to your page.

To show a gallery in a report or page, use [mudslide:flickr|picasa,conf,user_name,album_id], where user_name and album_id are the data from the photo service. You can use a word as the album_id, and MudSlideShow would search for the photos with this tag.

The configuration number can be calculated as follows:

  • Add 1 if you want to show the descriptio (first comment in Picasa, or the picture description in Flickr) as a caption in the image (only works with selected viewers).
  • Add 2 if you want to show the gallery in reverse order.

To show a frame with just one photo at a time, use [mudslide:flickr|picasa,conf,user_name,album_id,size,(left|right)], where user_name and album_id are the data from the photo service. The size and the position values would tell the plugin this is a frame gallery. The size could be an allowed value from Picasa or from Flickr (s, t, m or l). The frame would let you navigate between the images.

To show a picture in a report or page use [mudslide:flickr|picasa,conf,user_name,album_id,photo_number,size,(left|center|right)] where user_name and album_id are the data from the photo service. The photo_number is the photo’s index in the album. Size is optional and could be an allowed value from Picasa API. The position is optional too.

There is also a Widget to show a random picture, the last photo from the last gallery, a random photo from the last gallery, or a random photo from a specified gallery.

The first time you add or see a gallery in a post or page, MudSlideShow would add it to the list to be used in the Widget. You can delete and update a gallery in Tools / MudSlideShow from the list of galleries, but if a page or post uses it MudSlideShow would add the gallery to the list again.

MudSlideShow updates automatically each gallery once in a year. If you change a photo or an album in the photo service and the album is in your blog you have to update it manually. Use the link at the end of the gallery or click over the numeric information in a simple framed gallery. You can see those links only if you are the owner of the post, or if you can modify post from others. You can also update a gallery in Tools / MudSlideShow.

There is a button in the RichText Editor to add galleries, single frame galleries, images and feature images to your posts. It would save the last user_name used, and will fill the galleries list with the data retrieved from PicasaWeb. If the list doesn’t show a gallery you just added, update it with the button at the right side of each list. In the single picture section you can update the contents of a gallery too.

This plugin have been developed to show photos and galleries. It doesn’t allow a user to add commentaries to a photo or evaluate it, and those features aren’t planned for a near future (See the FAQ).

The MudSlideShow plugin has been translated to french by Oyabi and Bonaldi (since release 0.12.2), Belarusian by Marcis G, German by Rian, Dutch by Rene, Romanian by Catalin, Basque by Unai and Galician by Pablo César Galdo. Thanks for your time guys!

Screenshots are in spanish because it’s my native language. As you should know yet
I spe’k english, and the plugin use it by default.


  • Configuration form
  • Galleries list in Tools / MudSlideShow
  • Form to add galleries.
  • Widget configuration
  • The widget in the sidebar
  • Icon in the RichText editor
  • Add a gallery
  • A gallery in a post - See the Actualizar (Update in spanish) link
  • Add a framed gallery
  • A framed gallery in a post
  • A framed gallery using Highslide as viewer.
  • Add a single photo
  • A single photo in a post


  1. Decompress and upload /mudslideshow/ to the /wp-content/plugins/ directory.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Upload the library or install the 3rd party plugin you would use as the viewer.
    Inside Options/Mudslideshow you can see where are and how to install these
    3rd party plugins/libraries.
  4. Activate the Widget if you want a random photo in the sidebar.
  5. You can use mudslide.css, lytebox.css and highslide.css to create your own style (see FAQ).
  6. You can use hs-config.js to set a special behavior to highslide (see FAQ).


I can’t select any viewer, but none

Sin release 0.12.10, MudSlideShow requieres you to: a) install a 3rd party plugin
if you would use a library with a GPL license (FancyBox and PrettyPhoto), ot b)
upload the javascript library to the 3rdparty directory if this library doesn’t use a
GPL compatible license (LyteBox, HighSlide).

To use FancyBox you would require to install and activate easy-fancyBox,
or in case you use PrettyPhoto, you wuold have to use PrettyPhoto Media.

To use HighSlide, download it from here, unpack, and FTP the ‘highslide’ directory to ‘mudslideshow/3rdparty’.
To use Lytebox, download it from here, unpack, rename the ‘lytebox_Vx.x’ as ‘lytebox’ and FTP it to ‘mudslideshow/3rdparty’.

Then go back to Options/MudSlideShow and select your required viewer.

Whats is this thing about ‘Show Description’?

MudSlideShow would displays a text in a frame near the image when you add 1 to the config
number. If the gallery is in Picasa, MSS would use the first comment, if it is a Flickr
gallery MSS would use the picture description.

This feature is enabled only if you use Highslide or Fancybox.

Whats is this thing about ‘Feature Image’?

If your theme can manage Feature Images, you can enable MudSlideShow to automatically
assign a thumbnail when you modify or save a post. This feature copy the image to your
media library, attaches it to the post and sets as the feature image.

MudSlideShow selects the Feature Image applying these rules:

  • The first image with the tag [mudthumb].
  • The first single image [mudslide].
  • The first image in a gallery [mudslide].
  • The first attached image [media library].

If you want to change the Feature Image, use the tag [mudthumb] (the editor would
guide you with this) inside the post. Then delete the old Feature Image and update the post.
An image in a mudthumb would be invisible inside the post, this way you can have
a post without images but with a custom thumbnail.

In case you want a post without a feture image, add the custom field no_thumb to your post, and delete the feature image if the post
has one picture asigned yet.

Remember that MSS only assign the Feature Image when you save or update a post.
To enable the capability to create the thumb when displaying a post, add this line of
code to the file function.php in your theme:

define(‘MUDS_CREATE_THUMBS’, true);

I suggest to use this capability only to create the thumbnails quickly while you navigate
throught your page, but I strongly suggest to disable it when you have finished.

If your theme doesn’t mannage Feature Images, you can add the function mud_thumb($size).
This function returns an html code with a squared thumbnail with the Featured Image
selected by mudslideshow, even if you don’t have a thumbnail enable theme.

Is this plugin bug free?

I don’t think so. Feedbacks would be appreciated.

I don’t know my username in Flickr/Picasa

When in doubt, use your email in the editor box. It will try to find your id.

I updated a photo in my flickr/picasa gallery, but MSS didn’t updated the gallery automatically

You have to manually update any galley in MudSlideShow. This plugin has been designed
to add galleries to posts, but not to create a link with a photo service to update your
site with any change you do.

I just need the Widget, how can i add something to the list?

Add galleries to the list with the ‘Add Gallery’ button in Tools/MudSlideShow. Add the widget to your sidebar and set the gallery you want to display.

I have deleted a gallery from the list, but it appears again!

Maybe the gallery is declared in a post or page, and when a user opens this page the plugin recreates and adds the galleries in the post to the list.

What about commentaries and votes in a photo?

I designed MudSlideShow to be part of a post, like a part of the hole and not a section apart. That’s why this plugin doesn’t allow to add commentaries to a photo or evaluate it, and those features aren’t planned for a near future. Don’t lose your time asking for this feature. But, if you are a programmer and you have an idea, I’ll love to hear about it.

Can I set my own CSS?

Yes. Copy the files mudslide.css (how the images are shown in a page), highslide.css or lytebox.css to your theme folder. The plugin will check for them.

Can I set my own scheme for Highslide?

Yes. Copy the file hs-config.js to your theme folder. The plugin will check for it.

What about licenses?

MudSlideShow is free software, and you can use it in commercial and non-commercial sites, but this plugin uses Highslide, Lytebox, Fancybox or __prettyPhoto to show the photos, and each one would require or not a license to be used in commercial sites. Be a fair user with the developer of the library you choose if you are going to earn money with your site.

How can I change the language in Lytebox?

This viewer use images instead of text for the buttons. To change the language you have to change the images.

I would like to see MudSlideShow using the xyz viewer

Contact me. I’ll put the viewer in the list if I like it and it’s free for non-commercial sites. And if it’s free for commercial sites too, I’ll put it as the default viewer for sure.

Can I change the position of the simpleslide controls?

Copy the simpleslide.css file in your theme and edit it.


There are no reviews for this plugin.

Contributors & Developers

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


Translate “MudSlideShow” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Adding ‘comments’ to PrettyPhoto


  • Adding CarouFredSel as SimpleSlider library.


  • Solving CSS bug.


  • Solved a CSS bug with FancyBox.


  • New PrettyPhoto plugin.
  • New Square size in Flickr.


  • Solving legal situation with LyteBox and Highslide.

  • Solving update situation.


  • Updated Flickr API key.
  • Added url_o into flickr extras query.

  • Solved bug with tinyMCE.

  • MSS calls SimpleXMLElement just one tme for each gallery.
  • First release with galician translation. Thanks Pablo César Galdo.

  • Uses WPBook filter to set feature image in Facebook stream.

  • Now you can open set widgets to open posts where the photo is.

  • Solved bug with ‘imported’ posts.

  • Solved bug with special characters
  • Solved bug with detection of RSS feed call.

  • Solved bug with widgets when using new ‘feed detection’ system.

  • Solved bug with brakets inside photo comments and names
  • Added system to check if WP is displaying a feed and change the viewer


  • Checked for WP 3.1
  • Solved bug with special characters inside photo comments and names
  • Solved bug with ‘loading’ image precharge.
  • Solved problem with the excerpt.
  • Preview images while selecting single image or fature image
  • Don’t display caption when the photo doesn’t have a name.

  • Modified TinyMCE call to solve bugs with wp-cache.

  • Solved CSS bug with bottom-margin in some themes.
  • Added new GUI to show description.
  • Added new GUI to reverse order.

  • Added PrettyPhoto as a new viewer.
  • Solved situation with Flickr in full mode.

  • Modified excerpt functions.

  • Use none-viewer when in feed.

  • Solved bug with pop-up image in special themes.
  • Not show pop-up image when in feed.

  • Solved bug with size in flickr.

  • Solved bug with email recognition.
  • Solved bug with size in flickr.

  • First release with basque translation. Thanks Unai.

  • Solved bug with [simple gallery+highslide] initialization.

  • Solved bug with loading image on [simple gallery+highslide]

  • Solved bug with little images in Flickr.

  • Solved bug with higshlide + simple gallery in script declaration order.
  • Don’t show the Loading image when using a simple gallery in highslide.
  • Using a semaphore system to initialize simple galleries in Higslide viewer.
  • Using fade instead expand in higslide.


  • Solved configuration rights bug.

  • Solved minor bugs.

  • Solved bug with photos with spaces in the name.

  • New tag to add featured images.
  • New schemme to add featured images.
  • Modified configuration page to allow set featured image system.

  • Solved bug with simpleslide script.
  • Solved bug with thumbnail title.

  • Added feature to set the post thumb.

  • Solved bug with single image in flickr.
  • Added function to get first thumb (for templates).


  • Using WP functions to add safely scripts and css.

  • Solved bug with admin header.

  • Solved bug with PHP tag.

  • Solved bug with version comparison.

  • Solved bug to not use size array in add-gallery manager.


  • Solved bug with Fancybox and Internet Explorer (did I mention I hate IE?)
  • Solved bug with CSS to put an image over other images.


  • First release with romanian translation. Thanks Catalin.
  • Solved bug with size data in Flickr API.
  • Solved bug to not use size array in add-gallery manager.

Size data.
* Solving bug from using new scripts with multimedia library and higslide.

  • Solving bug with single photo grouped in highslide.
  • Solving CSS situation.

  • Solving bug with galleries id.

  • Solving simpleslide-higslide-CSS bugs.


  • Solving simpleslide-higslide-CSS bugs.
  • Added uninstall script.

  • Solving simpleslide-higslide bugs.

  • Solving simpleslide-higslide bugs.

  • Solving simpleslide-higslide bugs.


  • Simpleslide with Highslide library.

  • Using local jquery when using wp 3.0


  • Using new script functions.
  • Cleaning code.


  • First release that doesn’t require Minimax.

  • First release with german translation. Thanks Rian.
  • First release with dutch translation. Thanks Rene.

  • Allow to chose the full size image, between 800px (approx) or original size in galleries.


  • Allow to chose the full size image, between 800px (approx) or original size.

  • Fixing box size.

  • Solved a bug with Picasa Squared single images.

  • Solved another division by zero bug.

  • Solved a division by zero bug.

  • Controls in simpleslide are now bottom centered.


  • When calling JS or CSS files now MSS use ‘ver’.
  • Simpleslide controls by default at bottom.
  • Solved a bug with some galleries in Picasa with ‘__’ in the URL.


  • Hacking the code to fit in IE7 (please, update if you use such an old browser)


  • New CSS to show an icon when the pouinter is over the images.
  • New CSS in FancyBox.


  • Solved a bug that display comments in a local media without commnents.
  • Solved a bug with the Fancybox viewer that display ‘|’ even without link.


  • FancyBox viewer with new event system.


  • New viewer (FancyBox)
  • Can define thumbnail’s size in widgets.


  • Configuration form allows define thumbnail’s size.


  • Solved a bug when checking users in Picasa. MSS recognice now accounts with emails diferent from gmail
  • Modified the UI to guide the users to the galleries list.


  • First release with belarusan translation.
  • Now MSS allow to add galleries in the list.


  • New database system.
  • New update system.
  • Images with legend.
  • Fixed issues with feeds.


  • Solved an activation issue.


  • The long awaited new ache system.
  • The rss galleries appears as them comes, not order by photo date.


  • Solved a bug with old PHP versions.


  • Solved a bug with current path.
  • Solved an issue with Litebox viewer.


  • New cache system fixed.


  • Solved a bug in deactivation process.
  • Solved a bug in CSS.


  • Deactivate the plugin will erase the configuration data.


  • Solved a bug in the widget with empty albums.


  • Stable release
  • First works with rss feeds (not yet in box editor).


  • Solved a strange bug in the editor.
  • New cache system to solve a bug with cache plugins.


  • Solved a bug with simple photo and zero albums.


  • Precharging image in the editor.
  • Zero album without comments in picasa while I figure how to get the comments in just one Api call.
  • Solved a bug in editor with last_source variable.


  • Solved a bug with tag albums.


  • Solved a bug with ‘most recent photos’ gallery in Flickr.
  • Added ‘most recent photos’ to Picasa.


  • Solved a bug with update system.


  • First release with Flickr features.
  • Updated the configuration values.


  • Modified the text editor. Now press ENTER in username fields changes the focus to next selector instead sends the form.


  • MudSlideShow can show the linked images added with the WordPress image library.
  • Solved a bug to show a single image at the begin of a post or page.

  • Solved a bug with old PHP versions.


  • Manage activation errors.

  • Solved a bug with the update function.


  • Using new widget system. Have to recreate your widget.
  • Now you can have multiple widget.

  • Solved a bug with old PHP versions.

  • Solved a bug with the user name, now you can use the domain ( in the username.

  • Solved a bug with HTML Entities.

  • Updated CSS files for standardization.

  • Solved a situation with lytebox-viewer.

  • Solved a bug with CSS (IE).

  • Solved a bug with CSS.
  • Updated spanish translation.

  • MudSlideShow can add a link to the photo or gallery to the source page. See configuration to enable it.
  • First release with french translation. Thanks Oyabi.

  • Now you can set the photo size in the widget.

  • Solving a bug in the Rich Text Editor.


  • Using nonce to not show data when someone call the ajax script outside the plugin.
  • Silence is gold.


  • Solved a bug with the size of table’s cells in the html code (IE and Chrome).


  • Stable release
  • New XML definition. Any album with with an old version should be updated automatically.

  • Solved a bug with the new AJAX scripts

  • Solved a bug to show a gallery

  • Solved a bug with cache system


  • Using minimax 0.3


  • The code has been indented, documented and standardised.
  • Solved a bug with the headers, now MudSlideShow works with the plugin POD.
  • Solved a bug when tinyMCE editor in full window.


  • Updated scripts in the administrator to fit with new schreikaten.


  • First release in SVN.