=== MudSlideShow === Contributors: sebaxtian Tags: picasa, images, image, photos, photo, gallery, flickr Requires at least: 2.8 Tested up to: 2.9.2 Stable tag: 0.11 An image gallery system using Picasa and/or Flickr. == Description == MudSlideShow is free software, and you can use it in commercial and non-commercial sites, but this plugin uses __[Highslide](http://highslide.com/ "An Ajax image viewer")__ and/or __[Lytebox](http://www.dolem.com/lytebox/ "An Ajax image viewer")__ to show the photos, and each one requires 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. In __Configuration > MudSlideShow__ you can define the number of columns per gallery and the viewer to use. I suggest you to use the button in the post/page 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,0,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 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:flickr|picasa,0,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](http://code.google.com/intl/es-AR/apis/picasaweb/docs/2.0/reference.html#Parameters "Programmers reference por 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,0,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__ and __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). This plugin requires __[minimax](http://wordpress.org/extend/plugins/minimax/ "A minimal Ajax library")__ in order to work. The MudSlideShow plugin has been translated to french by __[Oyabi](http://www.oyabi.fr/ "Actualité informatique et multimédia")__ and Belarusian by __[Marcis G](http://pc.de/)__. 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. == 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 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 te list with the 'Add Gallery' buton 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. = It says 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 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](http://highslide.com/ "An Ajax image viewer")__ and/or __[Lytebox](http://www.dolem.com/lytebox/ "An Ajax image viewer")__ to show the photos, and each one requires 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. == 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 spanish) 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.11 = * New viewer (FancyBox) * Can define thumnail's size in widgets. = 0.10.12 = * Configuration form allows define tumbnail's size. = 0.10.11 = * 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. = 0.10.10 = * First release with belarusan translation. * Now MSS allow to add galleries in the list. = 0.10.9 = * New database system. * New update system. * Images with legend. * Fixed issues with feeds. = 0.10.8 = * Solved an activation issue. = 0.10.7 = * The long awaited new ache system. * The rss galleries appears as them comes, not order by photo date. = 0.10.6 = * Solved a bug with old PHP versions. = 0.10.5 = * Solved a bug with current path. * Solved an issue with Litebox viewer. = 0.10.4 = * New cache system fixed. = 0.10.3 = * Solved a bug in deactivation process. * Solved a bug in CSS. = 0.10.2 = * Deactivate the plugin will erase the configuration data. = 0.10.1 = * Solved a bug in the widget with empty albums. = 0.10 = * Stable release * First works with rss feeds (not yet in box editor). = 0.9.101 = * Solved a strange bug in the editor. * New cache system to solve a bug with cache plugins. = 0.9.100 = * Solved a bug with simple photo and zero albums. = 0.9.99 = * 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. = 0.9.98 = * Solved a bug with tag albums. = 0.9.97 = * Solved a bug with 'most recent photos' gallery in Flickr. * Added 'most recent photos' to Picasa. = 0.9.96 = * Solved a bug with update system. = 0.9.95 = * First release with Flickr features. * Updated the configuration values. = 0.9.6 = * Modified the text editor. Now press ENTER in username fields changes the focus to next selector instead sends the form. = 0.9.5 = * 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. = 0.9.4.1 = * Solved a bug with old PHP versions. = 0.9.4 = * Manage activation errors. = 0.9.3.1 = * Solved a bug with the update function. = 0.9.3 = * Using new widget system. Have to recreate your widget. * Now you can have multiple widget. = 0.9.2.10 = * Solved a bug with old PHP versions. = 0.9.2.9 = * Solved a bug with the user name, now you can use the domain (gmail.com) in the username. = 0.9.2.8 = * Solved a bug with HTML Entities. = 0.9.2.7 = * Updated CSS files for standardization. = 0.9.2.6 = * Solved a situation with lytebox-viewer. = 0.9.2.5 = * Solved a bug with CSS (IE). = 0.9.2.4 = * Solved a bug with CSS. * Updated spanish translation. = 0.9.2.3 = * 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](http://www.oyabi.fr/ "Actualité informatique et multimédia")__. = 0.9.2.2 = * Now you can set the photo size in the widget. = 0.9.2.1 = * Solving a bug in the Rich Text Editor. = 0.9.2 = * Using nonce to not show data when someone call the ajax script outside the plugin. * Silence is gold. = 0.9.1 = * Solved a bug with the size of table's cells in the html code (IE and Chrome). = 0.9 = * Stable release * New XML definition. Any album with with an old version should be updated automatically. = 0.8.3.3 = * Solved a bug with the new AJAX scripts = 0.8.3.2 = * Solved a bug to show a gallery = 0.8.3.1 = * Solved a bug with cache system = 0.8.3 = * Using minimax 0.3 = 0.8.2 = * 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. = 0.8.1 = * Updated scripts in the administrator to fit with new schreikaten. = 0.8 = * First release in SVN.