YouTube Embed - Version 4.3.2

Version Description

  • Bug: Correct validation of list field, which was preventing more than one video being specified
  • Bug: Fixed the URL for the settings link in the plugin meta
Download this release

Release Info

Developer codedart
Plugin Icon 128x128 YouTube Embed
Version 4.3.2
Comparing to
See all releases

Code changes from version 4.3.1 to 4.3.2

Files changed (5) hide show
  1. includes/admin-config.php +1 -1
  2. includes/options-lists.php +2 -2
  3. readme.txt +866 -860
  4. uninstall.php +0 -6
  5. youtube-embed.php +2 -2
includes/admin-config.php CHANGED
@@ -26,7 +26,7 @@ function ye_add_settings_link( $links, $file ) {
26
  if ( !$this_plugin ) { $this_plugin = plugin_basename( __FILE__ ); }
27
 
28
  if ( strpos( $file, 'youtube-embed.php' ) !== false ) {
29
- $settings_link = '<a href="options-general.php?page=ye-general-options">' . __( 'Settings', 'youtube-embed' ) . '</a>';
30
  array_unshift( $links, $settings_link );
31
  }
32
 
26
  if ( !$this_plugin ) { $this_plugin = plugin_basename( __FILE__ ); }
27
 
28
  if ( strpos( $file, 'youtube-embed.php' ) !== false ) {
29
+ $settings_link = '<a href="admin.php?page=ye-general-options">' . __( 'Settings', 'youtube-embed' ) . '</a>';
30
  array_unshift( $links, $settings_link );
31
  }
32
 
includes/options-lists.php CHANGED
@@ -10,7 +10,7 @@
10
 
11
  // Set current list number
12
 
13
- if ( isset( $_POST[ 'youtube_embed_list_no' ] ) ) { $list_no = sanitize_text_field( $_POST[ 'youtube_embed_list_no' ] ); } else { $list_no = 0; }
14
  if ( $list_no == '' ) { $list_no = 1; }
15
 
16
  // If options have been updated on screen, update the database
@@ -26,7 +26,7 @@ if ( ( !empty( $_POST[ 'Submit' ] ) ) && ( check_admin_referer( 'youtube-embed-g
26
  $class = 'error';
27
  $message = __( 'All fields must be completed.', 'youtube-embed' );
28
  } else {
29
- $id_array = explode( "\n", sanitize_text_field( $_POST[ 'youtube_embed_video_list' ] ) );
30
  $loop = 0;
31
  $valid = true;
32
 
10
 
11
  // Set current list number
12
 
13
+ if ( isset( $_POST[ 'youtube_embed_list_no' ] ) ) { $list_no = esc_textarea( $_POST[ 'youtube_embed_list_no' ] ); } else { $list_no = 0; }
14
  if ( $list_no == '' ) { $list_no = 1; }
15
 
16
  // If options have been updated on screen, update the database
26
  $class = 'error';
27
  $message = __( 'All fields must be completed.', 'youtube-embed' );
28
  } else {
29
+ $id_array = explode( "\n", esc_textarea( $_POST[ 'youtube_embed_video_list' ] ) );
30
  $loop = 0;
31
  $valid = true;
32
 
readme.txt CHANGED
@@ -1,862 +1,868 @@
1
- === YouTube Embed ===
2
- Contributors: codedart
3
- Tags: download, embed, embedding, iframe, media, play, playlist, responsive, seo, video, widget, youtube
4
- Requires at least: 3.9
5
- Tested up to: 4.4.2
6
- Stable tag: 4.3.1
7
- License: GPLv2 or later
8
- License URI: http://www.gnu.org/licenses/gpl-2.0.html
9
-
10
- A simple to use method of embedding responsive YouTube videos into your posts and pages but with powerful features for those that need them.
11
-
12
- == Description ==
13
-
14
- **Version 4 removes a number of existing features. If you're upgrading from a previous version, please [click here](http://www.artiss.co.uk/youtube-embed-removed-features "Removed Features") for further details. If you were using the widget feature then please head to the FAQ before proceeding.**
15
-
16
- YouTube Embed is an incredibly simple, yet powerful, method of embedding YouTube videos into your WordPress site. Options include:
17
-
18
- * XHTML and HTML5 compliant - works with all the latest browsers
19
- * Dynamic video sizing for responsive sites
20
- * Build your own playlists and play them back however you want
21
- * Automatically generate playlists based on user name or search text
22
- * Create multiple profiles - use them for different videos to get the exact style that you want
23
- * Google compatible metadata is added to the video output - great for SEO!
24
- * Fully internationalized ready for translations. **If you would like to add a translation to his plugin then please [get in touch](http://www.artiss.co.uk/plugin-contact "Contact")**
25
- * Support for Do Not Track
26
- * Compatible with [Video SEO for WordPress](http://yoast.com/wordpress/video-seo/ "Video SEO for WordPress"), [a3 lazy load](https://wordpress.org/plugins/a3-lazy-load/ "a3 lazy load") and [WordPress Video Overlay Ads](https://wordpress.org/plugins/video-overlay-ads/ "WordPress Video Overlay Ads") and many more. In the case of Video SEO and WordPress Video Overlay Ads, their options will even appear under the YouTube Embed menu for total simplicity!
27
- * Use [Turn Off The Lights](https://www.turnoffthelights.com/ "Turn Off The Lights")? This plugin works with it beautifully.
28
- * [iFrame Resizer](https://github.com/davidjbradshaw/iframe-resizer "iFrame Resizer") and [FitVids.js](https://github.com/davatron5000/FitVids.js "FitVids.js") supported to improve content resizing
29
- * Works "out of the box" with 4K, 60FPS and Chromecast - stream your embedded videos to your TV!
30
- * And much, much more!
31
-
32
- There are no premium features and no adverts - this is 100% complete and free! See the "Other Notes" tab for how to get started as well as the more advanced features. How easy is it to use? The fine people at [Webucator](https://www.webucator.com "Webucator") have put together an excellent video showing you how to get started with it..
33
-
34
- https://www.youtube.com/watch?v=Wc7cvpQS-xQ
35
-
36
- == Getting Started ==
37
-
38
- To add a video to a post or page simply use the shortcode `[youtube]video[/youtube]`, where `video` is the ID or URL of the video. Alternatively, you can add one (or more) widgets to your sidebar.
39
-
40
- Within the administration area, click on YouTube Embed and then General Settings to view and edit default generic settings for the plugin. Also under the `YouTube Embed` menu (see screenshot 1) you can click on the `Profiles` sub-menu to set the default options which define the output of your videos. Any videos you display (unless overridden by parameters - more on that later) will use the settings from the Profiles screen.
41
-
42
- Although this document contains a lot of information more is available from a series of linked pages, plus as much information as possible is provided on the various administration pages. Whilst on the administration pages, click on the "Help" button in the top right for some useful tips and links. If anything isn't covered and you're unsure of what it does please ask [on the forum](https://wordpress.org/support/plugin/youtube-embed "WordPress Plugins Forum").
43
-
44
- == Advanced embedding options ==
45
-
46
- A basic shortcode will embed your video using your default profile settings. However, you may wish to override some of these options on a video-by-video basis - this is done via parameters added to the shortcode.
47
-
48
- e.g. `[youtube width=300 height=200]Z_sCoHGIpU0[/youtube]`
49
-
50
- Which options are available depends upon the embedding type you're using as well as the viewers set-up (for example, whether they have Flash installed or not). You can specify any of the parameters but they may be ignored. Please see the Profile screen in Administration for details of which parameters are supported by which embed method.
51
-
52
- * **annotation** - yes or no, this determines if annotations are shown
53
- * **autohide** - 0, 1 or 2, this parameter indicates whether the video controls will automatically hide after a video begins playing. The default behaviour, a value of 2, is for the video progress bar to fade out while the player controls (play button, volume control, etc.) remain visible. If this parameter is set to 0, the video progress bar and the video player controls will be visible throughout the video. If this parameter is set to 1, then the video progress bar and the player controls will slide out of view a couple of seconds after the video starts playing. They will only reappear if the user moves her mouse over the video player or presses a key on her keyboard.
54
- * **autoplay** - yes or no, should the video automatically start playing?
55
- * **cc** - yes or no, decided whether closed captions (subtitles) are displayed. If you don't specify anything then the user's default will be used.
56
- * **color** - white or red, the colour of the progress bar (see the FAQ about having a white progress bar with the light theme)
57
- * **controls** - 0, 1 or 2, this decides whether the controls should display and when the Flash will load. A value of 0 will not show the controls but 1 or 2 will. A value of 2 will load Flash once the user initiates playback - otherwise it's loaded straight away.
58
- * **disablekb** - yes or no, disable keyboard controls
59
- * **fullscreen** - yes or no, this will add the fullscreen button to the toolbar. This also works with EmbedPlus.
60
- * **height** - the video height, in pixels
61
- * **html5** - yes or no, whether to force HTML5 as the default player or not (if available). NB: This is an undocumented feature and, as such, may not work
62
- * **info** - yes or no, show video information. If displaying a playlist this will show video thumbnails
63
- * **list** - if you've specified your own list, use this to select the way the videos should be output. Should be `random` (display videos in a random order), `single` (show just one video, randomly picked from the list) or `order` (show each video in the original order - this is the default)
64
- * **loop** - yes or no, whether to start the video again once it ends
65
- * **modest** - reduce the branding on the video
66
- * **playsinline** - whether videos play inline or fullscreen in an HTML5 player on iOS.
67
- * **profile** - specify a different default profile (see section on Profiles for further details)
68
- * **ratio** - allows you to define a window ratio - specify just a height or width and the ratio will calculate the missing dimension. Uses the format x:x, e.g. 4:3, 16:9
69
- * **related** - yes or no, show related videos
70
- * **responsive** - whether to use responsive output or not. When switched on the video will resize when your site does (i.e. responsive). If a video width is supplied this will be the maximum width, otherwise full width will be assumed. Height is ignored and will be worked out automatically.
71
- * **search** - yes or no, create a playlist based on a search word. The search word should be specified instead of a video ID. See "Automatically Generate Playlists" option for more details
72
- * **start** - a number of seconds from where to start the video playing
73
- * **stop** - this stops the video at a specific time, given in seconds
74
- * **style** - apply CSS elements directly to the video output
75
- * **template** - specify a template (see section on Templates for further details)
76
- * **theme** - dark or light, display player controls (like a 'play' button or volume control) within a dark or light control bar
77
- * **user** - yes or no, create a playlist based on a user's uploads. The search word should be specified instead of a video ID. See "Automatically Generate Playlists" option for more details
78
- * **width** - the video width, in pixels
79
-
80
- == Alternative Shortcodes ==
81
-
82
- Within administration, selecting `General Settings` from the `YouTube Embed` menu will provide a list of general options. One option is named `Alternative Shortcode` and allows you to specify another shortcode that will work exactly the same as the standard shortcode of `[youtube]`.
83
-
84
- There are 2 reasons why you might want to do this...
85
-
86
- 1. If migrating from another plugin, it may use a different shortcode - more details can be found in the section named "Migration"
87
- 2. If another plugin uses the same shortcode (e.g. Jetpack) this will allow you to specify and use an alternative
88
-
89
- The new shortcode can also have its own default profile assigned to it (see the Profiles section for more details on this).
90
-
91
- == Widgets ==
92
-
93
- Widgets can be easily added. In Administration simply click on the `Widgets` option under the `Appearance` menu. `YouTube Embed` will be one of the listed widgets. Drag it to the appropriate sidebar on the right hand side and then choose your video options - any that aren't specified are taken from your supplied profile.
94
-
95
- If you wish to display an automatically generated playlist based on user name or search term, simply change the "ID Type" appropriately and then specify the name or search word(s) where the video ID would normally be entered.
96
-
97
- And that's it! You can use unlimited widgets, so you can add different videos to different sidebars.
98
-
99
- == Playlists ==
100
-
101
- YouTube allows users to create their own playlists - collections of videos that can be played in sequence.
102
-
103
- YouTube used to supply Playlist IDs as 16 digits and these can still be used...
104
-
105
- e.g. `[youtube]095393D5B42B2266[/youtube]`
106
-
107
- Alternatively, if you're using a newer, non-16 digit ID then append 'PL' to the beginning.
108
-
109
- e.g. `[youtube]PLVTLbc6i-h_iuhdwUfuPDLFLXG2QQnz-x[/youtube]`
110
-
111
- Playlists cannot be used along with the EmbedPlus embedding method.
112
-
113
- A better alternative to playlists is the build-in lists function in YouTube Embed - see the Lists section for further details.
114
-
115
- == Templates ==
116
-
117
- Both in the profile and as a parameter you can specify a template. This allows you to define any CSS that you wish to "wrap" around the YouTube output.
118
-
119
- The template consists simply of any HTML that you wish but with `%video%` where you wish the video to appear.
120
-
121
- e.g. `<div align="center">%video%</div>`
122
-
123
- Be wary that when adding template via a parameter that any HTML included may cause your video to have `<pre>` tags wrapped around it. The easiest way to check and fix this is to view any post in the HTML editor and remove any PRE tags that have been added.
124
-
125
- == Profiles ==
126
-
127
- You've probably already had a look at the default profile, accessible by selecting `Profiles` from the `YouTube Embed` administration menu option. Here you can specify the default option which will apply to any embedded video.
128
-
129
- However, in the top right hand corner is a drop-down box and a button marked `Change profile`. Simply select an alternative profile and click the button and you can then edit the options for this alternative profile. You can even name it as well.
130
-
131
- To use this profile, simply use the parameter `profile=` followed by the profile name or number. The options for this profile will then be used.
132
-
133
- This could be useful, for instance, for having a separate profile for different parts of your site - posts, sidebar, etc - or for different video types (e.g. widescreen).
134
-
135
- By default you have 5 extra profiles - if you wish to have more (or less) this number can be changed from the YouTube Embed settings screen.
136
-
137
- == Lists ==
138
-
139
- Although this plugin will play standard YouTube playlists their playback options are limited. Instead you can create your own video lists. Under the `YouTube Embed` administration menu is a sub-menu named `Lists`. Select this and you will be shown a screen where you can type in a list of video IDs (or URLS). You can also provide a name for the list.
140
-
141
- When saving the list each video is validated.
142
-
143
- As with profiles you can select the list from a drop down in the top right-hand corner. You can also change the number of lists from the `Options` sub-menu too.
144
-
145
- To use a list, simply specify the list name or number instead of a video ID, as well as a parameter to specify how you wish the list to be played back.
146
-
147
- e.g. `[youtube list='order']List 1[/youtube]`
148
-
149
- The list parameter allows to to either play each in turn, play them randomly, or have just one played (but picked randomly).
150
-
151
- An option within the general options screen allows you to change whether this parameter MUST be used. If switched on, you will gain a performance increase, otherwise the plugin has no way of knowing if you're asking for a playlist so must verify the ID you've specified against all your lists.
152
-
153
- == Automatically Generated Playlists ==
154
-
155
- YouTube includes options to automatically generate playlists based upon a user name or a search name.
156
-
157
- To use, simply use the `user` or `search` parameter to switch the appropriate option on. Then, instead of a video ID or URL, you should specify either the user name or search word(s).
158
-
159
- == Third Party Resizing Scripts ==
160
-
161
- Within the YouTube Embed settings screen there is an option to set a third party resizing script - either [iFrame Resizer](https://github.com/davidjbradshaw/iframe-resizer "iFrame Resizer") or [FitVids.js](https://github.com/davatron5000/FitVids.js "FitVids.js"). These work alongside the existing IFRAME but try and improve the output, particularly with regard to how the output is sized.
162
-
163
- There are no guarantees with these and no support of their specific functionality is provided. However, if the video output is wrong then it's worth trying these.
164
-
165
- == Thumbnails ==
166
-
167
- YouTube embed also has the ability to return a thumbnail of a video (sorry, this doesn't work with playlists). There are two methods you can use for this - a shortcode or a function call.
168
-
169
- Use the function call `youtube_thumb_embed( 'id', 'paras', '', 'alt', 'nolink' )` to add a thumbnail to any part of your theme.
170
-
171
- Like the video embed equivalent, the `id` is the video ID and `alt` is the alternative text for the thumbnail image (optional). `nolink`, if set to `true`, will output the thumbnail without a link to the YouTube video, allowing you to add your own.
172
-
173
- The parameters are different, however, but, again, are separated by ampersand.
174
-
175
- The parameters are as follows...
176
-
177
- * **rel** - specify a REL override, e.g. rel="nofollow"
178
- * **target** - specify a TARGET override, e.g. target="_blank"
179
- * **width** - this specifies the width of the thumbnail image
180
- * **height** - this specifies the height of the thumbnail image
181
- * **version** - which version of the thumbnail to use. This can be `default`, `hq` (for a high quality version of the default image), `start`, `middle` or `end`. The latter 3 indicate where from the video the thumbnails are taken from
182
-
183
- e.g. `youtube_thumb_embed( 'id', 'rel=nofollow&target=_blank', '', 'Demo Video' )`
184
-
185
- To use the shortcode method, insert `[youtube_thumb]id[/youtube_thumb]` into a post or page to create a thumbnail of the relevant video ID which, once clicked, will open up the appropriate YouTube page.
186
-
187
- Like the function call above, you can specify a number of parameters. They are the same as detailed above but with the addition of one further parameter...
188
-
189
- * **alt** - specify some `ALT` text for the thumbnail image
190
-
191
- e.g. `[youtube_thumb target="_blank" alt="Demo video"]id[/youtube_thumb]`
192
-
193
- This overrides the `TARGET` and `ALT` elements of the thumbnail.
194
-
195
- You can also use `nolink` as a parameter with the shortcode, which works in the same way as with the function call.
196
-
197
- == Shortened URL ==
198
-
199
- You may return a short URL for any YouTube video by way of either a function call or a shortcode.
200
-
201
- For a function call add `youtube_short_url( 'id' )` to your code to return a URL (note that this is not written out, but returned as a value), where `id` is the video ID.
202
-
203
- e.g. `<a href="<?php echo youtube_short_url( 'Z_sCoHGIpU0' ); ?>"Click here for video</a>`
204
-
205
- This will create a link to a video using the short URL standard.
206
-
207
- To use the shortcode method simply insert `[youtube_url id=xx]` anywhere within a post to return a shortened URL. `xx` is the ID of the video.
208
-
209
- == Downloading Videos ==
210
-
211
- If you wish your users to be able to download a YouTube video or playlist then you can do this automatically or manually via either a shortcode of PHP function call.
212
-
213
- In the Profiles screen within administration there is an option to automatically show a download link. You can specify some text or HTML to display as well as CSS.
214
-
215
- If you'd prefer to do this manually then the function call is named `get_video_download` and has one parameter - the video ID. It will return the download link URL.
216
-
217
- e.g. `<a href="<?php echo get_video_download( 'Z_sCoHGIpU0' ); ?>">Download the video</a>`
218
-
219
- Alternatively, you can use the shortcode `download_video`. The content to link is specified between the open and close shortcode tags and there are 3 parameters...
220
-
221
- * **id** - The ID of the video or playlist. This is required.
222
- * **target** - The target of the link (e.g. `_blank`). This is optional.
223
- * **nofollow** - yes or no, use this to specify whether a `nofollow` tag should be added to the link. This is optional and by default it will be included.
224
-
225
- e.g. `[download_video id="Z_sCoHGIpU0" target="_blank"]Download the video[/download_video]`
226
-
227
- == Further Embedding Options ==
228
-
229
- Under the `YouTube Embed` administration menu is a sub-menu named `General Settings`. Select this and find the section named `Embedding`. There are 2 options here...
230
-
231
- 1. Add Metadata - by default, RDFa metadata is added to video output. This can be switched on or off as required (see the FAQs for more information about metadata usage).
232
- 2. Feed - videos will not appear in feeds so use this option to decide whether you want them to be converted to links and/or thumbnails.
233
-
234
- == Third Party Plugins ==
235
-
236
- From the `YouTube Embed` administration menu there is a `3rd Party Plugins` sub-menu. This will list a number of WordPress plugins that can work alongside YouTube Embed to add extra functionality. From this screen you can view, install and see the status of each plugin.
237
-
238
- In some cases activating these plugins will cause their settings screen to also appear under the `YouTube Embed` menu, for extra convenience.
239
-
240
- **By listing these plugins, we provide no guarantees that they work correctly and we certainly don't provide any support for them.**
241
-
242
- If you'd like your own plugin adding to this list then please [get in touch](http://www.artiss.co.uk/plugin-contact "Contact").
243
-
244
- == Reviews & Mentions ==
245
-
246
- [Your YouTube Plugin is fantastic-it just saved my life on this site. Thank you!](https://twitter.com/AaronWatters/status/237957701605404672?uid=16257815&iid=am-130280753913455685118891763&nid=4+248 "Twitter - Aaron Watters") - Sonic Clamp.
247
-
248
- [New Technology Finds The Most Buzzed-About Parts Of Videos](http://www.socialtimes.com/2011/03/new-technology-finds-the-most-buzzed-about-parts-of-videos-interview/ "New Technology Finds The Most Buzzed-About Parts Of Videos") - SocialTimes.
249
-
250
- [Andesch tips on WordPress plugins!](http://andershagstrom.se/andesch-tipsar-om-wordpress-plugins/ "Andesch tipsar om WordPress-plugins!") - Anders.
251
-
252
- [Critical Mass](http://www.bikinginmemphis.com/2011/03/26/critical-mass/ "Critical Mass") - Biking in Memphis.
253
-
254
- [Embedding YouTube Videos In Your WordPress Theme](http://frogenyozurt.com/2011/04/embedding-youtube-videos-in-your-wordpress-theme/ "Embedding YouTube Videos In Your WordPress Theme") - FrogenYozurt.Com.
255
-
256
- == Installation ==
257
-
258
- YouTube Embed can be found and installed via the Plugin menu within WordPress administration. Alternatively, it can be downloaded and installed manually...
259
-
260
- 1. Upload the entire `youtube-embed` folder to your wp-content/plugins/ directory.
261
- 2. Activate the plugin through the 'Plugins' menu in WordPress.
262
- 3. Now you can add the shortcode to your posts and pages!
263
-
264
- == Frequently Asked Questions ==
265
-
266
- = I've upgraded to version 4.0+ from an earlier version and I was using the widget feature to display videos =
267
-
268
- I previously allowed some, although not all, parameters to be specified within the widget. However, as you can simply create your own profile for widgets I have removed this and, without leaving lots of redundant code behind, it was difficult to keep this backwards compatible.
269
-
270
- Therefore, if you're upgrading you may find your widgets don't now display correctly. The best thing to do, beforehand if you can, is to create a profile just for the widgets and assign that to each. You'll probably find the video size is the bit most likely to cause issues. Apologies for this.
271
-
272
- = How do I find the ID of a YouTube video? =
273
-
274
- If you play a YouTube video, look at the URL - it will probably look something like this - `http://www.youtube.com/watch?v=L5Y4qzc_JTg`.
275
-
276
- The video ID is the list of letters and numbers after `v=`, in this case `L5Y4qzc_JTg`.
277
-
278
- = The video output is overlapping or stuttering =
279
-
280
- If you go into the Profile screen in Administration there is a "Window Mode" option. This defines how Flash output interacts with any other around it. "Window" is the default and gives good performance but may cause overlapping. If overlapping is causing an issue try "Opaque".
281
-
282
- = I'm getting an error saying that "an alternative plugin is using the [youtube] shortcode" =
283
-
284
- As this suggests another plugin that you have installed is using the same shortcode as YouTube Embed. That means that use of the `youtube` shortcode won't work. You have 2 possible actions to take...
285
-
286
- 1. Disable the conflicting plugin. If it's Jetpack then you can disable the Shortcode Embeds module.
287
- 2. Leave it as it is and use the option to use a second shortcode with this plugin. Head to the YouTube Embed settings screen and you can set up a secondary shortcode. You can also switch off the nag message too from here.
288
-
289
- = The "autostart" feature is not working in iOS =
290
-
291
- Unfortunately, this is a restriction that has been put in place by Apple.
292
-
293
- = I can't get the video to play at a specific resolution by default =
294
-
295
- There is no way to specify this - YouTube makes the decision on which version to play depending on a number of factors.
296
-
297
- = There are black borders on top/underneath my video =
298
-
299
- This is usually due to using a different ratio than the video was designed for. If you're not sure which ratio to use head to its page on YouTube, click on Share and then Embed and then Show More. A video size will be shown, which you can use to work out the correct ration for the video.
300
-
301
- = The controls under the video don't display properly when using Firefox =
302
-
303
- This is a bug in Firefox. Short term, switch on SSL in the Profiles screen and it will work. Longer term, I've [raised a bug report with Mozilla](https://bugzilla.mozilla.org/show_bug.cgi?id=1223515 "Bug 1223515 - Broken images in YouTube embedded player when not using SSL").
304
-
305
- = The generated code does not cleanly validate =
306
-
307
- No, by default it doesn't but it works absolutely fine as it. However, if you really must cleanly validate against HTML5 or transitional XHTML then head into the YouTube Embed settings screen and you'll find an option to "Improve Validation". Tick this and Save and it should validate.... UNLESS you have the metadata option switched on, in which case it won't validate still (sorry, I'm a slave to Google on this one!). Switch that off though and you're 100%.
308
-
309
- One thing to note - by switching on "Improve Validation" you'll extend the length of the URL line that's passed to YouTube. Please see the next FAQ to understand this better.
310
-
311
- = I'm getting the error "The maximum URL length has been exceeded" when trying to view a video =
312
-
313
- When embedding a video a URL for YouTube is generated - this contains all the non-default parameters that you've specified and, if you've created a manual playlist, all of the video IDs. Unfortunately, URLs can only be 2000 characters in size. If this is exceeded you'll get the above error message when you try and view the video.
314
-
315
- The solution is to reduce this down by reducing down your playlist or, if you have the "Improve Validation" settings switched on, switching that back off.
316
-
317
- = I have another issue or a request =
318
-
319
- Before reporting it please bear in mind that this plugin uses the standard YouTube API. Adding extra functionality to the player itself is not possible and there are [known issues](https://code.google.com/p/gdata-issues/issues/list?q=label:API-YouTube "YouTube API Known Issues") with it. I would also recommend performing a Google search for your issue too first, as this will often resolve a lot of queries.
320
-
321
- == Screenshots ==
322
-
323
- 1. YouTube Embed in the administration menu
324
- 2. The main options screen
325
- 3. The profiles screen
326
- 4. The lists screen - videos have been added and validated. The drop-down help is also shown
327
- 5. The default widget options
328
  6. The default visual editor options with the YouTube Embed button
329
- 7. The third party plugins menu
330
-
331
- == Changelog ==
332
-
333
- = 4.3.1 =
334
- * Bug: Had removed a function (by accident, you understand) that converted the old alternative shortcode settings to a new format. The result is that the conversion didn't take place and an array was passed as a shortcode name to WordPress Core, generating an error. The function has been added back in.
335
-
336
- = 4.3 =
337
- * Enhancement: Added new "Third Party Plugins" screen, which lists third party plugins that work alongside YouTube Embed, adding extra functionality. You can view, install and see the status of these plugins from this screen
338
- * Maintenance: Moved the settings back to the YouTube Embed menu
339
- * Maintenance: Renamed menus to be more specific
340
- * Maintenance: Updated the function names, which were still using the out-dated "vye" prefix
341
-
342
- = 4.2.1 =
343
- * Bug fix: Quotes were not being dealt with correctly in the template field. Now corrected.
344
-
345
- = 4.2 =
346
- * Enhancement: Re-written the core embedding code. Redundant code removed and, for the remaining code, re-imagined to improve performance
347
- * Enhancement: Massively changed how the plugin retrieves saved options and, in particular, how I populate default values. The result? Even better performance
348
- * Enhancement: Reviewed and reduced the calls to fetch the options
349
- * Enhancement: Added a new general option to allow you to force a list type to be specified before a list can be used. The reason? By doing this the code doesn't have to check if the ID it a list name each time and it improves performance. For those upgrading this will be switched off by default to maintain backwards compatibility
350
- * Enhancement: Admin bar options only appear if viewing the admin bar on the site (showing it whilst in the admin screens seemed rather pointless)
351
- * Enhancement: If you use [WordPress Video Overlay Ads](https://wordpress.org/plugins/video-overlay-ads/ "WordPress Video Overlay Ads") or [Video SEO for WordPress](http://yoast.com/wordpress/video-seo/ "Video SEO for WordPress") then the settings menus will appear under the YouTube Embed menu
352
- * Enhancement: SSL options removed as it's now used by default, including with thumbnails and schema.org links
353
- * Enhancement: Improved the RSS feed output for search or user upload requests
354
- * Maintenance: Removed some deprecated elements in the code
355
- * Maintenance: Updated includes so that plugin folders were not hardcoded
356
- * Maintenance: Updated which functions I was using to retrieve folder names so that they are fully SSL compatible
357
- * Maintenance: Removed a load of redundant functions
358
- * Maintenance: Replaced a function with a PHP command but this means that the plugin is no compatible with PHP versions below 5.1
359
- * Maintenance: Tidied up the list screen further
360
- * Maintenance: Replaced the 'dynamic' parameter with 'responsive' which, as a name, is far more accurate. 'dynamic' will still work, though.
361
- * Maintenance: Improved admin screen validation and sanitisation
362
- * Bug fix: Uninstall wasn't clearing up properly on multisites
363
-
364
- = 4.1.1 =
365
- * Bug fix: Corrected settings URL in plugin meta.
366
- * Bug fix: If plugin has never run before, ensure a default options array is generated.
367
- * Maintenance: Removed donation options and updated branding.
368
-
369
- = 4.1 =
370
- * Enhancement: Added 'Plays inline' option for iOS devices.
371
- * Enhancement: Added extra Closed Caption option to better reflect how YouTube works - either on, off, or user default.
372
- * Enhancement: Added new option to force HTML5 playback (if available). This is an undocumented feature and, as such, may not actually work, depending on YouTube's current mood. If YouTube aren't going to support it then I'm certainly not going to so please don't shout if it doesn't work.
373
- * Enhancement: Lovely new icons for the lists page.
374
- * Enhancement: Improved the layout of the demo video on the profiles page.
375
- * Enhancement: Added a count to the profiles and lists screen to indicate how many are set up. Also showed on drop-down which of the profiles/lists are not defined.
376
- * Enhancement: Changes made to add compatibility with a3 lazy load.
377
- * Enhancement: Removed the caching - it created the output up to 3 times quicker but when that's 0.005 seconds it's not worth the hassle that comes with it. I started making performance improvements to compensate then realised it was such a big change that it would be best spun off as it's own seperate update - version 4.2. Look out for it.
378
- * Enhancement: Removed limitation of only being able to display up to 30 lists or profiles.
379
- * Enhancement: When you can select a profile from another screen (e.g. defining a profile to an alternative shortcode) then only defined profiles will be listed.
380
- * Enhancement: Added general option to specify the YouTube interface language as well as to suppress debug output in the resulting code.
381
- * Enhancement: Fixed validation errors against thumbnails.
382
- * Enhancement: Changed the "Frameborder" option to a more general "Improve Validation" which does, well, just that. It improves the generated markup so that it will validate better (if that's your bag).
383
- * Enhancement: Added option to use a third party script to handle content resizing. Implemented [iFrame Resizer](https://github.com/davidjbradshaw/iframe-resizer "iFrame Resizer") v3.5.1 and [FitVids.js](https://github.com/davatron5000/FitVids.js "FitVids.js") 1.1.
384
- * Enhancement: If another plugin is using the same shortcode as this I now output a prompt in the admin area. Also added a setting to turn off this prompt just in case you're using the secondary shortcode and are happy for this.
385
- * Enhancement: Re-written code for help screens, including adding more information and additional tabs.
386
- * Maintenance: Moved the settings page to, well, the Settings menu option. It makes sense.
387
- * Maintenence: Removed the enable of the JS API, which is now deprecated.
388
- * Maintenance: Improved the admin screen output code - had made it more WordPress standard in version 4 but got some of the code wrong.
389
-
390
- = 4.0.2 =
391
- * Maintenance: Not really a bug, but in some circumstances I wasn't initialising a variable used when generating the embed code. It worked fine but wasn't best practise so fixed. Sloppy.
392
- * Maintenance: Modified the default parameters so new user videos should appear with the same options as on YouTube itself. Consistent.
393
- * Maintenance: I ABSOLUTELY refuse to call this a bug. But I was calling get_the_excerpt() to build some of the video meta data. For some reason, still unknown to me, other plugins were crashing as a result of it. I've removed it for now but am investigating the cause. Frustrating.
394
- * Enhancement: WMODE is now only added to the embed URL if it's anything other than the default. Shrinkage.
395
-
396
- = 4.0.1 =
397
- * Maintenance: Left some debug code in by mistake. Doh. Sometimes I'd forget my own head if it wasn't screwed on.... Apologies to those affected.
398
-
399
- = 4.0 =
400
- * Maintenance: Removed a number of redundant/broken features. [Learn more](http://www.artiss.co.uk/youtube-embed-removed-features "Removed Features").
401
- * Maintenance: Updated download link to use KeepVid.
402
- * Maintenance: Re-written admin screen to use WordPress standard method of displaying settings. Oh, and the widget settings too.
403
- * Maintenance: ...speaking of which, revised the options available to widgets.
404
- * Maintenance: Merged many of the files where there wasn't a huge amount of content.
405
- * Maintenance: Renamed menu slugs as they were too generic and may cause clashes with other plugins or themes that are silly enough to do the same thing.
406
- * Enhancement: Revised profile screen to make it clearer, via the art of the icon, which parameters are compatible with which embed type.
407
- * Enhancement: If you go a bit "ape" with the parameters and manual playlists, it's possible to exceed the URL size limit. I've now put a check in place to report this, if it occurs.
408
- * Enhancement: Added modest branding as a parameter (before was only selectable via the profile screen).
409
- * Enhancement: Improved the meta data.
410
- * Bugs: Many of them. Fixed. Hoorah.
411
-
412
- = 3.3.5 =
413
- * Maintenance: Added missing text domain, ready for automatic translation.
414
-
415
- = 3.3.4 =
416
- * Maintenance: Updated admin screen headings for compatibility with 4.3.
417
- * Maintenance: Updated demo video on profile page. Just because.
418
- * Bug: Fixed (I hope) the problem with the editor button not appearing for some users. Thanks to Mark Aarhus for getting to the bottom of this for me.
419
- * Enhancement: Added donation link to plugin meta. Because I'm worth it.
420
-
421
- = 3.3.3 =
422
- * Maintenance: Now working with newer playlist IDs (README instructions chaneged to reflect how to do this)
423
- * Maintenance: Resolved widget issues with version 4.3 of WordPress
424
- * Maintenance: Eliminated XSS problem in admin profile screen
425
-
426
- = 3.3.2 =
427
- * Bug: One of the files was corrupt in the previous release - this is now fixed. Sorry :(
428
-
429
- = 3.3.1 =
430
- * Maintenance: Remove reference to Google API, as videos are now not displaying as a result of v2 being retired. Will update the plugin more fully in future release
431
-
432
- = 3.3 =
433
- * Maintenance: Ding, dong Applian has gone. Removed Vixy branding, updated README and language files to match
434
- * Maintenance: Removed those Vixy download links and restored the old method - will enhance this in a future release
435
- * Maintenance: Plugin had too much baggage so it could support old versions of WordPress. Why? Updated it to only support more recent versions but have removed lots of un-needed guff as well. The result - this version is 15% slimmer than the previous version. Win!
436
- * Maintenance: Spruced up the admin screens to match the new WordPress styling
437
- * Bug: Resolved a number of bugs as reported by users and spotted by myself. Thanks all! More fixes to come
438
-
439
- = 3.2.1 =
440
- * Bug: Fixed issue where playlist was appearing for single videos
441
- * Maintenance: Improved Metadata standard
442
-
443
- = 3.2 =
444
- * Bug: Prevented download bar SPAN from appearing even when switched off
445
- * Bug: Fixed issue that caused playlists to not appear
446
- * Enhancement: Added new shortcode for displaying video comments
447
- * Enhancement: IFRAME output now includes metadata
448
- * Enhancement: Editor button will now work with MCE4 editor (WP 3.9+)
449
- * Enhancement: SVG icon used in admin menu for WP 3.8+
450
-
451
- = 3.1 =
452
- * Enhancement: Allow user to specify video resolution required (experimental)
453
- * Enhancement: Different languages can be specified for transcripts, other than the English default
454
- * Enhancement: API enabled on scripts by default, allowing for third-party modification
455
- * Enhancement: Can now add a link to YouTube under a video
456
- * Maintenance: Removed adverts from administration screen
457
- * Maintenance: Changed download bar default to be opt-in and re-worded option text
458
-
459
- = 3.0.1 =
460
- * Bug: Fixed menu options shown in admin bar
461
- * Maintenance: Updated links to point to instructions on Vixy.net website
462
- * Enhancement: Validate download bar code to ensure it's secure
463
- * Enhancement: Passing blog language to language bar for i18n
464
-
465
- = 3.0 =
466
- * Maintenance: Changed name, updated adverts, removed donation and sponsorship requests
467
- * Maintenance: Renamed function to match new name and also removed prefix from files, which were not required
468
- * Maintenance: Checked and updated all help URLs
469
- * Maintenance: Removed about and instruction pages which were felt were no longer needed
470
- * Maintenance: Updated icons
471
- * Enhancement: Updated download links to use code from Vixy. This is now switched on by default
472
- * Enhancement: Added option to provide an affiliate ID for use with the download bar - blog owners can make 30% from sales generated
473
- * Enhancement: Simplified the menu access rules which has resulted in resolving a number of existing issues
474
- * Bug: Fixed PHP error when allowing shortcodes in widgets
475
-
476
- = 2.7 =
477
- * Maintenance: Using new website for video download link
478
- * Maintenance: README updated with new compatibility details and modified FAQs
479
- * Bug: Fixed a bug where some option screen text was not displaying
480
- * Bug: Fixed the feature pointer, which was no longer working
481
- * Enhancement: Added profile options to allow you to switch on video download link, as well as style the output
482
-
483
- = 2.6.2 =
484
- * Bug: Fixed bug in uninstall routine
485
- * Enhancement: Replaced user of print_r in cache key generator with serialize, as this can cause problems with some hosting configurations
486
-
487
- = 2.6.1 =
488
- * Bug: Fixed minimised script that adds editor button
489
- * Bug: Updated broken advert links
490
- * Bug: Fixed link in admin bar when using WP 3.1 - 3.3
491
- * Bug: Removed un-necessary cookie update that was causing errors in some situations
492
- * Maintenance: Updated WP 3.3+ admin bar options to correctly reflect permissions, naming and ordering of equivalent admin menu
493
-
494
- = 2.6 =
495
- * Bug: Fixed a bug that means videos have zero width on new installations until the default profile is updated (thanks to Aidan from [Noise Republic](http://www.noiserepublic.co.uk "Noise Republic") for reporting that)
496
- * Bug: Corrected URLs pointing to help screens
497
- * Bug: Resolved issue where translated IDs were not corrected if included in a URL (thanks to kchayka for reporting that)
498
- * Bug: Fixed problem where video ID is not found in full URL if not specified first (thanks to christopherw for reporting that)
499
- * Bug: Modest branding profile switch wasn't doing anything - the option was hard-coded on. Now corrected
500
- * Bug: User defined error message now decodes correctly (thanks to kchayka for reporting that)
501
- * Bug: No longer caches the video output if a random playlist has been selected
502
- * Maintenance: Updated advertisement engine code
503
- * Maintenance: Renamed README menu to Instructions
504
- * Maintenance: Assorted on-screen wording improvements
505
- * Maintenance: Removed title option as it's un-supported
506
- * Maintenance: Updated the uninstall routine
507
- * Maintenance: Cleaned code and updated translation files
508
- * Enhancement: Added Do Not Track compatibility. Once active, if user has Do Not Track in use then cookies will not be stored
509
- * Enhancement: New option to specify the shortcode that the editor button uses. A cookie is used to store this
510
- * Enhancement: New option to switch on shortcodes in widgets. This will allow all shortcodes in widgets, though, not just those for this plugin
511
- * Enhancement: Reviewed and updated access right to admin screen. Added option to choose what level has access to profiles and/or lists screen
512
- * Enhancement: Many functions were only activated if user was not in Administration screens. However, using AJAX on your site triggers the administration flag and, hence, the functions would not work. Changed this
513
- * Enhancement: Added option to modify access to Profile and Lists screen
514
- * Enhancement: Improved the cache clearing option and statistics
515
- * Enhancement: Reflected on profile screen that modest branding now works with HTML5 player
516
- * Enhancement: Added option to thumbnail output to suppress the link, so that you can add your own
517
- * Enhancement: Updated "Controls" option to support new third parameter and update definitions. Ensured backwards compatibility with old parameter options
518
-
519
- = 2.5.6 =
520
- * Maintenance: Restricted access to Options and Profiles screen to administrators
521
- * Bug: Fixed bug which caused errors to be generated on new installations of plugin
522
- * Enhancement: Set a default width if the `content_width` global variable is set to zero
523
-
524
- = 2.5.5 =
525
- * Maintenance: Updated sponsorship - now includes option to switch off if user has donated
526
- * Maintenance: Updated options screen to reflect the fact that the `related` and `color` parameters are now supported by the HTML5 player
527
- * Maintenance: Updated options screen to show that the `info` parameter, if used alongside a playlist will show thumbnails of the videos
528
- * Maintenance: Removed redundant GA code, which was never used
529
- * Maintenance: Combined scripts
530
- * Bug: Fixed internationalisation
531
- * Bug: Fixed output of video information on the Lists option screen
532
- * Bug: Modified cache key so that length does not exceed MySQL field maximum
533
- * Bug: Added close anchor for media meta - causes unclosed anchor under IE9 (thanks to Marcel Bootsman for identifying this)
534
- * Bug: Responsive video was not working on a demonstration video in Profile screen
535
-
536
- = 2.5.4 =
537
- * Bug: Fixed bug that prevented some fields in options screens to not save
538
-
539
- = 2.5.3 =
540
- * Bug: Fixed further issues with the widget code (thanks to Rose-Anne Constantineau for reporting it and helping me test the result)
541
- * Maintenance: Improved some of the internationalisation texts
542
- * Maintenance: Neatened up some of the code output
543
-
544
- = 2.5.2 =
545
- * Bug: Fixed a bug where widgets weren't showing single videos (thanks to Josh Callaghan for reporting this)
546
-
547
- = 2.5.1 =
548
- * Bug: Fixed a bug with Admin Bar when using WP 3.1 - 3.3 (thanks to Carl D'Halluin for finding this)
549
-
550
- = 2.5 =
551
- * Maintenance: Updated code to work with new playlist options
552
- * Maintenance: Removed embedded URL option due to issues with existing code (see FAQ for details)
553
- * Maintenance: Added further FAQs based on common forum queries
554
- * Maintenance: Wording on options screens changed to better identify differences between players
555
- * Maintenance: Added advertisement to profile screen
556
- * Maintenance: Modified demonstration video and made sponsorship request more visible
557
- * Maintenance: Changes the YouTube admin screen icon
558
- * Enhancement: Download link now uses deturl.com
559
- * Enhancement: Admin Bar link improved in WP 3.3 onwards
560
- * Enhancement: New user upload and search features added
561
- * Enhancement: Now supports ability to specify the time to stop video playback
562
- * Enhancement: Default windowing mode changed to improve performance
563
- * Enhancement: FRAMEBORDER is switchable for the purpose of HTML5 compatibility
564
- * Enhancement: Added internationalisation
565
- * Enhancement: README in admin menu now shows the corresponding README for the version of the plugin you have installed, rather than the latest one
566
- * Enhancement: Added option to admin screen to clear video cache (see FAQ for details)
567
- * Enhancement: Allow recursive shortcodes - that is, shortcodes within the YouTube shortcode
568
- * Bug: Fixed bug in retrieving the video title
569
- * Bug: Resolved various debug messages
570
- * Bug: Fixed bug in MCE button JavaScript
571
-
572
- = 2.4.1 =
573
- * Maintenance: Removed dashboard widget
574
-
575
- = 2.4 =
576
- * Maintenance: Re-sequenced the changelog in the README
577
- * Maintenance: Removed drop shadow option
578
- * Maintenance: Re-design of widgets, reducing number of parameters down to make it easier to use - use profiles to modify missing parameters
579
- * Maintenance: Updated YouTube icons
580
- * Enhancement: Added frameborder="0" to IFRAME code
581
- * Enhancement: Added Privacy-Enhanced mode. Doesn't work with Chromeless player.
582
- * Enhancement: Added `title` option, so you can name the video
583
- * Enhancement: Added `ssl` option, allowing you to override whether HTTP or HTTPS is used for the video
584
- * Enhancement: Added `dynamic` option (and matching Profile switch) to allow users to request dynamically resizing video (responsive). Additional option to allow specified width to be maximum
585
- * Enhancement: Made `modestbranding` a switchable option (switchable in profile options but not on video-by-video basis) due to issues with Apple devices
586
- * Enhancement: Improved matching of URL embedded into post
587
- * Enhancement: If you have the [README Parser plugin](http://wordpress.org/extend/plugins/wp-readme-parser/ "README Parser") installed then a new sub-menu will display the README instructions
588
- * Enhancement: Use WP 3.3 Feature Pointer to highlight new menu when plugin is activated
589
- * Bug: Ensure `showinfo` parameter is set correctly
590
- * Bug: If width or height is missing from Profile screen then fill it in based on widescreen format. Otherwise, causes video to break
591
- * Bug: Video information was being fetched from caching even if option selected to switch it off. Fixed!
592
-
593
- = 2.3.1 =
594
- * Maintenance: Removed the sponsorship
595
-
596
- = 2.3 =
597
- * Enhancement: Editor button will add text between shortcodes if no URL or ID is specified
598
- * Enhancement: Square brackets are stripped from alternative shortcodes on option screen - text added to warn against this too
599
- * Enhancement: Added Chromeless player option
600
- * Enhancement: Increased maximum output length of profile and list names to 30 characters
601
- * Bug: Fixed incorrect listing of long profile or list names
602
- * Bug: Fixed INCLUDE bug in widgets.php
603
-
604
- = 2.2 =
605
- * Maintenance: Updated dashboard widget to latest version
606
- * Maintenance: Added advertising banners to options screen - these can be turned off if you donate
607
- * Enhancement: Replace WP_PLUGIN_URL with plugins_url()
608
- * Enhancement: Added H and W as alternative shortcode parameters to HEIGHT and WIDTH
609
- * Enhancement: Editor button should appear for anyone from editor role upwards
610
- * Enhancement: Removed maximum length from profile and list names. However, only first 20 characters will appear in lists
611
-
612
- = 2.1 =
613
- * Enhancement: New option to switch API options (where HTTP or HTTPS, display messages or not or even switch off)
614
- * Enhancement: Output video playback errors as XHTML comments. Output to post a generic message which can be changed in the options
615
- * Enhancement: Video information is shown in lists screen when first entering (no need to press Save button to display)
616
- * Enhancement: Added new `color` parameter, which allows you to specify the color of the progress bar
617
- * Enhancement: Added new `theme` parameter, allowing you to specify if the player is dark or light skinned
618
- * Enhancement: Added new `https` parameter, allowing you to use HTTPS instead of HTTP for the video display
619
- * Enhancement: Added new `version` parameter to thumbnails, allowing different versions (including a high resolution one) to be displayed
620
- * Enhancement: Added new administration option to allow the thumbnail used in RSS feeds to be specified
621
- * Enhancement: Log the current plugin version into the database. This may be of use in future upgrades to detect which version the user is upgrading from
622
- * Bug: Fixed video title no longer being fetched since 2.0.3 (because of using v2 of API)
623
- * Bug: Fixed some error output - due to changes made in an earlier release some errors would not display
624
-
625
- = 2.0.4 =
626
- * Enhancement: Removed HTTPS access to gdata API - will add a switchable option for this in a later release
627
-
628
- = 2.0.3 =
629
- * Enhancement: Decode any passed `template` parameters, as WP may have encoded the content first
630
- * Enhancement: Improved file handling
631
- * Enhancement: Now using HTTPS and version 2 of YouTube gdata API
632
- * Enhancement: New general option to switch off reporting of API errors - will simply accept ID and work out type
633
- * Maintenance: Added details to the README to cover issues with `style` backwards compatibility and YouTube API
634
-
635
- = 2.0.2 =
636
- * Enhancement: Strip tags from video ID, in case any have crept in
637
- * Enhancement: Tidied some of the widget controls
638
- * Enhancement: You can now specify YouTube short URLs as video IDs
639
- * Bug: Removed reference to jscolor.js script, which isn't used
640
- * Bug: Video IDs beginning with numbers are being confused with list numbers
641
- * Bug: Corrected problem with random single videos being picked from a list
642
- * Bug: Fixed problem with list where one video was being ignored and another repeated
643
- * Bug: Modified widget code to allow for all states to be allowable. Defaults updated
644
- * Bug: YouTube documentation states that if you don't specify the fullscreen parameter it will default to off. It doesn't. Corrected in the code
645
-
646
- = 2.0.1 =
647
- * Enhancement: Changed cache key encoding so that it was compatible with PHP 4
648
- * Enhancement: Added autoplay option to EmbedPlus
649
- * Enhancement: Re-instated `style` option, allowing you to apply a direct set of CSS elements to the output - a requirement if you wish to add a border to the video, for instance
650
- * Maintenance: Updated screens and documentation to show the `start` parameter works with EmbedPlus
651
- * Bug: Fixed incorrect caching of options - was only changing if override parameters were modified
652
- * Bug: Video Information Cache will no longer reset to zero if the Embed cache is greater
653
- * Bug: Added random ID to EmbedPlus output to resolve a bug that can affect IE users
654
-
655
- = 2.0 =
656
- * Maintenance: Renamed to Artiss YouTube Embed from YouTube Embed
657
- * Maintenance: Major re-write, using new coding standards
658
- * Maintenance: AS3 player is now used, AS2 has been retired
659
- * Maintenance: Compliancy and browser checked - XHTML and HTML5 compliant and works in all the latest browsers
660
- * Maintenance: README completely re-written, contextual help added to admin screens and links to further information
661
- * Enhancement: New administration screens, introducing multiple profiles and playlists
662
- * Enhancement: Both OBJECT and IFRAME versions can be selected
663
- * Enhancement: Migration options added, allowing compatibility with other similar plugins
664
- * Enhancement: Can now specify full video URL as well as video ID
665
- * Enhancement: No need to use separate shortcode for playlists, as they are automatically detected. Video IDs are also now validated
666
- * Enhancement: Options to allow YouTube URLs not within shortcodes to be accepted, as well as in comments
667
- * Enhancement: RDFa metadata added to code output
668
- * Enhancement: Caching of code and ID checking to improve performance
669
- * Enhancement: Templating system replaces CSS specification
670
- * Enhancement: Improved editor button and link added to admin bar
671
- * Enhancement: Many, many more changes - too many to list!
672
-
673
- = 1.5 =
674
- * Enhancement: Added clone of 'youtube' shortcode, called 'youtube_video'
675
- * Enhancement: Editor now has YouTube button, which inserts the YouTube shortcode (this can be switched off in the options screen)
676
- * Enhancement: Added new option to disable keyboard controls
677
- * Enhancement: Added option to supply a ratio, in case height or width are not supplied - the missing parameter will then be calculated
678
- * Enhancement: Option to create a download link (for video and playlist) using function call or shortcode
679
- * Enhancement: You can now change on the options screen which set of parameters the demonstration video uses (i.e. "normal" or EmbedPlus). This allows you to try your options on a different video type without switching to it.
680
-
681
- = 1.4.2 =
682
- * Enhancement: Added keyboard disable option
683
- * Bug: Fixed bug which meant that people upgrading from previous versions may not be able to display video until they've been to the options screen and re-saved their default options
684
-
685
- = 1.4.1 =
686
- * Enhancement: HD option is available with EmbedPlus - updated the admin and widget screen to reflect this
687
-
688
- = 1.4 =
689
- * Maintenance: Tidied up code
690
- * Enhancement: Now supports multiple widgets - widget code completely re-written
691
- * Enhancement: Support for EmbedPlus added
692
- * Enhancement: Added option to suppress links back to YouTube
693
- * Enhancement: Added functions and shortcodes for returning and outputting available transcripts
694
-
695
- = 1.3.1 =
696
- * Enhancement: New widget option to specify title
697
-
698
- = 1.3 =
699
- * Enhancement: Added transparency option so that videos won't cover up layers
700
-
701
- = 1.2 =
702
- * Enhancement: Minor changes to the XHTML code to prevent warnings from certain validators
703
-
704
- = 1.1 =
705
- * Maintenance: Updated test video on options screen, as previous one had been removed
706
- * Maintenance: Confirmed WP 3.0 compatibility
707
- * Enhancement: Resulting XHTML code is better formatted, with comments identifying code location
708
-
709
- = 1.0 =
710
- * Initial release
711
-
712
- == Upgrade Notice ==
713
-
714
- = 4.3.1 =
715
- * Upgrade to fix an urgent issue that can generate WordPress errors
716
-
717
- = 4.3 =
718
- * Upgrade to add a new third party plugin screen
719
-
720
- = 4.2.1 =
721
- * Important update to fix a bug with the template field
722
-
723
- = 4.2 =
724
- * Who needs caching when the code works this fast? It's now 365% quicker than version 4.1. Completely re-written core code for rip-roaring speed
725
-
726
- = 4.1 =
727
- * Loads and loads of new features. Because I love you all.
728
-
729
- = 4.0.2 =
730
- * Minor bug fixes
731
-
732
- = 4.0.1 =
733
- * Upgrade to remove some debug code
734
-
735
- = 4.0 =
736
- * Fixed, squeezed and reduced. Make sure you read the changelog before upgrading!
737
-
738
- = 3.3.5 =
739
- * Update with text domain, ready for automatic translation
740
-
741
- = 3.3.4 =
742
- * Assorted fixes and enhancements inc. (I hope) a fix to the editor button not working
743
-
744
- = 3.3.3 =
745
- * Fix to resolve multiple urgent issues
746
-
747
- = 3.3.2 =
748
- * An urgent fix to the urgent fix, due to a corrupt file
749
-
750
- = 3.3.1 =
751
- * Urgent fix to get videos displaying. Alternatively, switch off API in Options screen
752
-
753
- = 3.3 =
754
- * Update to fix assorted bugs and to remove the redundant Vixy branding
755
-
756
- = 3.2.1 =
757
- * Update to bring metadata up to latest standards and to fix playlist issue
758
-
759
- = 3.2 =
760
- * Update to add new features, including the ability to show a video's comments
761
-
762
- = 3.1 =
763
- * Update to add new features including video quality option
764
-
765
- = 3.0.1 =
766
- * Update to fix admin bar links and add some further security improvements
767
-
768
- = 3.0 =
769
- * Update for bug fixes and enhancements including a new video download option with affiliate scheme
770
-
771
- = 2.7 =
772
- * Update to fix some bugs and add minor new features
773
-
774
- = 2.6.2 =
775
- * Update to fix an uninstaller bug and a problem that may affect some hosts
776
-
777
- = 2.6.1 =
778
- * Update to fix some bugs introduced in 2.6
779
-
780
- = 2.6 =
781
- * Upgrade to implement numerous bug fixes and enhancements
782
-
783
- = 2.5.6 =
784
- * Upgrade to fix critical bug for new installations
785
-
786
- = 2.5.5 =
787
- * Upgrade for various bug fixes and maintenance updates
788
-
789
- = 2.5.4 =
790
- * Upgrade to fix an issue with options not updating
791
-
792
- = 2.5.3 =
793
- * Upgrade to fix issues with widgets
794
-
795
- = 2.5.2 =
796
- * Upgrade if you use widgets to display videos
797
-
798
- = 2.5.1 =
799
- * Upgrade if you are using a WordPress version before 3.3
800
-
801
- = 2.5 =
802
- * Upgrade to add a number of new features (including automatic generation of playlists based on user name or search term) and fix some bugs
803
-
804
- = 2.4.1 =
805
- * Upgrade to remove the dashboard widget
806
-
807
- = 2.4 =
808
- * Numerous improvements, including new option for responsive video output
809
-
810
- = 2.3.1 =
811
- * Upgrade to remove the sponsorship
812
-
813
- = 2.3 =
814
- * Assorted bug fixes and minor improvements. Also added Chromeless player.
815
-
816
- = 2.2 =
817
- * Assorted minor improvements
818
-
819
- = 2.1 =
820
- * New options to change player colors, chose your thumbnails and control API usage
821
-
822
- = 2.0.4 =
823
- * Fixed SSL bug by removing HTTPS access to API
824
-
825
- = 2.0.3 =
826
- * Removed secure API access as this was causing some users issues
827
-
828
- = 2.0.2 =
829
- * Further update to fix a few minor bugs found in 2.0. A few small enhancements have also been made
830
-
831
- = 2.0.1 =
832
- * Update to fix a few minor bugs found in 2.0 and add a couple of small enhancements
833
-
834
- = 2.0 =
835
- * Upgrade to take advantage of many new features. Code completely re-written
836
-
837
- = 1.5 =
838
- * Upgrade to add a number of new options including video size ratios, disabling keyboard controls, an editor button and different demonstration video options on the admin screen
839
-
840
- = 1.4.2 =
841
- * Upgrade is you upgraded to version 1.4 or 1.4.1 from a previous version, to fix an important bug
842
-
843
- = 1.4.1 =
844
- * Upgrade to make a small correction to the parameter lists
845
-
846
- = 1.4 =
847
- * Update to add EmbedPlus, multi-widgets and transcript output capabilities
848
-
849
- = 1.3.1 =
850
- * Update if you wish to change the widget heading
851
-
852
- = 1.3 =
853
- * Update if you find that the videos are covering up layers
854
-
855
- = 1.2 =
856
- * Update to ensure no warnings are reported by XHTML validators
857
-
858
- = 1.1 =
859
- * Update to get the test video on the options screen working again!
860
-
861
- = 1.0 =
 
 
 
 
 
 
862
  * Initial release
1
+ === YouTube Embed ===
2
+ Contributors: codedart
3
+ Tags: download, embed, embedding, iframe, media, play, playlist, responsive, seo, video, widget, youtube
4
+ Requires at least: 3.9
5
+ Tested up to: 4.4.2
6
+ Stable tag: 4.3.2
7
+ License: GPLv2 or later
8
+ License URI: http://www.gnu.org/licenses/gpl-2.0.html
9
+
10
+ A simple to use method of embedding responsive YouTube videos into your posts and pages but with powerful features for those that need them.
11
+
12
+ == Description ==
13
+
14
+ **Version 4 removes a number of existing features. If you're upgrading from a previous version, please [click here](http://www.artiss.co.uk/youtube-embed-removed-features "Removed Features") for further details. If you were using the widget feature then please head to the FAQ before proceeding.**
15
+
16
+ YouTube Embed is an incredibly simple, yet powerful, method of embedding YouTube videos into your WordPress site. Options include:
17
+
18
+ * XHTML and HTML5 compliant - works with all the latest browsers
19
+ * Dynamic video sizing for responsive sites
20
+ * Build your own playlists and play them back however you want
21
+ * Automatically generate playlists based on user name or search text
22
+ * Create multiple profiles - use them for different videos to get the exact style that you want
23
+ * Google compatible metadata is added to the video output - great for SEO!
24
+ * Fully internationalized ready for translations. **If you would like to add a translation to his plugin then please [get in touch](http://www.artiss.co.uk/plugin-contact "Contact")**
25
+ * Support for Do Not Track
26
+ * Compatible with [Video SEO for WordPress](http://yoast.com/wordpress/video-seo/ "Video SEO for WordPress"), [a3 lazy load](https://wordpress.org/plugins/a3-lazy-load/ "a3 lazy load") and [WordPress Video Overlay Ads](https://wordpress.org/plugins/video-overlay-ads/ "WordPress Video Overlay Ads") and many more. In the case of Video SEO and WordPress Video Overlay Ads, their options will even appear under the YouTube Embed menu for total simplicity!
27
+ * Use [Turn Off The Lights](https://www.turnoffthelights.com/ "Turn Off The Lights")? This plugin works with it beautifully.
28
+ * [iFrame Resizer](https://github.com/davidjbradshaw/iframe-resizer "iFrame Resizer") and [FitVids.js](https://github.com/davatron5000/FitVids.js "FitVids.js") supported to improve content resizing
29
+ * Works "out of the box" with 4K, 60FPS and Chromecast - stream your embedded videos to your TV!
30
+ * And much, much more!
31
+
32
+ There are no premium features and no adverts - this is 100% complete and free! See the "Other Notes" tab for how to get started as well as the more advanced features. How easy is it to use? The fine people at [Webucator](https://www.webucator.com "Webucator") have put together an excellent video showing you how to get started with it..
33
+
34
+ https://www.youtube.com/watch?v=Wc7cvpQS-xQ
35
+
36
+ == Getting Started ==
37
+
38
+ To add a video to a post or page simply use the shortcode `[youtube]video[/youtube]`, where `video` is the ID or URL of the video. Alternatively, you can add one (or more) widgets to your sidebar.
39
+
40
+ Within the administration area, click on YouTube Embed and then General Settings to view and edit default generic settings for the plugin. Also under the `YouTube Embed` menu (see screenshot 1) you can click on the `Profiles` sub-menu to set the default options which define the output of your videos. Any videos you display (unless overridden by parameters - more on that later) will use the settings from the Profiles screen.
41
+
42
+ Although this document contains a lot of information more is available from a series of linked pages, plus as much information as possible is provided on the various administration pages. Whilst on the administration pages, click on the "Help" button in the top right for some useful tips and links. If anything isn't covered and you're unsure of what it does please ask [on the forum](https://wordpress.org/support/plugin/youtube-embed "WordPress Plugins Forum").
43
+
44
+ == Advanced embedding options ==
45
+
46
+ A basic shortcode will embed your video using your default profile settings. However, you may wish to override some of these options on a video-by-video basis - this is done via parameters added to the shortcode.
47
+
48
+ e.g. `[youtube width=300 height=200]Z_sCoHGIpU0[/youtube]`
49
+
50
+ Which options are available depends upon the embedding type you're using as well as the viewers set-up (for example, whether they have Flash installed or not). You can specify any of the parameters but they may be ignored. Please see the Profile screen in Administration for details of which parameters are supported by which embed method.
51
+
52
+ * **annotation** - yes or no, this determines if annotations are shown
53
+ * **autohide** - 0, 1 or 2, this parameter indicates whether the video controls will automatically hide after a video begins playing. The default behaviour, a value of 2, is for the video progress bar to fade out while the player controls (play button, volume control, etc.) remain visible. If this parameter is set to 0, the video progress bar and the video player controls will be visible throughout the video. If this parameter is set to 1, then the video progress bar and the player controls will slide out of view a couple of seconds after the video starts playing. They will only reappear if the user moves her mouse over the video player or presses a key on her keyboard.
54
+ * **autoplay** - yes or no, should the video automatically start playing?
55
+ * **cc** - yes or no, decided whether closed captions (subtitles) are displayed. If you don't specify anything then the user's default will be used.
56
+ * **color** - white or red, the colour of the progress bar (see the FAQ about having a white progress bar with the light theme)
57
+ * **controls** - 0, 1 or 2, this decides whether the controls should display and when the Flash will load. A value of 0 will not show the controls but 1 or 2 will. A value of 2 will load Flash once the user initiates playback - otherwise it's loaded straight away.
58
+ * **disablekb** - yes or no, disable keyboard controls
59
+ * **fullscreen** - yes or no, this will add the fullscreen button to the toolbar. This also works with EmbedPlus.
60
+ * **height** - the video height, in pixels
61
+ * **html5** - yes or no, whether to force HTML5 as the default player or not (if available). NB: This is an undocumented feature and, as such, may not work
62
+ * **info** - yes or no, show video information. If displaying a playlist this will show video thumbnails
63
+ * **list** - if you've specified your own list, use this to select the way the videos should be output. Should be `random` (display videos in a random order), `single` (show just one video, randomly picked from the list) or `order` (show each video in the original order - this is the default)
64
+ * **loop** - yes or no, whether to start the video again once it ends
65
+ * **modest** - reduce the branding on the video
66
+ * **playsinline** - whether videos play inline or fullscreen in an HTML5 player on iOS.
67
+ * **profile** - specify a different default profile (see section on Profiles for further details)
68
+ * **ratio** - allows you to define a window ratio - specify just a height or width and the ratio will calculate the missing dimension. Uses the format x:x, e.g. 4:3, 16:9
69
+ * **related** - yes or no, show related videos
70
+ * **responsive** - whether to use responsive output or not. When switched on the video will resize when your site does (i.e. responsive). If a video width is supplied this will be the maximum width, otherwise full width will be assumed. Height is ignored and will be worked out automatically.
71
+ * **search** - yes or no, create a playlist based on a search word. The search word should be specified instead of a video ID. See "Automatically Generate Playlists" option for more details
72
+ * **start** - a number of seconds from where to start the video playing
73
+ * **stop** - this stops the video at a specific time, given in seconds
74
+ * **style** - apply CSS elements directly to the video output
75
+ * **template** - specify a template (see section on Templates for further details)
76
+ * **theme** - dark or light, display player controls (like a 'play' button or volume control) within a dark or light control bar
77
+ * **user** - yes or no, create a playlist based on a user's uploads. The search word should be specified instead of a video ID. See "Automatically Generate Playlists" option for more details
78
+ * **width** - the video width, in pixels
79
+
80
+ == Alternative Shortcodes ==
81
+
82
+ Within administration, selecting `General Settings` from the `YouTube Embed` menu will provide a list of general options. One option is named `Alternative Shortcode` and allows you to specify another shortcode that will work exactly the same as the standard shortcode of `[youtube]`.
83
+
84
+ There are 2 reasons why you might want to do this...
85
+
86
+ 1. If migrating from another plugin, it may use a different shortcode - more details can be found in the section named "Migration"
87
+ 2. If another plugin uses the same shortcode (e.g. Jetpack) this will allow you to specify and use an alternative
88
+
89
+ The new shortcode can also have its own default profile assigned to it (see the Profiles section for more details on this).
90
+
91
+ == Widgets ==
92
+
93
+ Widgets can be easily added. In Administration simply click on the `Widgets` option under the `Appearance` menu. `YouTube Embed` will be one of the listed widgets. Drag it to the appropriate sidebar on the right hand side and then choose your video options - any that aren't specified are taken from your supplied profile.
94
+
95
+ If you wish to display an automatically generated playlist based on user name or search term, simply change the "ID Type" appropriately and then specify the name or search word(s) where the video ID would normally be entered.
96
+
97
+ And that's it! You can use unlimited widgets, so you can add different videos to different sidebars.
98
+
99
+ == Playlists ==
100
+
101
+ YouTube allows users to create their own playlists - collections of videos that can be played in sequence.
102
+
103
+ YouTube used to supply Playlist IDs as 16 digits and these can still be used...
104
+
105
+ e.g. `[youtube]095393D5B42B2266[/youtube]`
106
+
107
+ Alternatively, if you're using a newer, non-16 digit ID then append 'PL' to the beginning.
108
+
109
+ e.g. `[youtube]PLVTLbc6i-h_iuhdwUfuPDLFLXG2QQnz-x[/youtube]`
110
+
111
+ Playlists cannot be used along with the EmbedPlus embedding method.
112
+
113
+ A better alternative to playlists is the build-in lists function in YouTube Embed - see the Lists section for further details.
114
+
115
+ == Templates ==
116
+
117
+ Both in the profile and as a parameter you can specify a template. This allows you to define any CSS that you wish to "wrap" around the YouTube output.
118
+
119
+ The template consists simply of any HTML that you wish but with `%video%` where you wish the video to appear.
120
+
121
+ e.g. `<div align="center">%video%</div>`
122
+
123
+ Be wary that when adding template via a parameter that any HTML included may cause your video to have `<pre>` tags wrapped around it. The easiest way to check and fix this is to view any post in the HTML editor and remove any PRE tags that have been added.
124
+
125
+ == Profiles ==
126
+
127
+ You've probably already had a look at the default profile, accessible by selecting `Profiles` from the `YouTube Embed` administration menu option. Here you can specify the default option which will apply to any embedded video.
128
+
129
+ However, in the top right hand corner is a drop-down box and a button marked `Change profile`. Simply select an alternative profile and click the button and you can then edit the options for this alternative profile. You can even name it as well.
130
+
131
+ To use this profile, simply use the parameter `profile=` followed by the profile name or number. The options for this profile will then be used.
132
+
133
+ This could be useful, for instance, for having a separate profile for different parts of your site - posts, sidebar, etc - or for different video types (e.g. widescreen).
134
+
135
+ By default you have 5 extra profiles - if you wish to have more (or less) this number can be changed from the YouTube Embed settings screen.
136
+
137
+ == Lists ==
138
+
139
+ Although this plugin will play standard YouTube playlists their playback options are limited. Instead you can create your own video lists. Under the `YouTube Embed` administration menu is a sub-menu named `Lists`. Select this and you will be shown a screen where you can type in a list of video IDs (or URLS). You can also provide a name for the list.
140
+
141
+ When saving the list each video is validated.
142
+
143
+ As with profiles you can select the list from a drop down in the top right-hand corner. You can also change the number of lists from the `Options` sub-menu too.
144
+
145
+ To use a list, simply specify the list name or number instead of a video ID, as well as a parameter to specify how you wish the list to be played back.
146
+
147
+ e.g. `[youtube list='order']List 1[/youtube]`
148
+
149
+ The list parameter allows to to either play each in turn, play them randomly, or have just one played (but picked randomly).
150
+
151
+ An option within the general options screen allows you to change whether this parameter MUST be used. If switched on, you will gain a performance increase, otherwise the plugin has no way of knowing if you're asking for a playlist so must verify the ID you've specified against all your lists.
152
+
153
+ == Automatically Generated Playlists ==
154
+
155
+ YouTube includes options to automatically generate playlists based upon a user name or a search name.
156
+
157
+ To use, simply use the `user` or `search` parameter to switch the appropriate option on. Then, instead of a video ID or URL, you should specify either the user name or search word(s).
158
+
159
+ == Third Party Resizing Scripts ==
160
+
161
+ Within the YouTube Embed settings screen there is an option to set a third party resizing script - either [iFrame Resizer](https://github.com/davidjbradshaw/iframe-resizer "iFrame Resizer") or [FitVids.js](https://github.com/davatron5000/FitVids.js "FitVids.js"). These work alongside the existing IFRAME but try and improve the output, particularly with regard to how the output is sized.
162
+
163
+ There are no guarantees with these and no support of their specific functionality is provided. However, if the video output is wrong then it's worth trying these.
164
+
165
+ == Thumbnails ==
166
+
167
+ YouTube embed also has the ability to return a thumbnail of a video (sorry, this doesn't work with playlists). There are two methods you can use for this - a shortcode or a function call.
168
+
169
+ Use the function call `youtube_thumb_embed( 'id', 'paras', '', 'alt', 'nolink' )` to add a thumbnail to any part of your theme.
170
+
171
+ Like the video embed equivalent, the `id` is the video ID and `alt` is the alternative text for the thumbnail image (optional). `nolink`, if set to `true`, will output the thumbnail without a link to the YouTube video, allowing you to add your own.
172
+
173
+ The parameters are different, however, but, again, are separated by ampersand.
174
+
175
+ The parameters are as follows...
176
+
177
+ * **rel** - specify a REL override, e.g. rel="nofollow"
178
+ * **target** - specify a TARGET override, e.g. target="_blank"
179
+ * **width** - this specifies the width of the thumbnail image
180
+ * **height** - this specifies the height of the thumbnail image
181
+ * **version** - which version of the thumbnail to use. This can be `default`, `hq` (for a high quality version of the default image), `start`, `middle` or `end`. The latter 3 indicate where from the video the thumbnails are taken from
182
+
183
+ e.g. `youtube_thumb_embed( 'id', 'rel=nofollow&target=_blank', '', 'Demo Video' )`
184
+
185
+ To use the shortcode method, insert `[youtube_thumb]id[/youtube_thumb]` into a post or page to create a thumbnail of the relevant video ID which, once clicked, will open up the appropriate YouTube page.
186
+
187
+ Like the function call above, you can specify a number of parameters. They are the same as detailed above but with the addition of one further parameter...
188
+
189
+ * **alt** - specify some `ALT` text for the thumbnail image
190
+
191
+ e.g. `[youtube_thumb target="_blank" alt="Demo video"]id[/youtube_thumb]`
192
+
193
+ This overrides the `TARGET` and `ALT` elements of the thumbnail.
194
+
195
+ You can also use `nolink` as a parameter with the shortcode, which works in the same way as with the function call.
196
+
197
+ == Shortened URL ==
198
+
199
+ You may return a short URL for any YouTube video by way of either a function call or a shortcode.
200
+
201
+ For a function call add `youtube_short_url( 'id' )` to your code to return a URL (note that this is not written out, but returned as a value), where `id` is the video ID.
202
+
203
+ e.g. `<a href="<?php echo youtube_short_url( 'Z_sCoHGIpU0' ); ?>"Click here for video</a>`
204
+
205
+ This will create a link to a video using the short URL standard.
206
+
207
+ To use the shortcode method simply insert `[youtube_url id=xx]` anywhere within a post to return a shortened URL. `xx` is the ID of the video.
208
+
209
+ == Downloading Videos ==
210
+
211
+ If you wish your users to be able to download a YouTube video or playlist then you can do this automatically or manually via either a shortcode of PHP function call.
212
+
213
+ In the Profiles screen within administration there is an option to automatically show a download link. You can specify some text or HTML to display as well as CSS.
214
+
215
+ If you'd prefer to do this manually then the function call is named `get_video_download` and has one parameter - the video ID. It will return the download link URL.
216
+
217
+ e.g. `<a href="<?php echo get_video_download( 'Z_sCoHGIpU0' ); ?>">Download the video</a>`
218
+
219
+ Alternatively, you can use the shortcode `download_video`. The content to link is specified between the open and close shortcode tags and there are 3 parameters...
220
+
221
+ * **id** - The ID of the video or playlist. This is required.
222
+ * **target** - The target of the link (e.g. `_blank`). This is optional.
223
+ * **nofollow** - yes or no, use this to specify whether a `nofollow` tag should be added to the link. This is optional and by default it will be included.
224
+
225
+ e.g. `[download_video id="Z_sCoHGIpU0" target="_blank"]Download the video[/download_video]`
226
+
227
+ == Further Embedding Options ==
228
+
229
+ Under the `YouTube Embed` administration menu is a sub-menu named `General Settings`. Select this and find the section named `Embedding`. There are 2 options here...
230
+
231
+ 1. Add Metadata - by default, RDFa metadata is added to video output. This can be switched on or off as required (see the FAQs for more information about metadata usage).
232
+ 2. Feed - videos will not appear in feeds so use this option to decide whether you want them to be converted to links and/or thumbnails.
233
+
234
+ == Third Party Plugins ==
235
+
236
+ From the `YouTube Embed` administration menu there is a `3rd Party Plugins` sub-menu. This will list a number of WordPress plugins that can work alongside YouTube Embed to add extra functionality. From this screen you can view, install and see the status of each plugin.
237
+
238
+ In some cases activating these plugins will cause their settings screen to also appear under the `YouTube Embed` menu, for extra convenience.
239
+
240
+ **By listing these plugins, we provide no guarantees that they work correctly and we certainly don't provide any support for them.**
241
+
242
+ If you'd like your own plugin adding to this list then please [get in touch](http://www.artiss.co.uk/plugin-contact "Contact").
243
+
244
+ == Reviews & Mentions ==
245
+
246
+ [Your YouTube Plugin is fantastic-it just saved my life on this site. Thank you!](https://twitter.com/AaronWatters/status/237957701605404672?uid=16257815&iid=am-130280753913455685118891763&nid=4+248 "Twitter - Aaron Watters") - Sonic Clamp.
247
+
248
+ [New Technology Finds The Most Buzzed-About Parts Of Videos](http://www.socialtimes.com/2011/03/new-technology-finds-the-most-buzzed-about-parts-of-videos-interview/ "New Technology Finds The Most Buzzed-About Parts Of Videos") - SocialTimes.
249
+
250
+ [Andesch tips on WordPress plugins!](http://andershagstrom.se/andesch-tipsar-om-wordpress-plugins/ "Andesch tipsar om WordPress-plugins!") - Anders.
251
+
252
+ [Critical Mass](http://www.bikinginmemphis.com/2011/03/26/critical-mass/ "Critical Mass") - Biking in Memphis.
253
+
254
+ [Embedding YouTube Videos In Your WordPress Theme](http://frogenyozurt.com/2011/04/embedding-youtube-videos-in-your-wordpress-theme/ "Embedding YouTube Videos In Your WordPress Theme") - FrogenYozurt.Com.
255
+
256
+ == Installation ==
257
+
258
+ YouTube Embed can be found and installed via the Plugin menu within WordPress administration. Alternatively, it can be downloaded and installed manually...
259
+
260
+ 1. Upload the entire `youtube-embed` folder to your wp-content/plugins/ directory.
261
+ 2. Activate the plugin through the 'Plugins' menu in WordPress.
262
+ 3. Now you can add the shortcode to your posts and pages!
263
+
264
+ == Frequently Asked Questions ==
265
+
266
+ = I've upgraded to version 4.0+ from an earlier version and I was using the widget feature to display videos =
267
+
268
+ I previously allowed some, although not all, parameters to be specified within the widget. However, as you can simply create your own profile for widgets I have removed this and, without leaving lots of redundant code behind, it was difficult to keep this backwards compatible.
269
+
270
+ Therefore, if you're upgrading you may find your widgets don't now display correctly. The best thing to do, beforehand if you can, is to create a profile just for the widgets and assign that to each. You'll probably find the video size is the bit most likely to cause issues. Apologies for this.
271
+
272
+ = How do I find the ID of a YouTube video? =
273
+
274
+ If you play a YouTube video, look at the URL - it will probably look something like this - `http://www.youtube.com/watch?v=L5Y4qzc_JTg`.
275
+
276
+ The video ID is the list of letters and numbers after `v=`, in this case `L5Y4qzc_JTg`.
277
+
278
+ = The video output is overlapping or stuttering =
279
+
280
+ If you go into the Profile screen in Administration there is a "Window Mode" option. This defines how Flash output interacts with any other around it. "Window" is the default and gives good performance but may cause overlapping. If overlapping is causing an issue try "Opaque".
281
+
282
+ = I'm getting an error saying that "an alternative plugin is using the [youtube] shortcode" =
283
+
284
+ As this suggests another plugin that you have installed is using the same shortcode as YouTube Embed. That means that use of the `youtube` shortcode won't work. You have 2 possible actions to take...
285
+
286
+ 1. Disable the conflicting plugin. If it's Jetpack then you can disable the Shortcode Embeds module.
287
+ 2. Leave it as it is and use the option to use a second shortcode with this plugin. Head to the YouTube Embed settings screen and you can set up a secondary shortcode. You can also switch off the nag message too from here.
288
+
289
+ = The "autostart" feature is not working in iOS =
290
+
291
+ Unfortunately, this is a restriction that has been put in place by Apple.
292
+
293
+ = I can't get the video to play at a specific resolution by default =
294
+
295
+ There is no way to specify this - YouTube makes the decision on which version to play depending on a number of factors.
296
+
297
+ = There are black borders on top/underneath my video =
298
+
299
+ This is usually due to using a different ratio than the video was designed for. If you're not sure which ratio to use head to its page on YouTube, click on Share and then Embed and then Show More. A video size will be shown, which you can use to work out the correct ration for the video.
300
+
301
+ = The controls under the video don't display properly when using Firefox =
302
+
303
+ This is a bug in Firefox. Short term, switch on SSL in the Profiles screen and it will work. Longer term, I've [raised a bug report with Mozilla](https://bugzilla.mozilla.org/show_bug.cgi?id=1223515 "Bug 1223515 - Broken images in YouTube embedded player when not using SSL").
304
+
305
+ = The generated code does not cleanly validate =
306
+
307
+ No, by default it doesn't but it works absolutely fine as it. However, if you really must cleanly validate against HTML5 or transitional XHTML then head into the YouTube Embed settings screen and you'll find an option to "Improve Validation". Tick this and Save and it should validate.... UNLESS you have the metadata option switched on, in which case it won't validate still (sorry, I'm a slave to Google on this one!). Switch that off though and you're 100%.
308
+
309
+ One thing to note - by switching on "Improve Validation" you'll extend the length of the URL line that's passed to YouTube. Please see the next FAQ to understand this better.
310
+
311
+ = I'm getting the error "The maximum URL length has been exceeded" when trying to view a video =
312
+
313
+ When embedding a video a URL for YouTube is generated - this contains all the non-default parameters that you've specified and, if you've created a manual playlist, all of the video IDs. Unfortunately, URLs can only be 2000 characters in size. If this is exceeded you'll get the above error message when you try and view the video.
314
+
315
+ The solution is to reduce this down by reducing down your playlist or, if you have the "Improve Validation" settings switched on, switching that back off.
316
+
317
+ = I have another issue or a request =
318
+
319
+ Before reporting it please bear in mind that this plugin uses the standard YouTube API. Adding extra functionality to the player itself is not possible and there are [known issues](https://code.google.com/p/gdata-issues/issues/list?q=label:API-YouTube "YouTube API Known Issues") with it. I would also recommend performing a Google search for your issue too first, as this will often resolve a lot of queries.
320
+
321
+ == Screenshots ==
322
+
323
+ 1. YouTube Embed in the administration menu
324
+ 2. The main options screen
325
+ 3. The profiles screen
326
+ 4. The lists screen - videos have been added and validated. The drop-down help is also shown
327
+ 5. The default widget options
328
  6. The default visual editor options with the YouTube Embed button
329
+ 7. The third party plugins menu
330
+
331
+ == Changelog ==
332
+
333
+ = 4.3.2 =
334
+ * Bug: Correct validation of list field, which was preventing more than one video being specified
335
+ * Bug: Fixed the URL for the settings link in the plugin meta
336
+
337
+ = 4.3.1 =
338
+ * Bug: Had removed a function (by accident, you understand) that converted the old alternative shortcode settings to a new format. The result is that the conversion didn't take place and an array was passed as a shortcode name to WordPress Core, generating an error. The function has been added back in
339
+
340
+ = 4.3 =
341
+ * Enhancement: Added new "Third Party Plugins" screen, which lists third party plugins that work alongside YouTube Embed, adding extra functionality. You can view, install and see the status of these plugins from this screen
342
+ * Maintenance: Moved the settings back to the YouTube Embed menu
343
+ * Maintenance: Renamed menus to be more specific
344
+ * Maintenance: Updated the function names, which were still using the out-dated "vye" prefix
345
+
346
+ = 4.2.1 =
347
+ * Bug fix: Quotes were not being dealt with correctly in the template field. Now corrected.
348
+
349
+ = 4.2 =
350
+ * Enhancement: Re-written the core embedding code. Redundant code removed and, for the remaining code, re-imagined to improve performance
351
+ * Enhancement: Massively changed how the plugin retrieves saved options and, in particular, how I populate default values. The result? Even better performance
352
+ * Enhancement: Reviewed and reduced the calls to fetch the options
353
+ * Enhancement: Added a new general option to allow you to force a list type to be specified before a list can be used. The reason? By doing this the code doesn't have to check if the ID it a list name each time and it improves performance. For those upgrading this will be switched off by default to maintain backwards compatibility
354
+ * Enhancement: Admin bar options only appear if viewing the admin bar on the site (showing it whilst in the admin screens seemed rather pointless)
355
+ * Enhancement: If you use [WordPress Video Overlay Ads](https://wordpress.org/plugins/video-overlay-ads/ "WordPress Video Overlay Ads") or [Video SEO for WordPress](http://yoast.com/wordpress/video-seo/ "Video SEO for WordPress") then the settings menus will appear under the YouTube Embed menu
356
+ * Enhancement: SSL options removed as it's now used by default, including with thumbnails and schema.org links
357
+ * Enhancement: Improved the RSS feed output for search or user upload requests
358
+ * Maintenance: Removed some deprecated elements in the code
359
+ * Maintenance: Updated includes so that plugin folders were not hardcoded
360
+ * Maintenance: Updated which functions I was using to retrieve folder names so that they are fully SSL compatible
361
+ * Maintenance: Removed a load of redundant functions
362
+ * Maintenance: Replaced a function with a PHP command but this means that the plugin is no compatible with PHP versions below 5.1
363
+ * Maintenance: Tidied up the list screen further
364
+ * Maintenance: Replaced the 'dynamic' parameter with 'responsive' which, as a name, is far more accurate. 'dynamic' will still work, though.
365
+ * Maintenance: Improved admin screen validation and sanitisation
366
+
367
+ = 4.1.1 =
368
+ * Bug fix: Corrected settings URL in plugin meta.
369
+ * Bug fix: If plugin has never run before, ensure a default options array is generated.
370
+ * Maintenance: Removed donation options and updated branding.
371
+
372
+ = 4.1 =
373
+ * Enhancement: Added 'Plays inline' option for iOS devices.
374
+ * Enhancement: Added extra Closed Caption option to better reflect how YouTube works - either on, off, or user default.
375
+ * Enhancement: Added new option to force HTML5 playback (if available). This is an undocumented feature and, as such, may not actually work, depending on YouTube's current mood. If YouTube aren't going to support it then I'm certainly not going to so please don't shout if it doesn't work.
376
+ * Enhancement: Lovely new icons for the lists page.
377
+ * Enhancement: Improved the layout of the demo video on the profiles page.
378
+ * Enhancement: Added a count to the profiles and lists screen to indicate how many are set up. Also showed on drop-down which of the profiles/lists are not defined.
379
+ * Enhancement: Changes made to add compatibility with a3 lazy load.
380
+ * Enhancement: Removed the caching - it created the output up to 3 times quicker but when that's 0.005 seconds it's not worth the hassle that comes with it. I started making performance improvements to compensate then realised it was such a big change that it would be best spun off as it's own seperate update - version 4.2. Look out for it.
381
+ * Enhancement: Removed limitation of only being able to display up to 30 lists or profiles.
382
+ * Enhancement: When you can select a profile from another screen (e.g. defining a profile to an alternative shortcode) then only defined profiles will be listed.
383
+ * Enhancement: Added general option to specify the YouTube interface language as well as to suppress debug output in the resulting code.
384
+ * Enhancement: Fixed validation errors against thumbnails.
385
+ * Enhancement: Changed the "Frameborder" option to a more general "Improve Validation" which does, well, just that. It improves the generated markup so that it will validate better (if that's your bag).
386
+ * Enhancement: Added option to use a third party script to handle content resizing. Implemented [iFrame Resizer](https://github.com/davidjbradshaw/iframe-resizer "iFrame Resizer") v3.5.1 and [FitVids.js](https://github.com/davatron5000/FitVids.js "FitVids.js") 1.1.
387
+ * Enhancement: If another plugin is using the same shortcode as this I now output a prompt in the admin area. Also added a setting to turn off this prompt just in case you're using the secondary shortcode and are happy for this.
388
+ * Enhancement: Re-written code for help screens, including adding more information and additional tabs.
389
+ * Maintenance: Moved the settings page to, well, the Settings menu option. It makes sense.
390
+ * Maintenence: Removed the enable of the JS API, which is now deprecated.
391
+ * Maintenance: Improved the admin screen output code - had made it more WordPress standard in version 4 but got some of the code wrong.
392
+
393
+ = 4.0.2 =
394
+ * Maintenance: Not really a bug, but in some circumstances I wasn't initialising a variable used when generating the embed code. It worked fine but wasn't best practise so fixed. Sloppy.
395
+ * Maintenance: Modified the default parameters so new user videos should appear with the same options as on YouTube itself. Consistent.
396
+ * Maintenance: I ABSOLUTELY refuse to call this a bug. But I was calling get_the_excerpt() to build some of the video meta data. For some reason, still unknown to me, other plugins were crashing as a result of it. I've removed it for now but am investigating the cause. Frustrating.
397
+ * Enhancement: WMODE is now only added to the embed URL if it's anything other than the default. Shrinkage.
398
+
399
+ = 4.0.1 =
400
+ * Maintenance: Left some debug code in by mistake. Doh. Sometimes I'd forget my own head if it wasn't screwed on.... Apologies to those affected.
401
+
402
+ = 4.0 =
403
+ * Maintenance: Removed a number of redundant/broken features. [Learn more](http://www.artiss.co.uk/youtube-embed-removed-features "Removed Features").
404
+ * Maintenance: Updated download link to use KeepVid.
405
+ * Maintenance: Re-written admin screen to use WordPress standard method of displaying settings. Oh, and the widget settings too.
406
+ * Maintenance: ...speaking of which, revised the options available to widgets.
407
+ * Maintenance: Merged many of the files where there wasn't a huge amount of content.
408
+ * Maintenance: Renamed menu slugs as they were too generic and may cause clashes with other plugins or themes that are silly enough to do the same thing.
409
+ * Enhancement: Revised profile screen to make it clearer, via the art of the icon, which parameters are compatible with which embed type.
410
+ * Enhancement: If you go a bit "ape" with the parameters and manual playlists, it's possible to exceed the URL size limit. I've now put a check in place to report this, if it occurs.
411
+ * Enhancement: Added modest branding as a parameter (before was only selectable via the profile screen).
412
+ * Enhancement: Improved the meta data.
413
+ * Bugs: Many of them. Fixed. Hoorah.
414
+
415
+ = 3.3.5 =
416
+ * Maintenance: Added missing text domain, ready for automatic translation.
417
+
418
+ = 3.3.4 =
419
+ * Maintenance: Updated admin screen headings for compatibility with 4.3.
420
+ * Maintenance: Updated demo video on profile page. Just because.
421
+ * Bug: Fixed (I hope) the problem with the editor button not appearing for some users. Thanks to Mark Aarhus for getting to the bottom of this for me.
422
+ * Enhancement: Added donation link to plugin meta. Because I'm worth it.
423
+
424
+ = 3.3.3 =
425
+ * Maintenance: Now working with newer playlist IDs (README instructions chaneged to reflect how to do this)
426
+ * Maintenance: Resolved widget issues with version 4.3 of WordPress
427
+ * Maintenance: Eliminated XSS problem in admin profile screen
428
+
429
+ = 3.3.2 =
430
+ * Bug: One of the files was corrupt in the previous release - this is now fixed. Sorry :(
431
+
432
+ = 3.3.1 =
433
+ * Maintenance: Remove reference to Google API, as videos are now not displaying as a result of v2 being retired. Will update the plugin more fully in future release
434
+
435
+ = 3.3 =
436
+ * Maintenance: Ding, dong Applian has gone. Removed Vixy branding, updated README and language files to match
437
+ * Maintenance: Removed those Vixy download links and restored the old method - will enhance this in a future release
438
+ * Maintenance: Plugin had too much baggage so it could support old versions of WordPress. Why? Updated it to only support more recent versions but have removed lots of un-needed guff as well. The result - this version is 15% slimmer than the previous version. Win!
439
+ * Maintenance: Spruced up the admin screens to match the new WordPress styling
440
+ * Bug: Resolved a number of bugs as reported by users and spotted by myself. Thanks all! More fixes to come
441
+
442
+ = 3.2.1 =
443
+ * Bug: Fixed issue where playlist was appearing for single videos
444
+ * Maintenance: Improved Metadata standard
445
+
446
+ = 3.2 =
447
+ * Bug: Prevented download bar SPAN from appearing even when switched off
448
+ * Bug: Fixed issue that caused playlists to not appear
449
+ * Enhancement: Added new shortcode for displaying video comments
450
+ * Enhancement: IFRAME output now includes metadata
451
+ * Enhancement: Editor button will now work with MCE4 editor (WP 3.9+)
452
+ * Enhancement: SVG icon used in admin menu for WP 3.8+
453
+
454
+ = 3.1 =
455
+ * Enhancement: Allow user to specify video resolution required (experimental)
456
+ * Enhancement: Different languages can be specified for transcripts, other than the English default
457
+ * Enhancement: API enabled on scripts by default, allowing for third-party modification
458
+ * Enhancement: Can now add a link to YouTube under a video
459
+ * Maintenance: Removed adverts from administration screen
460
+ * Maintenance: Changed download bar default to be opt-in and re-worded option text
461
+
462
+ = 3.0.1 =
463
+ * Bug: Fixed menu options shown in admin bar
464
+ * Maintenance: Updated links to point to instructions on Vixy.net website
465
+ * Enhancement: Validate download bar code to ensure it's secure
466
+ * Enhancement: Passing blog language to language bar for i18n
467
+
468
+ = 3.0 =
469
+ * Maintenance: Changed name, updated adverts, removed donation and sponsorship requests
470
+ * Maintenance: Renamed function to match new name and also removed prefix from files, which were not required
471
+ * Maintenance: Checked and updated all help URLs
472
+ * Maintenance: Removed about and instruction pages which were felt were no longer needed
473
+ * Maintenance: Updated icons
474
+ * Enhancement: Updated download links to use code from Vixy. This is now switched on by default
475
+ * Enhancement: Added option to provide an affiliate ID for use with the download bar - blog owners can make 30% from sales generated
476
+ * Enhancement: Simplified the menu access rules which has resulted in resolving a number of existing issues
477
+ * Bug: Fixed PHP error when allowing shortcodes in widgets
478
+
479
+ = 2.7 =
480
+ * Maintenance: Using new website for video download link
481
+ * Maintenance: README updated with new compatibility details and modified FAQs
482
+ * Bug: Fixed a bug where some option screen text was not displaying
483
+ * Bug: Fixed the feature pointer, which was no longer working
484
+ * Enhancement: Added profile options to allow you to switch on video download link, as well as style the output
485
+
486
+ = 2.6.2 =
487
+ * Bug: Fixed bug in uninstall routine
488
+ * Enhancement: Replaced user of print_r in cache key generator with serialize, as this can cause problems with some hosting configurations
489
+
490
+ = 2.6.1 =
491
+ * Bug: Fixed minimised script that adds editor button
492
+ * Bug: Updated broken advert links
493
+ * Bug: Fixed link in admin bar when using WP 3.1 - 3.3
494
+ * Bug: Removed un-necessary cookie update that was causing errors in some situations
495
+ * Maintenance: Updated WP 3.3+ admin bar options to correctly reflect permissions, naming and ordering of equivalent admin menu
496
+
497
+ = 2.6 =
498
+ * Bug: Fixed a bug that means videos have zero width on new installations until the default profile is updated (thanks to Aidan from [Noise Republic](http://www.noiserepublic.co.uk "Noise Republic") for reporting that)
499
+ * Bug: Corrected URLs pointing to help screens
500
+ * Bug: Resolved issue where translated IDs were not corrected if included in a URL (thanks to kchayka for reporting that)
501
+ * Bug: Fixed problem where video ID is not found in full URL if not specified first (thanks to christopherw for reporting that)
502
+ * Bug: Modest branding profile switch wasn't doing anything - the option was hard-coded on. Now corrected
503
+ * Bug: User defined error message now decodes correctly (thanks to kchayka for reporting that)
504
+ * Bug: No longer caches the video output if a random playlist has been selected
505
+ * Maintenance: Updated advertisement engine code
506
+ * Maintenance: Renamed README menu to Instructions
507
+ * Maintenance: Assorted on-screen wording improvements
508
+ * Maintenance: Removed title option as it's un-supported
509
+ * Maintenance: Updated the uninstall routine
510
+ * Maintenance: Cleaned code and updated translation files
511
+ * Enhancement: Added Do Not Track compatibility. Once active, if user has Do Not Track in use then cookies will not be stored
512
+ * Enhancement: New option to specify the shortcode that the editor button uses. A cookie is used to store this
513
+ * Enhancement: New option to switch on shortcodes in widgets. This will allow all shortcodes in widgets, though, not just those for this plugin
514
+ * Enhancement: Reviewed and updated access right to admin screen. Added option to choose what level has access to profiles and/or lists screen
515
+ * Enhancement: Many functions were only activated if user was not in Administration screens. However, using AJAX on your site triggers the administration flag and, hence, the functions would not work. Changed this
516
+ * Enhancement: Added option to modify access to Profile and Lists screen
517
+ * Enhancement: Improved the cache clearing option and statistics
518
+ * Enhancement: Reflected on profile screen that modest branding now works with HTML5 player
519
+ * Enhancement: Added option to thumbnail output to suppress the link, so that you can add your own
520
+ * Enhancement: Updated "Controls" option to support new third parameter and update definitions. Ensured backwards compatibility with old parameter options
521
+
522
+ = 2.5.6 =
523
+ * Maintenance: Restricted access to Options and Profiles screen to administrators
524
+ * Bug: Fixed bug which caused errors to be generated on new installations of plugin
525
+ * Enhancement: Set a default width if the `content_width` global variable is set to zero
526
+
527
+ = 2.5.5 =
528
+ * Maintenance: Updated sponsorship - now includes option to switch off if user has donated
529
+ * Maintenance: Updated options screen to reflect the fact that the `related` and `color` parameters are now supported by the HTML5 player
530
+ * Maintenance: Updated options screen to show that the `info` parameter, if used alongside a playlist will show thumbnails of the videos
531
+ * Maintenance: Removed redundant GA code, which was never used
532
+ * Maintenance: Combined scripts
533
+ * Bug: Fixed internationalisation
534
+ * Bug: Fixed output of video information on the Lists option screen
535
+ * Bug: Modified cache key so that length does not exceed MySQL field maximum
536
+ * Bug: Added close anchor for media meta - causes unclosed anchor under IE9 (thanks to Marcel Bootsman for identifying this)
537
+ * Bug: Responsive video was not working on a demonstration video in Profile screen
538
+
539
+ = 2.5.4 =
540
+ * Bug: Fixed bug that prevented some fields in options screens to not save
541
+
542
+ = 2.5.3 =
543
+ * Bug: Fixed further issues with the widget code (thanks to Rose-Anne Constantineau for reporting it and helping me test the result)
544
+ * Maintenance: Improved some of the internationalisation texts
545
+ * Maintenance: Neatened up some of the code output
546
+
547
+ = 2.5.2 =
548
+ * Bug: Fixed a bug where widgets weren't showing single videos (thanks to Josh Callaghan for reporting this)
549
+
550
+ = 2.5.1 =
551
+ * Bug: Fixed a bug with Admin Bar when using WP 3.1 - 3.3 (thanks to Carl D'Halluin for finding this)
552
+
553
+ = 2.5 =
554
+ * Maintenance: Updated code to work with new playlist options
555
+ * Maintenance: Removed embedded URL option due to issues with existing code (see FAQ for details)
556
+ * Maintenance: Added further FAQs based on common forum queries
557
+ * Maintenance: Wording on options screens changed to better identify differences between players
558
+ * Maintenance: Added advertisement to profile screen
559
+ * Maintenance: Modified demonstration video and made sponsorship request more visible
560
+ * Maintenance: Changes the YouTube admin screen icon
561
+ * Enhancement: Download link now uses deturl.com
562
+ * Enhancement: Admin Bar link improved in WP 3.3 onwards
563
+ * Enhancement: New user upload and search features added
564
+ * Enhancement: Now supports ability to specify the time to stop video playback
565
+ * Enhancement: Default windowing mode changed to improve performance
566
+ * Enhancement: FRAMEBORDER is switchable for the purpose of HTML5 compatibility
567
+ * Enhancement: Added internationalisation
568
+ * Enhancement: README in admin menu now shows the corresponding README for the version of the plugin you have installed, rather than the latest one
569
+ * Enhancement: Added option to admin screen to clear video cache (see FAQ for details)
570
+ * Enhancement: Allow recursive shortcodes - that is, shortcodes within the YouTube shortcode
571
+ * Bug: Fixed bug in retrieving the video title
572
+ * Bug: Resolved various debug messages
573
+ * Bug: Fixed bug in MCE button JavaScript
574
+
575
+ = 2.4.1 =
576
+ * Maintenance: Removed dashboard widget
577
+
578
+ = 2.4 =
579
+ * Maintenance: Re-sequenced the changelog in the README
580
+ * Maintenance: Removed drop shadow option
581
+ * Maintenance: Re-design of widgets, reducing number of parameters down to make it easier to use - use profiles to modify missing parameters
582
+ * Maintenance: Updated YouTube icons
583
+ * Enhancement: Added frameborder="0" to IFRAME code
584
+ * Enhancement: Added Privacy-Enhanced mode. Doesn't work with Chromeless player.
585
+ * Enhancement: Added `title` option, so you can name the video
586
+ * Enhancement: Added `ssl` option, allowing you to override whether HTTP or HTTPS is used for the video
587
+ * Enhancement: Added `dynamic` option (and matching Profile switch) to allow users to request dynamically resizing video (responsive). Additional option to allow specified width to be maximum
588
+ * Enhancement: Made `modestbranding` a switchable option (switchable in profile options but not on video-by-video basis) due to issues with Apple devices
589
+ * Enhancement: Improved matching of URL embedded into post
590
+ * Enhancement: If you have the [README Parser plugin](http://wordpress.org/extend/plugins/wp-readme-parser/ "README Parser") installed then a new sub-menu will display the README instructions
591
+ * Enhancement: Use WP 3.3 Feature Pointer to highlight new menu when plugin is activated
592
+ * Bug: Ensure `showinfo` parameter is set correctly
593
+ * Bug: If width or height is missing from Profile screen then fill it in based on widescreen format. Otherwise, causes video to break
594
+ * Bug: Video information was being fetched from caching even if option selected to switch it off. Fixed!
595
+
596
+ = 2.3.1 =
597
+ * Maintenance: Removed the sponsorship
598
+
599
+ = 2.3 =
600
+ * Enhancement: Editor button will add text between shortcodes if no URL or ID is specified
601
+ * Enhancement: Square brackets are stripped from alternative shortcodes on option screen - text added to warn against this too
602
+ * Enhancement: Added Chromeless player option
603
+ * Enhancement: Increased maximum output length of profile and list names to 30 characters
604
+ * Bug: Fixed incorrect listing of long profile or list names
605
+ * Bug: Fixed INCLUDE bug in widgets.php
606
+
607
+ = 2.2 =
608
+ * Maintenance: Updated dashboard widget to latest version
609
+ * Maintenance: Added advertising banners to options screen - these can be turned off if you donate
610
+ * Enhancement: Replace WP_PLUGIN_URL with plugins_url()
611
+ * Enhancement: Added H and W as alternative shortcode parameters to HEIGHT and WIDTH
612
+ * Enhancement: Editor button should appear for anyone from editor role upwards
613
+ * Enhancement: Removed maximum length from profile and list names. However, only first 20 characters will appear in lists
614
+
615
+ = 2.1 =
616
+ * Enhancement: New option to switch API options (where HTTP or HTTPS, display messages or not or even switch off)
617
+ * Enhancement: Output video playback errors as XHTML comments. Output to post a generic message which can be changed in the options
618
+ * Enhancement: Video information is shown in lists screen when first entering (no need to press Save button to display)
619
+ * Enhancement: Added new `color` parameter, which allows you to specify the color of the progress bar
620
+ * Enhancement: Added new `theme` parameter, allowing you to specify if the player is dark or light skinned
621
+ * Enhancement: Added new `https` parameter, allowing you to use HTTPS instead of HTTP for the video display
622
+ * Enhancement: Added new `version` parameter to thumbnails, allowing different versions (including a high resolution one) to be displayed
623
+ * Enhancement: Added new administration option to allow the thumbnail used in RSS feeds to be specified
624
+ * Enhancement: Log the current plugin version into the database. This may be of use in future upgrades to detect which version the user is upgrading from
625
+ * Bug: Fixed video title no longer being fetched since 2.0.3 (because of using v2 of API)
626
+ * Bug: Fixed some error output - due to changes made in an earlier release some errors would not display
627
+
628
+ = 2.0.4 =
629
+ * Enhancement: Removed HTTPS access to gdata API - will add a switchable option for this in a later release
630
+
631
+ = 2.0.3 =
632
+ * Enhancement: Decode any passed `template` parameters, as WP may have encoded the content first
633
+ * Enhancement: Improved file handling
634
+ * Enhancement: Now using HTTPS and version 2 of YouTube gdata API
635
+ * Enhancement: New general option to switch off reporting of API errors - will simply accept ID and work out type
636
+ * Maintenance: Added details to the README to cover issues with `style` backwards compatibility and YouTube API
637
+
638
+ = 2.0.2 =
639
+ * Enhancement: Strip tags from video ID, in case any have crept in
640
+ * Enhancement: Tidied some of the widget controls
641
+ * Enhancement: You can now specify YouTube short URLs as video IDs
642
+ * Bug: Removed reference to jscolor.js script, which isn't used
643
+ * Bug: Video IDs beginning with numbers are being confused with list numbers
644
+ * Bug: Corrected problem with random single videos being picked from a list
645
+ * Bug: Fixed problem with list where one video was being ignored and another repeated
646
+ * Bug: Modified widget code to allow for all states to be allowable. Defaults updated
647
+ * Bug: YouTube documentation states that if you don't specify the fullscreen parameter it will default to off. It doesn't. Corrected in the code
648
+
649
+ = 2.0.1 =
650
+ * Enhancement: Changed cache key encoding so that it was compatible with PHP 4
651
+ * Enhancement: Added autoplay option to EmbedPlus
652
+ * Enhancement: Re-instated `style` option, allowing you to apply a direct set of CSS elements to the output - a requirement if you wish to add a border to the video, for instance
653
+ * Maintenance: Updated screens and documentation to show the `start` parameter works with EmbedPlus
654
+ * Bug: Fixed incorrect caching of options - was only changing if override parameters were modified
655
+ * Bug: Video Information Cache will no longer reset to zero if the Embed cache is greater
656
+ * Bug: Added random ID to EmbedPlus output to resolve a bug that can affect IE users
657
+
658
+ = 2.0 =
659
+ * Maintenance: Renamed to Artiss YouTube Embed from YouTube Embed
660
+ * Maintenance: Major re-write, using new coding standards
661
+ * Maintenance: AS3 player is now used, AS2 has been retired
662
+ * Maintenance: Compliancy and browser checked - XHTML and HTML5 compliant and works in all the latest browsers
663
+ * Maintenance: README completely re-written, contextual help added to admin screens and links to further information
664
+ * Enhancement: New administration screens, introducing multiple profiles and playlists
665
+ * Enhancement: Both OBJECT and IFRAME versions can be selected
666
+ * Enhancement: Migration options added, allowing compatibility with other similar plugins
667
+ * Enhancement: Can now specify full video URL as well as video ID
668
+ * Enhancement: No need to use separate shortcode for playlists, as they are automatically detected. Video IDs are also now validated
669
+ * Enhancement: Options to allow YouTube URLs not within shortcodes to be accepted, as well as in comments
670
+ * Enhancement: RDFa metadata added to code output
671
+ * Enhancement: Caching of code and ID checking to improve performance
672
+ * Enhancement: Templating system replaces CSS specification
673
+ * Enhancement: Improved editor button and link added to admin bar
674
+ * Enhancement: Many, many more changes - too many to list!
675
+
676
+ = 1.5 =
677
+ * Enhancement: Added clone of 'youtube' shortcode, called 'youtube_video'
678
+ * Enhancement: Editor now has YouTube button, which inserts the YouTube shortcode (this can be switched off in the options screen)
679
+ * Enhancement: Added new option to disable keyboard controls
680
+ * Enhancement: Added option to supply a ratio, in case height or width are not supplied - the missing parameter will then be calculated
681
+ * Enhancement: Option to create a download link (for video and playlist) using function call or shortcode
682
+ * Enhancement: You can now change on the options screen which set of parameters the demonstration video uses (i.e. "normal" or EmbedPlus). This allows you to try your options on a different video type without switching to it.
683
+
684
+ = 1.4.2 =
685
+ * Enhancement: Added keyboard disable option
686
+ * Bug: Fixed bug which meant that people upgrading from previous versions may not be able to display video until they've been to the options screen and re-saved their default options
687
+
688
+ = 1.4.1 =
689
+ * Enhancement: HD option is available with EmbedPlus - updated the admin and widget screen to reflect this
690
+
691
+ = 1.4 =
692
+ * Maintenance: Tidied up code
693
+ * Enhancement: Now supports multiple widgets - widget code completely re-written
694
+ * Enhancement: Support for EmbedPlus added
695
+ * Enhancement: Added option to suppress links back to YouTube
696
+ * Enhancement: Added functions and shortcodes for returning and outputting available transcripts
697
+
698
+ = 1.3.1 =
699
+ * Enhancement: New widget option to specify title
700
+
701
+ = 1.3 =
702
+ * Enhancement: Added transparency option so that videos won't cover up layers
703
+
704
+ = 1.2 =
705
+ * Enhancement: Minor changes to the XHTML code to prevent warnings from certain validators
706
+
707
+ = 1.1 =
708
+ * Maintenance: Updated test video on options screen, as previous one had been removed
709
+ * Maintenance: Confirmed WP 3.0 compatibility
710
+ * Enhancement: Resulting XHTML code is better formatted, with comments identifying code location
711
+
712
+ = 1.0 =
713
+ * Initial release
714
+
715
+ == Upgrade Notice ==
716
+
717
+ = 4.3.2 =
718
+ * Upgrade to fix a bug with manual lists being saved
719
+
720
+ = 4.3.1 =
721
+ * Upgrade to fix an urgent issue that can generate WordPress errors
722
+
723
+ = 4.3 =
724
+ * Upgrade to add a new third party plugin screen
725
+
726
+ = 4.2.1 =
727
+ * Important update to fix a bug with the template field
728
+
729
+ = 4.2 =
730
+ * Who needs caching when the code works this fast? It's now 365% quicker than version 4.1. Completely re-written core code for rip-roaring speed
731
+
732
+ = 4.1 =
733
+ * Loads and loads of new features. Because I love you all.
734
+
735
+ = 4.0.2 =
736
+ * Minor bug fixes
737
+
738
+ = 4.0.1 =
739
+ * Upgrade to remove some debug code
740
+
741
+ = 4.0 =
742
+ * Fixed, squeezed and reduced. Make sure you read the changelog before upgrading!
743
+
744
+ = 3.3.5 =
745
+ * Update with text domain, ready for automatic translation
746
+
747
+ = 3.3.4 =
748
+ * Assorted fixes and enhancements inc. (I hope) a fix to the editor button not working
749
+
750
+ = 3.3.3 =
751
+ * Fix to resolve multiple urgent issues
752
+
753
+ = 3.3.2 =
754
+ * An urgent fix to the urgent fix, due to a corrupt file
755
+
756
+ = 3.3.1 =
757
+ * Urgent fix to get videos displaying. Alternatively, switch off API in Options screen
758
+
759
+ = 3.3 =
760
+ * Update to fix assorted bugs and to remove the redundant Vixy branding
761
+
762
+ = 3.2.1 =
763
+ * Update to bring metadata up to latest standards and to fix playlist issue
764
+
765
+ = 3.2 =
766
+ * Update to add new features, including the ability to show a video's comments
767
+
768
+ = 3.1 =
769
+ * Update to add new features including video quality option
770
+
771
+ = 3.0.1 =
772
+ * Update to fix admin bar links and add some further security improvements
773
+
774
+ = 3.0 =
775
+ * Update for bug fixes and enhancements including a new video download option with affiliate scheme
776
+
777
+ = 2.7 =
778
+ * Update to fix some bugs and add minor new features
779
+
780
+ = 2.6.2 =
781
+ * Update to fix an uninstaller bug and a problem that may affect some hosts
782
+
783
+ = 2.6.1 =
784
+ * Update to fix some bugs introduced in 2.6
785
+
786
+ = 2.6 =
787
+ * Upgrade to implement numerous bug fixes and enhancements
788
+
789
+ = 2.5.6 =
790
+ * Upgrade to fix critical bug for new installations
791
+
792
+ = 2.5.5 =
793
+ * Upgrade for various bug fixes and maintenance updates
794
+
795
+ = 2.5.4 =
796
+ * Upgrade to fix an issue with options not updating
797
+
798
+ = 2.5.3 =
799
+ * Upgrade to fix issues with widgets
800
+
801
+ = 2.5.2 =
802
+ * Upgrade if you use widgets to display videos
803
+
804
+ = 2.5.1 =
805
+ * Upgrade if you are using a WordPress version before 3.3
806
+
807
+ = 2.5 =
808
+ * Upgrade to add a number of new features (including automatic generation of playlists based on user name or search term) and fix some bugs
809
+
810
+ = 2.4.1 =
811
+ * Upgrade to remove the dashboard widget
812
+
813
+ = 2.4 =
814
+ * Numerous improvements, including new option for responsive video output
815
+
816
+ = 2.3.1 =
817
+ * Upgrade to remove the sponsorship
818
+
819
+ = 2.3 =
820
+ * Assorted bug fixes and minor improvements. Also added Chromeless player.
821
+
822
+ = 2.2 =
823
+ * Assorted minor improvements
824
+
825
+ = 2.1 =
826
+ * New options to change player colors, chose your thumbnails and control API usage
827
+
828
+ = 2.0.4 =
829
+ * Fixed SSL bug by removing HTTPS access to API
830
+
831
+ = 2.0.3 =
832
+ * Removed secure API access as this was causing some users issues
833
+
834
+ = 2.0.2 =
835
+ * Further update to fix a few minor bugs found in 2.0. A few small enhancements have also been made
836
+
837
+ = 2.0.1 =
838
+ * Update to fix a few minor bugs found in 2.0 and add a couple of small enhancements
839
+
840
+ = 2.0 =
841
+ * Upgrade to take advantage of many new features. Code completely re-written
842
+
843
+ = 1.5 =
844
+ * Upgrade to add a number of new options including video size ratios, disabling keyboard controls, an editor button and different demonstration video options on the admin screen
845
+
846
+ = 1.4.2 =
847
+ * Upgrade is you upgraded to version 1.4 or 1.4.1 from a previous version, to fix an important bug
848
+
849
+ = 1.4.1 =
850
+ * Upgrade to make a small correction to the parameter lists
851
+
852
+ = 1.4 =
853
+ * Update to add EmbedPlus, multi-widgets and transcript output capabilities
854
+
855
+ = 1.3.1 =
856
+ * Update if you wish to change the widget heading
857
+
858
+ = 1.3 =
859
+ * Update if you find that the videos are covering up layers
860
+
861
+ = 1.2 =
862
+ * Update to ensure no warnings are reported by XHTML validators
863
+
864
+ = 1.1 =
865
+ * Update to get the test video on the options screen working again!
866
+
867
+ = 1.0 =
868
  * Initial release
uninstall.php CHANGED
@@ -50,10 +50,4 @@ delete_option( 'youtube_embed_shortcode' );
50
  delete_option( 'youtube_embed_shortcode_admin' );
51
  delete_option( 'youtube_embed_shortcode_site' );
52
  delete_option( 'youtube_embed_version' );
53
-
54
- delete_site_option( 'youtube_embed_general' );
55
- delete_site_option( 'youtube_embed_shortcode' );
56
- delete_site_option( 'youtube_embed_shortcode_admin' );
57
- delete_site_option( 'youtube_embed_shortcode_site' );
58
- delete_site_option( 'youtube_embed_version' );
59
  ?>
50
  delete_option( 'youtube_embed_shortcode_admin' );
51
  delete_option( 'youtube_embed_shortcode_site' );
52
  delete_option( 'youtube_embed_version' );
 
 
 
 
 
 
53
  ?>
youtube-embed.php CHANGED
@@ -3,7 +3,7 @@
3
  Plugin Name: YouTube Embed
4
  Plugin URI: https://wordpress.org/plugins/youtube-embed/
5
  Description: Embed YouTube Videos in WordPress
6
- Version: 4.3.1
7
  Author: Coded Art
8
  Author URI: http://codedart.co
9
  Text Domain: youtube-embed
@@ -19,7 +19,7 @@ Domain Path: /languages
19
  * @since 2.0
20
  */
21
 
22
- define( 'youtube_embed_version', '4.3.1' );
23
 
24
  $functions_dir = plugin_dir_path( __FILE__ ) . 'includes/';
25
 
3
  Plugin Name: YouTube Embed
4
  Plugin URI: https://wordpress.org/plugins/youtube-embed/
5
  Description: Embed YouTube Videos in WordPress
6
+ Version: 4.3.2
7
  Author: Coded Art
8
  Author URI: http://codedart.co
9
  Text Domain: youtube-embed
19
  * @since 2.0
20
  */
21
 
22
+ define( 'youtube_embed_version', '4.3.2' );
23
 
24
  $functions_dir = plugin_dir_path( __FILE__ ) . 'includes/';
25