=== Slideshow === Contributors: stefanboonstra Donate link: http://stefanboonstra.com/donate-to-slideshow/ Tags: responsive, slideshow, slider, slide show, images, image, photo, video, text, gallery, galleries, jquery, javascript Requires at least: 3.5 Tested up to: 4.3 Stable tag: 2.3.1 License: GPLv2 Integrate a fancy slideshow in just five steps. - Rainbows. Rainbows everywhere. == Description == Slideshow provides an easy way to integrate a slideshow for any WordPress installation. Any image can be loaded into the slideshow by picking it from the WordPress media page, even images you've already uploaded can be inserted into your slideshow right away! Fancy doing something crazy? You can create and use as many slideshows as you'd like, with different images, settings and styles for each one of them. = Features = - Create as many slideshows with as many slides as you like - Image slides - Text slides - YouTube Video slides - Responsive - Place it anywhere on your website - Run multiple slideshows on the same page - Change animations and handling - Customize to taste - Show that visitor who's boss = Languages = - Bulgarian (87% - bg_BG - Translated by [Ilko Ivanov](http://software.avalonbg.com/en/index.php)) - Chinese (65% - zh_CN - Translated by [Kevin Tell](http://www.ivygg.com/) and [Leo Newbiesup](http://smallseotips.com/)) - Czech (81% - cs_CZ - Translated by Edhel) - Dutch (100% - nl_NL - Translated by [Stefan Boonstra](http://stefanboonstra.com/) (That's me!)) - English (100%) - Finnish (83% - fi - Translated by A. Nonymous) - French (91% - fr_FR - Translated by [Romain Sandri](http://www.onidesign.fr/)) - German (99% - de_DE - Translated by [Markus Amann](http://www.dema-itsupport.com/) and others) - Hebrew (53% - he_IL - Translated by Eli Segev) - Italian (83% - it_IT - Translated by [Tecnikgeek](http://tecnikgeek.com/)) - Japanese (82% - ja - Translated by [Michihide Hotta](http://net-newbie.com/)) - Norwegian (99% - nb_NO - Translated by A. Nonymous) - Persian (100% - fa_IR - Translated by [W3Design](http://w3design.ir/)) - Polish (83% - pl_PL - Translated by Wicher Wiater) - Portuguese (92% - pt_BR - Translated by [Piero Luiz](http://www.newer7.com.br/) and others) - Portuguese (83% - pt_PT - Translated by [Filipe Catraia](http://www.filipecatraia.com/)) - Russian (100% - ru_RU - Translated by [Coupofy](http://www.coupofy.com/) and Dmitry Fatakov) - Serbo-Croatian (91% - sr_RS - Translated by [Webhosting Hub](http://www.webhostinghub.com/)) - Spanish (51% - es_ES - Translated by [Violeta Rosales](https://twitter.com/violetisha)) - Swedish (91% - sv_SE - Translated by [Åke Isacsson](http://www.nojdkund.se/) and Wilhelm Svenselius) - Turkish (83% - tr_TR - Translated by [İlker Akdoğan](http://www.kelkirpi.net/)) - Ukrainian (100% - uk_UK - Translated by [Coupofy](http://www.coupofy.com/)) = Project board = Check upcoming features, bug-fixes and development progress that are currently on the Slideshow project board at: [Slideshow project board - Trello.com](https://trello.com/board/slideshow-plugin-wordpress/506311260cc04591010463c2) = Need the (uncompressed) source code? = Find the Slideshow project's source code in my [GitHub](https://github.com/Boonstra/Slideshow) repository. The uncompressed files can be compiled using [Prepros](http://alphapixels.com/prepros/), or [CodeKit](http://incident57.com/codekit/). == Installation == 1. Install Slideshow either via the WordPress.org plugin directory, or by uploading the files to your server. 2. After activating Slideshow, click on 'Slideshows' and create a new slideshow. 3. Click on 'Insert Image Slide' to insert an image slide, a popup will appear where you can search for the desired image. Insert the image by clicking 'Insert'. The same goes for text and video slides, don't forget to save! 4. Go to a post or a page and click the 'Insert Slideshow' button above the editor. A popup appears where you can select your newly created slideshow to insert. You can also use the shortcode or code snippet visible in your slideshow admin panel to deploy your slideshow anywhere on your website. Use the widget to show any of your slideshows in the sidebar of your website. 5. Feel like a sir. == Frequently Asked Questions == = How do I add image slides? = Click the 'Image slide' button in the 'Slides List' of the slideshow. A screen will pop up where you'll be able to search though all images that have already been uploaded to your WordPress website. If you want to add new images to the slideshow, or you do not have any images yet, you'll have to upload them to the WordPress media page first. = How do I change a slideshow's settings? = Just like the posts and pages you're already familiar with, slideshows can be edited. Go to the 'Slideshows' tab in your WordPress admin, and you'll see a list of slideshows. If you have not created a slideshow yet, you can do so by clicking 'Add new' on that same page. If there are slideshows in the list, click on the title of the slideshow you want to change the settings of. On the slideshow's edit page you'll be able to find a box titled 'Slideshow Settings', in this box you can change the slideshow's settings. If you're creating multiple slideshows that should have the same settings, but their settings need to be different from the default settings, you can change the default settings by going to the 'General Settings' page and clicking on the 'Default Slideshow Settings' tab. Newly created slideshows will start off with the settings you set there. = How do I customize the slideshow's style? = On your WordPress admin page, go to the 'Slideshows' menu item and click on 'General Settings', then go to the 'Custom styles' tab. Here you'll see a list of default stylesheets, such as 'Light' and 'Dark', and a list of custom stylesheets; The ones you created. Choose a default stylesheet you'd like to customize and click 'Customize' to open the 'Custom style editor'. When you're done editing click 'Save Changes' and go to the slideshow you'd like to style with the newly created stylesheet. In the 'Slideshow Style' box you can now find and select your custom stylesheet. You can set a stylesheet for multiple slideshows. If you've already created a custom stylesheet, you can edit it by clicking 'Edit'. You can also delete it by clicking 'Delete'. Be careful with this though, a deleted stylesheet cannot be retrieved and cannot be used by any slideshow anymore. = Some users can add, edit or delete slideshows, although I do not want them to. Can I prevent this from happening? = Yes you can. On your WordPress admin page, go to the 'Slideshows' menu item and click on 'General Settings', then go to the 'User Capabilities' tab (If you're not already there). The privileges that allow user groups to perform certain actions are listed here. To allow, for instance, a contributor to add a slideshow, click the box in front of 'Contributor' to grant him the right to add slideshows. Note that when you grant someone the right to add or delete a slideshow, you'll also automatically grant him or her the right to edit slideshows, as this right is required to add or delete slideshows. The same is true for the reversed situation. = The slideshow does not show up = - The slideshow is mostly called after the `` tag, which means the scripts and stylesheet need to load in the footer of the website. A theme that has no `` call in it's footer will not be able to load the slideshow's scripts. - Often when the slideshow isn't showing, there's a javascript error somewhere on the page and this error has caused javascript to break. For the slideshow to work again, this error needs to be fixed. Check if any errors were thrown by opening Google Chrome or Firefox (with Firebug installed) and press the 'F12' key. Errors show in the console tab. = Why does Internet Explorer show a big blank space above the slideshow? = Internet Explorer is a very strict browser, so when a big blank space above your slideshow is showing your page may contain some invalid HTML. Most times invalid HTML is caused by placing the slideshow's shortcode or PHP snippet into an anchor tag (``) or paragraph tag (`
`), while you can only place a slideshow within a 'div' element (``). == Screenshots == 1. Here's what a default slideshow can look like. Sit back, grab a beer, enjoy. 2. Create a new slideshow. Slides and settings specific to this slideshow can be set here. 3. If you haven't uploaded any images yet, you can do so on the WordPress media page. 4. Click the 'Image Slide' button in the Slides List to search and pick images from the WordPress media page. Click 'Insert' to insert the image as slide. 5. The images you selected are directly visible in your Slides List, don't forget to save! 6. When you understand the basics of creating slideshows, you may want to go a little more in depth and have a look at the General Settings page. As seen in the image above, privileges can be granted to user roles to give users the ability to add, edit or delete slideshows. 7. Default slideshow settings can be edited here. Slideshows that are newly created, will start out with these options. 8. Custom styles can be added and customized here. Custom styles can be used to style one or more slideshows to your own personal taste. == Changelog == = 2.3.1 = * Fixed: Text and video slides could not be inserted. = 2.3.0 = * Refactored the slideshow plugin's backend codebase to prepare for a larger backend rewrite. * Removed backwards compatibility on inserting images with pre-3.5 versions of WordPress. * Slideshows now work on infinite scroll and single page websites through the "Enable lazy loading" option. * Fixed: YouTube thumbnail image disappeared after clicking the slideshow's navigation buttons. = 2.2.25 = * Changed localization domain to match the plugin's slug in order to support language packs. = 2.2.24 = * Compatible with WordPress 4.3. * Widget constructor no longer uses deprecated PHP 4 style constructor. * Fixed: Mismatch between session ID and settings ID. * Fixed: Unescaped data in slideshow editor. * Fixed: Resizing issues. * Added Ukrainian translation and updated Russian translation, thanks to Coupofy. = 2.2.23 = * Fixed: Despite default stylesheets now loading through static file again, admin-ajax.php was still being called. * Fixed: Invalid HTML in the shortcode inserter. Thanks to [Iazel](https://wordpress.org/support/profile/iazel). * Fixed: HTML5 validation issue when loading stylesheets in the head of the document. * Fixed: Slideshows now load their settings by slideshow ID, instead of the variable session ID. * Updated Spanish translation, thanks to Manuel Ballesta Ruiz. = 2.2.22 = * Compatible with WordPress 4.2. * Default stylesheets are no longer dynamically loaded through admin-ajax.php. * Fixed: Security vulnerability in the SlideshowPluginSlideshowStylesheet class. * Fixed: An issue with admin-ajax.php when the frontend uses HTTP, while the backend uses HTTPS. Thanks to [Chris Scott](https://github.com/chrisscott) * Fixed: A bug that caused the previous slide button and the navigation bullets to malfunction on "Cross Fade" setting. * Fixed: Slideshow container calculation now uses the JavaScript round function instead of the floor function. * Fixed: Separated assignment of $sessionID and increment of SlideshowPlugin::$sessionCounter. * Added Norwegian translation by A. Nonymous. * Updated Persian translation by W3Design. * Updated German translation by A. Nonymous. * Updated Brazilian Portuguese by A. Nonymous. = 2.2.21 = * Compatible with WordPress 3.9. * Added "Cross Fade" option to the animation settings. * Updated the API to support retrieving the direction of the animation on the animation event. * Fixed: Slideshow moving to next slide on keyboard navigation. By [Ben Wetzel](https://github.com/bensashi) * Fixed: HTML5 validation issue. * Fixed: Permission check that checked for "edit_post" instead of "edit_slideshow". = 2.2.20 = * Compatible with WordPress 3.8. * Accessibility improvements by [Ben Wetzel](https://github.com/bensashi) * Title and description element types can now be set from backend and anchor tags are omitted when no URL is set. * Improved functional stylesheet. * Post published/updated message doesn't show a link to a non-existant page anymore. * New tags are available for custom stylesheets: %site-url%, %stylesheet-url% and %template-url% * Fixed: When the slideshow would not have any height, slides would not hide outside of the slideshow. * Added Serbo-Croatian translation by Webhosting Hub. * Updated Persian translation by W3Design. * Updated Chinese translation by Leo Newbiesup. * Updated Swedish translation by Wilhelm Svenselius. = 2.2.19 = * Slideshows can now detect when their stylesheet isn't loaded and load their own when this is the case. * The functional stylesheet should now provide a more stable base for all slideshows. * Fixed: Uploading images through the WordPress 3.5 uploader on a slideshow's edit page would return an error. * Fixed: Images with a 'max-width: 100%;' style rule would size wrongly on responsive websites. * Fixed: The randomization method returned error messages. = 2.2.18 = * Added option to select whether or not search engines should follow a slide's link. * Improved filter avoiding mechanism. * Disappearing settings now have a more apparent animation. * Fixed: First slide of a slideshow wouldn't show when the slideshow's content had no size on page load. * Added Brazilian Portuguese translation by Piero Luiz. * Updated French translation by Romain Sandri. = 2.2.17 = * Fixed: Images disappeared when their width was larger than the slide's width and image behaviour was set to 'Natural and centered' = 2.2.16 = * Inserting images can now be done using the WordPress 3.5 uploader. * Images can now fill up an entire slide without losing their dimensions, using the 'Zoom to fit' option. * Fixed: Descriptions came up and stayed up on fly-over. * Fixed: Image calculations failed in a few because of a 'jQuery.outerWidth()' bug. * Fixed: Control panel wasn't correctly initialized when slideshow was set to automatically slide to the next slide. = 2.2.15 = * The image dimension calculation algorithm now uses a more stable and more efficient way to determine the size of images. * Added slideshow API. * Fixed: WP Color Picker (Iris) adds a hashtag to color codes. As slideshow does this as well, text slides didn't display color properly. = 2.2.14 = * Fixed: Slideshow didn't show because of a JavaScript error when calculating an unstretched image's dimension. = 2.2.13 = * The SlideshowPluginAjax.php has been re-added to SVN. = 2.2.12 = * Compatible with WordPress 3.6. * Complete javascript revision to be better manageable with the help of the Prepros tool. * Related videos can now be enabled or disabled on YouTube videos. * YouTube API now is only loaded when a video slide needs to be shown. * Re-arranged the 'General Settings' page to have a 'General Settings' tab that contains overall system settings. * Added option to choose the loading location of the stylesheets, as IE8 and older don't always allow in-body styling. * Implemented a new algorithm for randomizing slides. * Slideshow can now wait for a slide to load before showing it. * Fixed: The 'Enable responsiveness' setting disappeared when disabling the 'Show title and description' option. * Added Turkish translation by İlker Akdoğan. * Added Polish translation by Wicher Wiater. * Added Finnish translation by an anonymous supporter. * Updated French translation by Romain Sandri. * Added Portuguese translation by Filipe Catraia. * Added Persian translation by W3Design. * Added Italian translation by Tecnikgeek. * Added Japanese translation by Michihide Hotta. = 2.2.11 = * Fixed: The slideshow script loaded the YouTube API twice. * Fixed: Floating the slideshow resulted in it having no width, therefore being invisible. * Fixed: Sites that don't support URL data weren't able to load a slideshow's stylesheet correctly. * Fixed: Slideshow randomly disappeared in Internet Explorer 8 when absolute positioning was used. * Added Swedish translation by Åke Isacsson. * Added Hebrew translation by Eli Segev. = 2.2.10 = * Fixed: Auto margin combined with a fixed width will no longer break slideshow's responsiveness. * Updated Russian translation, thanks to Dmitry Fatakov. = 2.2.9 = * Fixed: Descriptions didn't show when 'Hide descriptions' was set to 'No'. * Fixed: Title was given wrong size by CSS. = 2.2.8 = * Fixed: Images that have a, to WordPress, unknown size weren't able to show on all websites. * Fixed: Images in the image inserter popup were being skipped over when loading more results because of a faulty query. * All stylesheets are now loaded at the page's bottom to validate in HTML checkers and be cached by the visitor's browser. * Improved the handling of description boxes. Description boxes will no longer be 'jumpy' nor will they pop up on fly-over. * Errors in jQuery's 'ready' method no longer stop the slideshow from showing. However, JavaScript errors should always be resolved. * Text slides can now have transparent backgrounds by leaving the 'Background color' field empty. = 2.2.7 = * Fixed: Slideshow control buttons were placed behind the slideshow. * Fixed: Image slides doubly inserted after having clicked on 'Load more results' * Included width and height attributes on all image elements. = 2.2.6 = * Fixed: Theme's that set image heights affected the slideshow's image dimensions. * Fixed: Compatibility with the ALO EasyMail Newsletter plugin. * Fixed: Image's 'alt' values didn't show when no image title was set. = 2.2.5 = * Fixed: Slideshow settings nonce prevented 3.4 and older WP users from saving their slideshows. = 2.2.4 = * Fixed: Video slideshows will now work on mobile devices supported by YouTube. * Fixed: Removed multi-line element tags to prevent WordPress from adding '