=== MudSlideShow === Contributors: sebaxtian Tags: picasa, images, imaqge, photos, photo, gallery Requires at least: 2.8 Tested up to: 2.8.6 Stable tag: 0.8 An image gallery system using PicasaWeb. == Description == MudSlideShow is free software, and you can use it in commercial or non-commercial sites, but this plugin uses __[Highslide](http://highslide.com/ "An Ajax image viewer")__ or __[Lytebox](http://www.dolem.com/lytebox/ "An Ajax image viewer")__ to show the photos, and they need a license when used in commercial sites. Be a fair user with the creator of the viewer you choose if you are going to earn money with your site. In __Configuration / MudSlideShow__ you can define the number of columns per gallery and the viewer to use. To show a gallery in a report or page, use [mudslide:picasa,0,user\_name,album\_id], where user\_name and album\_id are the data from the picasa album. You can use a word as the album\_id, and MudSlideShow would search for the photos with this tag. The numerical value at the beginning is a configuration number for future releases. To show a frame with just one photo at a time, use [mudslide:picasa,0,user\_name,album\_id,size,(left|right)], where user\_name and album\_id are the data from the picasa album. The size and the position values would tell the plugin this is a frame gallery. The size could be an allowed value from __[Picasa API](http://code.google.com/intl/es-AR/apis/picasaweb/docs/2.0/reference.html#Parameters "Programmers reference por Picasa")__. The frame would let you navigate between the images. To show a picture in a report or page use [mudslide:picasa,0,user\_name,album\_id,photo\_number,size,(left|center|right)] where user\_name and album\_id are the data from the picasa album. 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 posts uses it MudSlideShow would add the gallery to the list again. MudSlideShow cannot update automatically a gallery if there is a change in PicasaWeb. To update it you have to manually use the link at the end of the gallery, or click over the numeric information in a simple frame 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__ and __images__ to your posts. It would save the last user\_name used, and will fill the galleries list with the data retrieved from Picasa. 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 to add commentaries to a photo or evaluate it, and those features aren't planned for a near future (See the FAQ). This plugin requires __[minimax](http://wordpress.org/extend/plugins/minimax/ "A minimal Ajax library")__ in order to work. 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. == Installation == 1. Install __[minimax](http://wordpress.org/extend/plugins/minimax/ "A minimal Ajax library")__. 2. Decompress mudslideshow.zip and upload `/mudslideshow/` to the `/wp-content/plugins/` directory. 3. Activate the plugin through the __Plugins__ menu in WordPress. 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). == Frequently Asked Questions == = Is this plugin bug free? = I don't think so. Feedbacks would be appreciated. = I just need the Widget, how can i add something to the list? = MudSlideShow has been designed to show galleries in pages and posts, the widget is just an add on. To add something to the list you have to add it in a page or post. Just edit a post, add a single photo from the gallery you want and don't save the post. When you search for a photo in the editor, MudSlideShow automatically adds its gallery to the list. = 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 open a page the plugin recreates and adds the galleries in the post to the list. = It says something about a write problem = Check you have write permission in `wp-content/plugins/mudslideshow/galleries`. = It say something about minimax. What's this? = This plugin requires __[minimax](http://wordpress.org/extend/plugins/minimax/ "A minimal Ajax library")__ in order to work. = 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 it. But if you are a programmer and you have an idea to add those features, 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 or non-commercial sites, but this plugin uses Highslide or Lytebox to show the photos, and they need a license when used in commercial sites. Be a fair user with the creator of the viewer you choose if you are going to earn some 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 it's free for non-commercial sites, and if I like it. And if it's free for commercial sites i'll put it as the default viewer. == Screenshots == 1. Configuration form 2. Galleries list in Tools / MudSlideShow 3. Widget configuration 4. The widget in the sidebar 5. Icon in the RichText editor 6. Add a gallery 7. A gallery in a post - See the Actualizar (Update in spanih) link 8. Add a framed gallery 9. A framed gallery in a post 10. Add a single photo 11. A single photo in a post == Changelog == = 0.8 = * First release in SVN.