|
1 === Slideshow === |
|
2 |
|
3 Contributors: stefanboonstra |
|
4 Donate link: http://stefanboonstra.com/donate-to-slideshow/ |
|
5 Tags: slideshow, slider, slide, slides, show, images, image, photo, gallery, galleries, jquery, javascript, video, text |
|
6 Requires at least: 3.3 |
|
7 Tested up to: 3.4.2 |
|
8 Stable tag: 2.1.17 |
|
9 License: GPLv2 |
|
10 |
|
11 Integrate a fancy slideshow in just five steps. - Rainbows. Rainbows everywhere. |
|
12 |
|
13 |
|
14 == Description == |
|
15 |
|
16 Slideshow provides an easy way to integrate a slideshow for any Wordpress installation. |
|
17 |
|
18 Any image can be loaded into the slideshow by picking it from the Wordpress media page, even images you've already |
|
19 uploaded can be inserted into your slideshow right away! |
|
20 |
|
21 Fancy doing something crazy? You can create and use as many slideshows as you'd like, with |
|
22 different images, settings and styles for each one of them. |
|
23 |
|
24 = Features = |
|
25 |
|
26 - Create as many slideshows with as many slides as you like |
|
27 - Image slides |
|
28 - Text slides |
|
29 - Video slides |
|
30 - Place it anywhere on your website |
|
31 - Run multiple slideshows on the same page |
|
32 - Change animations and handling |
|
33 - Customize to taste |
|
34 - Shows that visitor who's boss |
|
35 |
|
36 = Languages = |
|
37 |
|
38 - English |
|
39 - Dutch |
|
40 - Russian (Translated by [Oleg Fritz](http://www.facebook.com/profile.php?id=100001331241069)) |
|
41 - Chinese (Translated by [Kevin Tell](http://www.ivygg.com/)) |
|
42 |
|
43 Feel free to send me your own translation of the plugin to my e-mail address: wordpress@stefanboonstra.com. Many |
|
44 thanks in advance! |
|
45 |
|
46 = Project board = |
|
47 |
|
48 Check upcoming features, bug-fixes and development progress that are currently on the Slideshow project board at: |
|
49 [Slideshow project board - Trello.com](https://trello.com/board/slideshow-plugin-wordpress/506311260cc04591010463c2) |
|
50 |
|
51 |
|
52 == Installation == |
|
53 |
|
54 1. Install Slideshow either via the WordPress.org plugin directory, or by uploading the files to your server. |
|
55 |
|
56 2. After activating Slideshow, you can create a new slideshow. |
|
57 |
|
58 3. Click on 'Insert Image Slide' to insert an image slide, a popup will appear where you can search for the desired |
|
59 image. Insert the image by clicking 'Insert' |
|
60 |
|
61 4. Use the shortcode or code snippet visible in your slideshow admin panel to deploy your slideshow anywhere on your website, |
|
62 or use the widget to show any of your slideshows in the sidebar of your website. |
|
63 |
|
64 5. Feel like a sir. |
|
65 |
|
66 |
|
67 == Frequently Asked Questions == |
|
68 |
|
69 = How do I add image slides? = |
|
70 |
|
71 You can choose from images that have already been uploaded to your Wordpress website by clicking on the |
|
72 'Insert Image Slide' button in the slides list. A screen will pop up and here you are able to search your image files |
|
73 by name for image you want to use. If you want to add new images to the slideshow, you need to upload them to the |
|
74 Wordpress media page. |
|
75 |
|
76 = The slideshow does not show up / The slideshow looks like it's not styled = |
|
77 |
|
78 - The slideshow is mostly called after the `</head>` tag, which means the scripts and stylesheet need to load in the footer |
|
79 of the website. A theme that has no `<?php wp_footer(); ?>` call in it's footer will not be able to load the slideshow's |
|
80 scripts. |
|
81 |
|
82 - Often when the slideshow isn't showing, there's a javascript error somewhere on the page and this error has caused |
|
83 javascript to break. For the slideshow to work again, this error needs to be fixed. Check if any errors were thrown by |
|
84 opening Google Chrome or Firefox (with Firebug installed) and press the 'F12' key. Errors show in the console tab. |
|
85 |
|
86 = I chose the 'Custom' style option for my slideshow, but the slideshow is not styled anymore = |
|
87 |
|
88 Since the slideshow is most often called after the </head> tag, the slideshow can't print it's styles in the head of |
|
89 the website and has to output it on the page. A strict doctype does not allow stylesheets in the body and thus the |
|
90 slideshow may not be styled. |
|
91 |
|
92 |
|
93 == Screenshots == |
|
94 |
|
95 1. Here's what some default slideshows can look like. Sit back, grab a beer, enjoy. |
|
96 |
|
97 2. Create a new slideshow. A shortcode and a code snippet of how to call it is already visible. |
|
98 |
|
99 3. If you haven't uploaded any images yet, you can do so on the Wordpress media page. Don't forget to insert the images into the slideshow after uploading! |
|
100 |
|
101 4. Click the 'Insert Image Slide' button in the Slides List to search and pick images from the Wordpress media page. |
|
102 |
|
103 5. The images you selected are directly visible in your Slides List, don't forget to save! |
|
104 |
|
105 6. Not satisfied with the handling or styling of the slideshow? Customize! |
|
106 |
|
107 |
|
108 == Changelog == |
|
109 |
|
110 = 2.2.0 Pre-release = |
|
111 * Slides can now be randomized. |
|
112 * Multiple slideshows can now be shown with each its separate styling. |
|
113 * Users can now search insertable images by post id. |
|
114 |
|
115 = 2.1.17 = |
|
116 * Fixed: Invalid argument being supplied for the foreach loop in SlideshowPluginPostType on line 352 |
|
117 * Fixed: Undefined index being thrown by URL target setting on slideshow creation. |
|
118 * Video slide now accepts YouTube URLs as well. |
|
119 |
|
120 = 2.1.16 = |
|
121 * Security update enabling HTML in slides again, but only allowing it in a very strict format without any scripts. |
|
122 * Added shortcode editor, which provides a more convenient way of inserting slideshows in your posts and pages. |
|
123 * Updated the way slideshows are retrieved. A faulty ID will no longer cause the slideshow to not show at all. |
|
124 * Slideshows can now also be fetched by their slugs. |
|
125 * The example shortcode's ID on the slideshow settings page is now surrounded by quotes to prevent confusion. |
|
126 |
|
127 = 2.1.15 = |
|
128 * Fixed: Security issues. |
|
129 * Added Chinese translation. |
|
130 |
|
131 = 2.1.14 = |
|
132 * Fixed: Text slide descriptions allow HTML again |
|
133 |
|
134 = 2.1.13 = |
|
135 * Fixed: PHP security issues. |
|
136 * Set order of images gotten in 'Image slide' pop-up to post date, descending. |
|
137 |
|
138 = 2.1.12 = |
|
139 * Moved slideshow activation to the footer script. Footer jQuery scripts are now supported. |
|
140 |
|
141 = 2.1.11 = |
|
142 * Fixed: Conflict with the Gravity Forms plugin. |
|
143 |
|
144 = 2.1.10 = |
|
145 * Fixed: Slideshow widget form now is compatible with older versions of PHP, that didn't recognize a null value as a set value. |
|
146 |
|
147 = 2.1.9 = |
|
148 * Fixed: Not all admin themes support scripts in the admin footer, admin scripts are moved to the header. |
|
149 |
|
150 = 2.1.8 = |
|
151 * Option added to be able to control whether to use a filter, or to directly output on shortcode. |
|
152 |
|
153 = 2.1.7 = |
|
154 * Fixed: Slideshow in some cases unable to show next slide in fade animation. |
|
155 |
|
156 = 2.1.6 = |
|
157 * Slideshow widgets are loaded using theme sidebar settings, making the widget more dynamic. |
|
158 * Fixed: Slideshow widget title can now be set to an empty value. |
|
159 |
|
160 = 2.1.5 = |
|
161 * Fixed: Wordpress intervened with the HTML output by the shortcode, this caused scripts to break. |
|
162 * Fixed: Slideshow width isn't affected by width-less elements anymore, instead it seeks the first div's width. |
|
163 |
|
164 = 2.1.4 = |
|
165 * Fixed: Slideshows in posts are now longer broken by Wordpress inserted 'em' tags. |
|
166 * Fixed: Image borders no longer fall off-slide. |
|
167 |
|
168 = 2.1.3 = |
|
169 * Fixed: Overflow container now adapts to its parent element correctly. |
|
170 * Fixed: Internet Explorer now shows control panel (buttons etc.) on top of the Flash element. |
|
171 * Fixed: Images are now loaded by the Wordpress function, rather than being loaded from the database's 'guid'. |
|
172 |
|
173 = 2.1.2 = |
|
174 * Wordpress media uploader link in image inserter pop-up now opens in a new window. |
|
175 * Fixed: Image inserter pop-up CSS no longer pushes the 'insert' buttons off-screen. |
|
176 |
|
177 = 2.1.1 = |
|
178 * Fixed: Settings meta-box threw an unexpected 'T_ENDFOREACH' since a shorthand PHP tag was used improperly. |
|
179 |
|
180 = 2.1.0 = |
|
181 * Added Youtube video slides. |
|
182 * Slide URLs can now be chosen to open in a new window. |
|
183 * Added headers above settings, giving the user mover oversight. |
|
184 * Endless scrolling is now available in the image inserter pop up. |
|
185 * Images are now centered in their slides by default. |
|
186 * Script is now activated on document ready, not window load. |
|
187 * Hid slides in another element so that buttons could overflow the slideshow container. |
|
188 * Fixed: Hide-away settings were influenced by their own settings fields. |
|
189 * Fixed: Stretching was not always handled correctly. |
|
190 * Fixed: Script counter made the first view show twice. |
|
191 |
|
192 = 2.0.1 = |
|
193 * Fixed: Version 1.x.x slides disappeared after updating to version 2.0.0. An automatic converter has been added. |
|
194 |
|
195 = 2.0.0 = |
|
196 * Complete sideshow script revision to support new features. |
|
197 * The script now supports two kinds of animations: 'Slide' and 'Fade'. |
|
198 * Multiple images can be shown in one slide, instead of one. |
|
199 * Text slides are available. |
|
200 * Descriptions are more cooperative, they don't overlap the entire image anymore. (Instead they hide or have a user-defined fixed height) |
|
201 * Multiple slideshows can now be shown on one page. |
|
202 * Play and pause buttons are now available, as is the option not to auto-play and/or loop the slideshow. |
|
203 * Stylesheets no longer partially depend on the website's stylesheet, except for the fonts. |
|
204 * The script and its functional stylesheet are now compressed to save loading time. |
|
205 * Added jQuery sortables script to sort slides |
|
206 * Images you've already uploaded and attached to other posts can now be loaded into the slideshow, saving disk space (and time). |
|
207 |
|
208 = 1.3.5 = |
|
209 * Fixed: Namespace complications found with the Slideshow widget, renamed all classes. |
|
210 |
|
211 = 1.3.4 = |
|
212 * Fixed: Custom width of the slideshow will no longer cause buttons to fall off-screeen. |
|
213 |
|
214 = 1.3.3 = |
|
215 * Extended compatibility to servers that do not support short php opening tags. |
|
216 |
|
217 = 1.3.2 = |
|
218 * Fixed: 1.3.1 Bugfix failed to work, fixed problem entirely after reproducing it. |
|
219 * Added alternative way to load default css into empty custom-style box, so that users without 'allow_url_fopen' enabled aren't influenced negatively by it. |
|
220 |
|
221 = 1.3.1 = |
|
222 * Fixed: Check if function 'file_get_contents' exists before calling it, some servers have this disabled. (This throws errors and messes up the plugin) |
|
223 |
|
224 = 1.3.0 = |
|
225 * Added Dutch translation. |
|
226 * Custom styles for each slideshow are now available to be more compatable with every theme. (Black and transparent scheme) |
|
227 * Encapsulated a css class so that it does not interfere with anything outside the slideshow_container. |
|
228 * Moved slides list to the side, saving space on the slideshow specific settings page. |
|
229 * Settings bugs completely fixed, finally. (Previous version deleted post-meta on auto-save) |
|
230 * Moved Slideshow settings and images script to inside the slideshow_container, outputting a more coherent whole. |
|
231 * Settings moved from multiple meta keys to a single one. (This resets everyone's settings) |
|
232 * Added a Wordpress media upload button to the slides list, this simplifies attaching images to a slideshow. |
|
233 * Better way of including the jQuery library is now being used. |
|
234 * Fixed bug with the number of slides shown in the slideshow stuck at the default value of five. |
|
235 |
|
236 = 1.2.1 = |
|
237 * Fixed: Slideshow specific settings not saving. |
|
238 |
|
239 = 1.2.0 = |
|
240 * Slideshows can now be placed in posts as well, using shortcode [slideshow id=*SlideshowPostId*]. |
|
241 * Added a widget that can be loaded with an existing slideshow of choice. |
|
242 * Tested up to version 3.4 |
|
243 |
|
244 = 1.1.0 = |
|
245 * Added jQuery library as Wordpress websites don't seem to load them by default. |
|
246 * Slideshow script now depends on by the plugin enqueued jQuery script. |
|
247 |
|
248 = 1.0.1 = |
|
249 * Added documentary comments. |
|
250 * Fixed error with directory paths causing Slideshows post type page to generate warnings. |
|
251 |
|
252 = 1.0.0 = |
|
253 * Initial release. |
|
254 |
|
255 |
|
256 == Links == |
|
257 |
|
258 * [Stefan Boonstra](http://stefanboonstra.com/) |
|
259 * [Slideshow project board](https://trello.com/board/slideshow-plugin-wordpress/506311260cc04591010463c2) |