YouTube Embed - Version 3.2.1

Version Description

  • Bug: Fixed issue where playlist was appearing for single videos
  • Maintenance: Improved Metadata standard
Download this release

Release Info

Developer dartiss
Plugin Icon 128x128 YouTube Embed
Version 3.2.1
Comparing to
See all releases

Code changes from version 3.2 to 3.2.1

includes/generate-embed-code.php CHANGED
@@ -359,7 +359,7 @@ function vye_generate_youtube_code( $id = '', $type = '', $width = '', $height =
359
 
360
  // If not a playlist, add the playlist parameter
361
 
362
- if ( $playlist_ids != '' ) { $paras .= '&playlist=' . $playlist_ids; }
363
 
364
  // Generate EmbedPlus parameters
365
 
@@ -375,10 +375,24 @@ function vye_generate_youtube_code( $id = '', $type = '', $width = '', $height =
375
 
376
  // Generate DIVs to wrap around video
377
 
378
- if ( $dynamic == 1) {
379
- $result = "<div class=\"ye-container\">\n";
380
- if ( $fixed == 1) { $result = '<div style="width: ' . $width . 'px; max-width: 100%">' . "\n" . $result; }
 
 
 
381
  }
 
 
 
 
 
 
 
 
 
 
 
382
 
383
  // Add EmbedPlus code
384
 
@@ -444,17 +458,11 @@ function vye_generate_youtube_code( $id = '', $type = '', $width = '', $height =
444
  // Add AS3 YouTube embed code
445
 
446
  if ( ( $swf ) or ( $chromeless ) or ( ( $embedplus ) && ( ( $fallback == 'o' ) or ( $fallback == 'p' ) ) ) ) {
447
-
448
  $result .= $tab . "<object class=\"" . $class . "\" type=\"application/x-shockwave-flash\" data=\"" . $embed_url . "\" width=\"" . $width . "\" height=\"" . $height . "\" style=\"" . $style . "\"";
449
-
450
- if ( $metadata != 0 ) { $result .= " rel=\"media:video\" resource=\"http" . $https . "://www.youtube.com/" . $embed_type . "/" . $id ."\" xmlns:media=\"http://search.yahoo.com/searchmonkey/media/\""; }
451
- $result .= " >\n";
452
- if ( $metadata != 0 ) { $result .= $tab . "\t<a rel=\"media:thumbnail\" href=\"http://img.youtube.com/vi/" . $id . "/default.jpg\" /></a>\n"; }
453
  $result .= $tab . "\t<param name=\"movie\" value=\"" . $embed_url . "\" />\n";
454
  $result .= $tab . "\t<param name=\"wmode\" value=\"" . $wmode . "\" />\n";
455
  if ( $fullscreen == 1 ) { $result .= $tab . "\t<param name=\"allowFullScreen\" value=\"true\" />\n"; }
456
  if ( ( $link != 1 ) && ( $link != '' ) ) { $result .= $tab . "\t<param name=\"allowNetworking\" value=\"internal\" />\n"; }
457
- if ( ( $metadata != 0 ) && ( $return[ 'title' ] != '' ) ) { $result .= $tab . "\t<span property=\"media:title\" content=\"" . htmlentities( $return[ 'title' ] ) . "\" />\n"; }
458
  $result .= $tab . "</object>\n";
459
  }
460
 
@@ -462,20 +470,9 @@ function vye_generate_youtube_code( $id = '', $type = '', $width = '', $height =
462
 
463
  if ( ( $iframe ) or ( ( $embedplus ) && ( $fallback == "v" ) ) ) {
464
  if ( $embed_type == "p" ) { $playlist_para = "p/"; } else { $playlist_para = ''; }
465
- if ( $metadata != 0 ) { $result .= $tab . '<span itemscope="itemscope" xmlns:media="http://search.yahoo.com/searchmonkey/media/" xmlns:dc="http://purl.org/dc/terms/">' . "\n"; $tab .= $tab; }
466
  $result .= $tab . '<iframe ' . $frameborder . 'style="border: 0;' . $style . '" class="' . $class . '" width="' . $width . '" height="' . $height . '" src="' . $embed_url . '&amp;wmode=' . $wmode . '"';
467
  if ( $fullscreen == 1 ) { $result .= ' allowfullscreen="allowfullscreen"'; }
468
  $result .= " ></iframe>\n";
469
- if ( $metadata != 0 ) {
470
- $result .= $tab . '<link itemprop="media:video" rel="alternate" href="http' . $https . '://www.youtube.com/' . $embed_type . '/' . $id . '"/>' . "\n";
471
- $result .= $tab . '<link itemprop="media:thumbnail" rel="icon" href="http://i.ytimg.com/vi/' . $id . '/hqdefault.jpg"/>' . "\n";
472
- $result .= $tab . '<link itemprop="media:thumbnail" rel="icon" href="http://i.ytimg.com/vi/' . $id . '/default.jpg"/>' . "\n";
473
- if ( $return[ 'title' ] != '' ) { $result .= $tab . '<meta itemprop="media:title" content="' . htmlentities( $return[ 'title' ] ) . '"/>' . "\n"; }
474
- $result .= $tab . '<meta itemprop="media:width" content="' . $width . '"/>' . "\n";
475
- $result .= $tab . '<meta itemprop="media:height" content="' . $height . '"/>' . "\n";
476
- $tab = "\t";
477
- $result .= $tab . '</span>' . "\n";
478
- }
479
  }
480
 
481
  // If using EmbedPlus, add the OBJECT closure tag
@@ -485,9 +482,9 @@ function vye_generate_youtube_code( $id = '', $type = '', $width = '', $height =
485
  // Now apply the template to the result
486
 
487
  $end_tag = '';
488
- if ( $dynamic == 1 ) {
489
  $end_tag .= "</div>\n";
490
- if ( $fixed == 1 ) { $end_tag .= "</div>\n"; }
491
  }
492
  $result = str_replace( '%video%', $result . $end_tag, $template );
493
 
359
 
360
  // If not a playlist, add the playlist parameter
361
 
362
+ if ( ( $playlist_ids != '' ) && ( $playlist_ids != $id ) ) { $paras .= '&amp;playlist=' . $playlist_ids; }
363
 
364
  // Generate EmbedPlus parameters
365
 
375
 
376
  // Generate DIVs to wrap around video
377
 
378
+ if ( ( $dynamic == 1) or ( $metadata != 0 ) ) {
379
+ $result = '<div';
380
+ if ( $dynamic == 1 ) { $result .= ' class="ye-container"'; }
381
+ if ( $metadata != 0 ) { $result .= ' itemprop="video" itemscope itemtype="http://schema.org/VideoObject"'; }
382
+ $result .= ">\n";
383
+ if ( ( $dynamic == 1 ) && ( $fixed == 1) ) { $result = '<div style="width: ' . $width . 'px; max-width: 100%">' . "\n" . $result; }
384
  }
385
+
386
+ // Add Metadata
387
+
388
+ if ( $metadata != 0 ) {
389
+ $newline = "\n";
390
+ if ( $return[ 'title' ] != '' ) { $result .= '<meta itemprop="name" content="' . htmlentities( $return[ 'title' ] ) . '"/>' . $newline; }
391
+ $result .= '<meta itemprop="thumbnailUrl" content="http://i.ytimg.com/vi/' . $id . '/hqdefault.jpg" />' . $newline;
392
+ $result .= '<meta itemprop="embedURL" content="http' . $https . '://www.youtube.com/' . $embed_type . '/' . $id . '" />' . $newline;
393
+ $result .= '<meta itemprop="height" content="' . $height . '" />' . $newline;
394
+ $result .= '<meta itemprop="width" content="' . $width . '" />' . $newline;
395
+ }
396
 
397
  // Add EmbedPlus code
398
 
458
  // Add AS3 YouTube embed code
459
 
460
  if ( ( $swf ) or ( $chromeless ) or ( ( $embedplus ) && ( ( $fallback == 'o' ) or ( $fallback == 'p' ) ) ) ) {
 
461
  $result .= $tab . "<object class=\"" . $class . "\" type=\"application/x-shockwave-flash\" data=\"" . $embed_url . "\" width=\"" . $width . "\" height=\"" . $height . "\" style=\"" . $style . "\"";
 
 
 
 
462
  $result .= $tab . "\t<param name=\"movie\" value=\"" . $embed_url . "\" />\n";
463
  $result .= $tab . "\t<param name=\"wmode\" value=\"" . $wmode . "\" />\n";
464
  if ( $fullscreen == 1 ) { $result .= $tab . "\t<param name=\"allowFullScreen\" value=\"true\" />\n"; }
465
  if ( ( $link != 1 ) && ( $link != '' ) ) { $result .= $tab . "\t<param name=\"allowNetworking\" value=\"internal\" />\n"; }
 
466
  $result .= $tab . "</object>\n";
467
  }
468
 
470
 
471
  if ( ( $iframe ) or ( ( $embedplus ) && ( $fallback == "v" ) ) ) {
472
  if ( $embed_type == "p" ) { $playlist_para = "p/"; } else { $playlist_para = ''; }
 
473
  $result .= $tab . '<iframe ' . $frameborder . 'style="border: 0;' . $style . '" class="' . $class . '" width="' . $width . '" height="' . $height . '" src="' . $embed_url . '&amp;wmode=' . $wmode . '"';
474
  if ( $fullscreen == 1 ) { $result .= ' allowfullscreen="allowfullscreen"'; }
475
  $result .= " ></iframe>\n";
 
 
 
 
 
 
 
 
 
 
476
  }
477
 
478
  // If using EmbedPlus, add the OBJECT closure tag
482
  // Now apply the template to the result
483
 
484
  $end_tag = '';
485
+ if ( ( $dynamic == 1 ) or ( $metadata != 0 ) ) {
486
  $end_tag .= "</div>\n";
487
+ if ( ( $dynamic == 1 ) && ( $fixed == 1 ) ) { $end_tag .= "</div>\n"; }
488
  }
489
  $result = str_replace( '%video%', $result . $end_tag, $template );
490
 
languages/youtube-embed.mo CHANGED
Binary file
languages/youtube-embed.po CHANGED
@@ -2,17 +2,19 @@ msgid ""
2
  msgstr ""
3
  "Project-Id-Version: Vixy YouTube Embed\n"
4
  "Report-Msgid-Bugs-To: \n"
5
- "POT-Creation-Date: 2013-02-18 12:05-0000\n"
6
- "PO-Revision-Date: 2013-02-18 12:06-0000\n"
7
  "Last-Translator: David Artiss <david.artiss@artiss.co.uk>\n"
8
  "Language-Team: \n"
 
9
  "MIME-Version: 1.0\n"
10
  "Content-Type: text/plain; charset=UTF-8\n"
11
  "Content-Transfer-Encoding: 8bit\n"
12
  "X-Poedit-KeywordsList: __;_e;esc_attr__;esc_attr_e;esc_html__;esc_html_e;_x;"
13
  "_ex;esc_attr_x;esc_html_x;_n;_nx;_n_noop;_nx_noop\n"
14
  "X-Poedit-Basepath: ../\n"
15
- "X-Generator: Poedit 1.5.5\n"
 
16
  "X-Poedit-SearchPath-0: .\n"
17
 
18
  #: includes/add-to-admin-bar.php:36 includes/add-to-admin-bar.php:74
@@ -20,15 +22,15 @@ msgstr ""
20
  msgid "YouTube Embed"
21
  msgstr ""
22
 
23
- #: includes/add-to-admin-bar.php:79 includes/admin-config.php:93
24
  msgid "Options"
25
  msgstr ""
26
 
27
- #: includes/add-to-admin-bar.php:86 includes/admin-config.php:103
28
  msgid "Profiles"
29
  msgstr ""
30
 
31
- #: includes/add-to-admin-bar.php:93 includes/admin-config.php:113
32
  msgid "Lists"
33
  msgstr ""
34
 
@@ -40,61 +42,61 @@ msgstr ""
40
  msgid "Support"
41
  msgstr ""
42
 
43
- #: includes/admin-config.php:87
44
  msgid "About Vixy YouTube Embed"
45
  msgstr ""
46
 
47
- #: includes/admin-config.php:87
48
  msgid "YouTube"
49
  msgstr ""
50
 
51
- #: includes/admin-config.php:93 includes/options-general.php:14
52
  msgid "Vixy YouTube Embed Options"
53
  msgstr ""
54
 
55
- #: includes/admin-config.php:103 includes/options-profiles.php:20
56
  msgid "Vixy YouTube Embed Profiles"
57
  msgstr ""
58
 
59
- #: includes/admin-config.php:113 includes/options-lists.php:15
60
  msgid "Vixy YouTube Embed Lists"
61
  msgstr ""
62
 
63
- #: includes/admin-config.php:209 includes/admin-config.php:250
64
- #: includes/admin-config.php:292
65
  msgid "Help"
66
  msgstr ""
67
 
68
- #: includes/admin-config.php:224
69
  msgid ""
70
  "This screen allows you to select non-specific options for the Vixy YouTube "
71
  "Embed plugin. For the default embedding settings, please select the <a href="
72
  "\"admin.php?page=profile-options\">Profiles</a> administration option."
73
  msgstr ""
74
 
75
- #: includes/admin-config.php:225 includes/admin-config.php:266
76
- #: includes/admin-config.php:308
77
  msgid ""
78
  "Remember to click the Save Settings button at the bottom of the screen for "
79
  "new settings to take effect."
80
  msgstr ""
81
 
82
- #: includes/admin-config.php:226 includes/admin-config.php:267
83
- #: includes/admin-config.php:309
84
  msgid "For more information:"
85
  msgstr ""
86
 
87
- #: includes/admin-config.php:227 includes/admin-config.php:268
88
- #: includes/admin-config.php:310
89
  msgid "Vixy YouTube Embed Plugin Documentation"
90
  msgstr ""
91
 
92
- #: includes/admin-config.php:228 includes/admin-config.php:269
93
- #: includes/admin-config.php:311
94
  msgid "YouTube Player Documentation"
95
  msgstr ""
96
 
97
- #: includes/admin-config.php:265
98
  msgid ""
99
  "This screen allows you to set the options for the default and additional "
100
  "profiles. If you don't specify a specific parameter when displaying your "
@@ -103,31 +105,31 @@ msgid ""
103
  "required."
104
  msgstr ""
105
 
106
- #: includes/admin-config.php:270
107
  msgid "EmbedPlus website"
108
  msgstr ""
109
 
110
- #: includes/admin-config.php:307
111
  msgid ""
112
  "This screen allows you to create lists of YouTube videos, which may be "
113
  "named. These lists can then be used in preference to a single video ID."
114
  msgstr ""
115
 
116
- #: includes/admin-config.php:369
117
  msgid "Welcome to Vixy YouTube Embed"
118
  msgstr ""
119
 
120
- #: includes/admin-config.php:370
121
  msgid "Thank you for installing this plugin."
122
  msgstr ""
123
 
124
- #: includes/admin-config.php:371
125
  msgid ""
126
  "These new menu options will allow you to configure your videos to just how "
127
  "you want them and provide links for help and support."
128
  msgstr ""
129
 
130
- #: includes/admin-config.php:372
131
  msgid ""
132
  "Even if you do nothing else, please visit the Profiles option to check your "
133
  "default video values."
@@ -138,6 +140,7 @@ msgid "This function does not support playlists"
138
  msgstr ""
139
 
140
  #: includes/function-calls.php:164 includes/function-calls.php:226
 
141
  #: includes/generate-download-code.php:34 includes/generate-embed-code.php:116
142
  #: includes/generate-shorturl-code.php:34
143
  #: includes/generate-thumbnail-code.php:39
@@ -151,6 +154,14 @@ msgstr ""
151
  msgid "Could not fetch the transcript file %s."
152
  msgstr ""
153
 
 
 
 
 
 
 
 
 
154
  #: includes/generate-download-code.php:21
155
  msgid "No YouTube ID was found."
156
  msgstr ""
@@ -182,381 +193,389 @@ msgstr ""
182
  msgid "Embed YouTube Widget."
183
  msgstr ""
184
 
185
- #: includes/options-general.php:61 includes/options-lists.php:26
186
  msgid "Settings Saved."
187
  msgstr ""
188
 
189
- #: includes/options-general.php:85
190
  msgid "Cache cleared."
191
  msgstr ""
192
 
193
- #: includes/options-general.php:99
194
  msgid ""
195
  "These are the general settings for Vixy YouTube Embed. Please select <a href="
196
  "\"admin.php?page=profile-options\">Profiles</a> for default embedding "
197
  "settings."
198
  msgstr ""
199
 
200
- #: includes/options-general.php:103
201
- msgid "Embedding"
202
  msgstr ""
203
 
204
  #: includes/options-general.php:107
205
- msgid "Add Metadata"
206
  msgstr ""
207
 
208
  #: includes/options-general.php:108
209
  msgid ""
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
210
  "Allow rich metadata to be added to code. <a href=\"http://vixy.net/youtube-"
211
  "embed/documentation.php#Metadata\">Learn more</a>"
212
  msgstr ""
213
 
214
- #: includes/options-general.php:112
215
  msgid "Comment Embedding"
216
  msgstr ""
217
 
218
- #: includes/options-general.php:113
219
  msgid "Allow YouTube URLs in comments - will display as embedded videos."
220
  msgstr ""
221
 
222
- #: includes/options-general.php:117 includes/options-general.php:158
223
- #: includes/options-general.php:170 includes/options-general.php:191
224
  msgid "Profile to use"
225
  msgstr ""
226
 
227
- #: includes/options-general.php:124
228
  msgid "Feed"
229
  msgstr ""
230
 
231
- #: includes/options-general.php:126
232
  msgid "Text link"
233
  msgstr ""
234
 
235
- #: includes/options-general.php:127
236
  msgid "Thumbnail"
237
  msgstr ""
238
 
239
- #: includes/options-general.php:128
240
  msgid "Thumbnail &amp; Text Link"
241
  msgstr ""
242
 
243
- #: includes/options-general.php:129
244
  msgid ""
245
  "Videos cannot be embedded in feeds. Select how you wish them to be shown "
246
  "instead"
247
  msgstr ""
248
 
249
- #: includes/options-general.php:133
250
  msgid "Thumbnail to use"
251
  msgstr ""
252
 
253
- #: includes/options-general.php:135 includes/shared-functions.php:481
254
  msgid "Default"
255
  msgstr ""
256
 
257
- #: includes/options-general.php:136
258
  msgid "Default (HQ)"
259
  msgstr ""
260
 
261
- #: includes/options-general.php:137
262
  msgid "Start"
263
  msgstr ""
264
 
265
- #: includes/options-general.php:138
266
  msgid "Middle"
267
  msgstr ""
268
 
269
- #: includes/options-general.php:139
270
  msgid "End"
271
  msgstr ""
272
 
273
- #: includes/options-general.php:140
274
  msgid "Which thumbnail to use"
275
  msgstr ""
276
 
277
- #: includes/options-general.php:144
278
  msgid "Allow shortcodes in widgets"
279
  msgstr ""
280
 
281
- #: includes/options-general.php:145
282
  msgid ""
283
  "Allow shortcodes to be used in widgets - this will apply to <strong>all</"
284
  "strong> widgets"
285
  msgstr ""
286
 
287
- #: includes/options-general.php:149
288
  msgid "Alternative Shortcodes"
289
  msgstr ""
290
 
291
- #: includes/options-general.php:149
292
  msgid ""
293
  "Specify up to 2 alternative shortcodes to compliment the standard "
294
  "<code>youtube</code> shortcode. <strong>NB: These should be specified "
295
  "without the surrounding square brackets.</strong>"
296
  msgstr ""
297
 
298
- #: includes/options-general.php:153
299
  msgid "Alternative Shortcode 1"
300
  msgstr ""
301
 
302
- #: includes/options-general.php:165
303
  msgid "Alternative Shortcode 2"
304
  msgstr ""
305
 
306
- #: includes/options-general.php:177
307
  msgid "Migration"
308
  msgstr ""
309
 
310
- #: includes/options-general.php:177
311
  msgid ""
312
  "Switch on compatibility with other embedding plugins. For more details "
313
  "please <a href=\"http://vixy.net/youtube-embed/documentation.php#Migrating"
314
  "\">click here</a>."
315
  msgstr ""
316
 
317
- #: includes/options-general.php:181
318
  msgid "Bracket Embedding"
319
  msgstr ""
320
 
321
- #: includes/options-general.php:182
322
  msgid ""
323
  "Allow embedding using URLs within brackets. Activating impacts performance"
324
  msgstr ""
325
 
326
- #: includes/options-general.php:186
327
  msgid "Alternative Embedding"
328
  msgstr ""
329
 
330
- #: includes/options-general.php:187
331
  msgid "Allow all other types of embedding. Activating impacts performance"
332
  msgstr ""
333
 
334
- #: includes/options-general.php:194
335
  msgid "For above 2 options"
336
  msgstr ""
337
 
338
- #: includes/options-general.php:198
339
  msgid "Admin Options"
340
  msgstr ""
341
 
342
- #: includes/options-general.php:202
343
  msgid "Show Editor Button"
344
  msgstr ""
345
 
346
- #: includes/options-general.php:203
347
  msgid "Show the YouTube button on the post editor"
348
  msgstr ""
349
 
350
- #: includes/options-general.php:207
351
  msgid "Editor Button Shortcode"
352
  msgstr ""
353
 
354
- #: includes/options-general.php:208
355
  msgid "Shortcode for editor button to use."
356
  msgstr ""
357
 
358
- #: includes/options-general.php:212
359
  msgid "Add to Admin Bar"
360
  msgstr ""
361
 
362
- #: includes/options-general.php:213
363
  msgid "Add link to options screen to Admin Bar"
364
  msgstr ""
365
 
366
- #: includes/options-general.php:217
367
  msgid "Menu Screen Access"
368
  msgstr ""
369
 
370
- #: includes/options-general.php:219
371
  msgid "Administrator"
372
  msgstr ""
373
 
374
- #: includes/options-general.php:220
375
  msgid "Editor"
376
  msgstr ""
377
 
378
- #: includes/options-general.php:221
379
  msgid "Author"
380
  msgstr ""
381
 
382
- #: includes/options-general.php:222
383
  msgid "Contributor"
384
  msgstr ""
385
 
386
- #: includes/options-general.php:223
387
  msgid "Specify the user access required for the menu screens"
388
  msgstr ""
389
 
390
- #: includes/options-general.php:227
391
  msgid "Profile &amp; List Sizes"
392
  msgstr ""
393
 
394
- #: includes/options-general.php:231
395
  msgid "Number of Profiles"
396
  msgstr ""
397
 
398
- #: includes/options-general.php:232
399
  msgid "Maximum number of profiles"
400
  msgstr ""
401
 
402
- #: includes/options-general.php:236
403
  msgid "Number of Lists"
404
  msgstr ""
405
 
406
- #: includes/options-general.php:237
407
  msgid "Maximum number of lists"
408
  msgstr ""
409
 
410
- #: includes/options-general.php:241
411
  msgid "Performance"
412
  msgstr ""
413
 
414
- #: includes/options-general.php:245
415
  msgid "Embed Cache"
416
  msgstr ""
417
 
418
- #: includes/options-general.php:246
419
  msgid "How many hours to retain embed output. 0 to switch off"
420
  msgstr ""
421
 
422
- #: includes/options-general.php:250
423
  msgid "Video Information Cache"
424
  msgstr ""
425
 
426
- #: includes/options-general.php:251
427
  msgid ""
428
  "How many hours to retain video information, including it's validity. 0 to "
429
  "switch off"
430
  msgstr ""
431
 
432
- #: includes/options-general.php:255
433
  msgid "Transcript Cache"
434
  msgstr ""
435
 
436
- #: includes/options-general.php:256
437
  msgid "How many hours to store transcripts for in cache. 0 to switch off"
438
  msgstr ""
439
 
440
- #: includes/options-general.php:265
 
 
 
 
 
 
 
 
441
  msgid "You currently have cache for"
442
  msgstr ""
443
 
444
- #: includes/options-general.php:265
445
  msgid "and"
446
  msgstr ""
447
 
448
- #: includes/options-general.php:269
449
  msgid "Clear Cache"
450
  msgstr ""
451
 
452
- #: includes/options-general.php:270
453
  msgid "Select this option to remove all YouTube Embed cache."
454
  msgstr ""
455
 
456
- #: includes/options-general.php:273
457
  msgid "YouTube API"
458
  msgstr ""
459
 
460
- #: includes/options-general.php:275
461
  msgid ""
462
  "The YouTube API is used to validate video IDs and to determine if it is a "
463
  "video or playlist."
464
  msgstr ""
465
 
466
- #: includes/options-general.php:279
467
  msgid "API State"
468
  msgstr ""
469
 
470
- #: includes/options-general.php:281
471
  msgid "API should not be used"
472
  msgstr ""
473
 
474
- #: includes/options-general.php:282
475
  msgid "HTTP API used and errors are reported"
476
  msgstr ""
477
 
478
- #: includes/options-general.php:283
479
  msgid "HTTPS API used and errors are reported"
480
  msgstr ""
481
 
482
- #: includes/options-general.php:284
483
  msgid "HTTP API used and no errors are reported"
484
  msgstr ""
485
 
486
- #: includes/options-general.php:285
487
  msgid "HTTPS API used and no errors are reported"
488
  msgstr ""
489
 
490
- #: includes/options-general.php:290
491
  msgid "Error Reporting"
492
  msgstr ""
493
 
494
- #: includes/options-general.php:292
495
  msgid ""
496
  "Playback errors are within the XHTML source code as comments - parameter "
497
  "errors and other types are displayed on the post output."
498
  msgstr ""
499
 
500
- #: includes/options-general.php:295
501
  msgid "Video Playback Error Message"
502
  msgstr ""
503
 
504
- #: includes/options-general.php:296
505
  msgid "This is the message that will be shown on the post"
506
  msgstr ""
507
 
508
- #: includes/options-general.php:299
509
  msgid "Security"
510
  msgstr ""
511
 
512
- #: includes/options-general.php:304
513
  msgid "Privacy-Enhanced Mode"
514
  msgstr ""
515
 
516
- #: includes/options-general.php:306
517
  msgid "Cookies should always be stored"
518
  msgstr ""
519
 
520
- #: includes/options-general.php:307
521
  msgid "Cookies should never be stored"
522
  msgstr ""
523
 
524
- #: includes/options-general.php:308
525
  msgid "Cookies should be stored based on user's Do Not Track setting"
526
  msgstr ""
527
 
528
- #: includes/options-general.php:309
529
  msgid "Read more about <a href=\"http://donottrack.us/\">Do Not Track</a>"
530
  msgstr ""
531
 
532
- #: includes/options-general.php:312
533
  msgid "Compatibility"
534
  msgstr ""
535
 
536
- #: includes/options-general.php:315
537
  msgid "Allow Frame Border on IFRAME"
538
  msgstr ""
539
 
540
- #: includes/options-general.php:316
541
  msgid "FRAMEBORDER is not HTML5 compliant"
542
  msgstr ""
543
 
544
- #: includes/options-general.php:319
545
- msgid "Affiliates"
546
- msgstr ""
547
-
548
- #: includes/options-general.php:321
549
- msgid "ShareASale ID"
550
- msgstr ""
551
-
552
- #: includes/options-general.php:322
553
- msgid ""
554
- "<a href=\"http://www.shareasale.com/r.cfm?B=44&U=668714&M=47&urllink=\">Sign "
555
- "up to ShareASale</a> and earn money. <a href=\"http://vixy.net/youtube-embed/"
556
- "documentation.php#make_money\">Read more</a>."
557
- msgstr ""
558
-
559
- #: includes/options-general.php:327 includes/options-lists.php:119
560
  #: includes/options-profiles.php:395
561
  msgid "Save Settings"
562
  msgstr ""
@@ -1201,6 +1220,6 @@ msgstr ""
1201
  msgid "An error occurred accessing the YouTube API for video ID %s - %s"
1202
  msgstr ""
1203
 
1204
- #: includes/shared-functions.php:531
1205
  msgid "View on YouTube"
1206
  msgstr ""
2
  msgstr ""
3
  "Project-Id-Version: Vixy YouTube Embed\n"
4
  "Report-Msgid-Bugs-To: \n"
5
+ "POT-Creation-Date: 2014-05-22 10:06-0000\n"
6
+ "PO-Revision-Date: 2014-05-22 10:06-0000\n"
7
  "Last-Translator: David Artiss <david.artiss@artiss.co.uk>\n"
8
  "Language-Team: \n"
9
+ "Language: en_GB\n"
10
  "MIME-Version: 1.0\n"
11
  "Content-Type: text/plain; charset=UTF-8\n"
12
  "Content-Transfer-Encoding: 8bit\n"
13
  "X-Poedit-KeywordsList: __;_e;esc_attr__;esc_attr_e;esc_html__;esc_html_e;_x;"
14
  "_ex;esc_attr_x;esc_html_x;_n;_nx;_n_noop;_nx_noop\n"
15
  "X-Poedit-Basepath: ../\n"
16
+ "X-Generator: Poedit 1.6.5\n"
17
+ "Plural-Forms: nplurals=2; plural=(n != 1);\n"
18
  "X-Poedit-SearchPath-0: .\n"
19
 
20
  #: includes/add-to-admin-bar.php:36 includes/add-to-admin-bar.php:74
22
  msgid "YouTube Embed"
23
  msgstr ""
24
 
25
+ #: includes/add-to-admin-bar.php:79 includes/admin-config.php:101
26
  msgid "Options"
27
  msgstr ""
28
 
29
+ #: includes/add-to-admin-bar.php:86 includes/admin-config.php:111
30
  msgid "Profiles"
31
  msgstr ""
32
 
33
+ #: includes/add-to-admin-bar.php:93 includes/admin-config.php:121
34
  msgid "Lists"
35
  msgstr ""
36
 
42
  msgid "Support"
43
  msgstr ""
44
 
45
+ #: includes/admin-config.php:95
46
  msgid "About Vixy YouTube Embed"
47
  msgstr ""
48
 
49
+ #: includes/admin-config.php:95
50
  msgid "YouTube"
51
  msgstr ""
52
 
53
+ #: includes/admin-config.php:101 includes/options-general.php:14
54
  msgid "Vixy YouTube Embed Options"
55
  msgstr ""
56
 
57
+ #: includes/admin-config.php:111 includes/options-profiles.php:20
58
  msgid "Vixy YouTube Embed Profiles"
59
  msgstr ""
60
 
61
+ #: includes/admin-config.php:121 includes/options-lists.php:15
62
  msgid "Vixy YouTube Embed Lists"
63
  msgstr ""
64
 
65
+ #: includes/admin-config.php:217 includes/admin-config.php:258
66
+ #: includes/admin-config.php:300
67
  msgid "Help"
68
  msgstr ""
69
 
70
+ #: includes/admin-config.php:232
71
  msgid ""
72
  "This screen allows you to select non-specific options for the Vixy YouTube "
73
  "Embed plugin. For the default embedding settings, please select the <a href="
74
  "\"admin.php?page=profile-options\">Profiles</a> administration option."
75
  msgstr ""
76
 
77
+ #: includes/admin-config.php:233 includes/admin-config.php:274
78
+ #: includes/admin-config.php:316
79
  msgid ""
80
  "Remember to click the Save Settings button at the bottom of the screen for "
81
  "new settings to take effect."
82
  msgstr ""
83
 
84
+ #: includes/admin-config.php:234 includes/admin-config.php:275
85
+ #: includes/admin-config.php:317
86
  msgid "For more information:"
87
  msgstr ""
88
 
89
+ #: includes/admin-config.php:235 includes/admin-config.php:276
90
+ #: includes/admin-config.php:318
91
  msgid "Vixy YouTube Embed Plugin Documentation"
92
  msgstr ""
93
 
94
+ #: includes/admin-config.php:236 includes/admin-config.php:277
95
+ #: includes/admin-config.php:319
96
  msgid "YouTube Player Documentation"
97
  msgstr ""
98
 
99
+ #: includes/admin-config.php:273
100
  msgid ""
101
  "This screen allows you to set the options for the default and additional "
102
  "profiles. If you don't specify a specific parameter when displaying your "
105
  "required."
106
  msgstr ""
107
 
108
+ #: includes/admin-config.php:278
109
  msgid "EmbedPlus website"
110
  msgstr ""
111
 
112
+ #: includes/admin-config.php:315
113
  msgid ""
114
  "This screen allows you to create lists of YouTube videos, which may be "
115
  "named. These lists can then be used in preference to a single video ID."
116
  msgstr ""
117
 
118
+ #: includes/admin-config.php:377
119
  msgid "Welcome to Vixy YouTube Embed"
120
  msgstr ""
121
 
122
+ #: includes/admin-config.php:378
123
  msgid "Thank you for installing this plugin."
124
  msgstr ""
125
 
126
+ #: includes/admin-config.php:379
127
  msgid ""
128
  "These new menu options will allow you to configure your videos to just how "
129
  "you want them and provide links for help and support."
130
  msgstr ""
131
 
132
+ #: includes/admin-config.php:380
133
  msgid ""
134
  "Even if you do nothing else, please visit the Profiles option to check your "
135
  "default video values."
140
  msgstr ""
141
 
142
  #: includes/function-calls.php:164 includes/function-calls.php:226
143
+ #: includes/generate-comments-code.php:44
144
  #: includes/generate-download-code.php:34 includes/generate-embed-code.php:116
145
  #: includes/generate-shorturl-code.php:34
146
  #: includes/generate-thumbnail-code.php:39
154
  msgid "Could not fetch the transcript file %s."
155
  msgstr ""
156
 
157
+ #: includes/generate-comments-code.php:31
158
+ msgid "No YouTube ID was specified."
159
+ msgstr ""
160
+
161
+ #: includes/generate-comments-code.php:120
162
+ msgid "ago"
163
+ msgstr ""
164
+
165
  #: includes/generate-download-code.php:21
166
  msgid "No YouTube ID was found."
167
  msgstr ""
193
  msgid "Embed YouTube Widget."
194
  msgstr ""
195
 
196
+ #: includes/options-general.php:62 includes/options-lists.php:26
197
  msgid "Settings Saved."
198
  msgstr ""
199
 
200
+ #: includes/options-general.php:86
201
  msgid "Cache cleared."
202
  msgstr ""
203
 
204
+ #: includes/options-general.php:100
205
  msgid ""
206
  "These are the general settings for Vixy YouTube Embed. Please select <a href="
207
  "\"admin.php?page=profile-options\">Profiles</a> for default embedding "
208
  "settings."
209
  msgstr ""
210
 
211
+ #: includes/options-general.php:104
212
+ msgid "Affiliates"
213
  msgstr ""
214
 
215
  #: includes/options-general.php:107
216
+ msgid "ShareASale ID"
217
  msgstr ""
218
 
219
  #: includes/options-general.php:108
220
  msgid ""
221
+ "<a href=\"http://www.shareasale.com/r.cfm?B=44&U=668714&M=47&urllink=\">Sign "
222
+ "up to ShareASale</a> and earn money. <a href=\"http://vixy.net/youtube-embed/"
223
+ "documentation.php#make_money\">Read more</a>."
224
+ msgstr ""
225
+
226
+ #: includes/options-general.php:111
227
+ msgid "Embedding"
228
+ msgstr ""
229
+
230
+ #: includes/options-general.php:115
231
+ msgid "Add Metadata"
232
+ msgstr ""
233
+
234
+ #: includes/options-general.php:116
235
+ msgid ""
236
  "Allow rich metadata to be added to code. <a href=\"http://vixy.net/youtube-"
237
  "embed/documentation.php#Metadata\">Learn more</a>"
238
  msgstr ""
239
 
240
+ #: includes/options-general.php:120
241
  msgid "Comment Embedding"
242
  msgstr ""
243
 
244
+ #: includes/options-general.php:121
245
  msgid "Allow YouTube URLs in comments - will display as embedded videos."
246
  msgstr ""
247
 
248
+ #: includes/options-general.php:125 includes/options-general.php:166
249
+ #: includes/options-general.php:178 includes/options-general.php:199
250
  msgid "Profile to use"
251
  msgstr ""
252
 
253
+ #: includes/options-general.php:132
254
  msgid "Feed"
255
  msgstr ""
256
 
257
+ #: includes/options-general.php:134
258
  msgid "Text link"
259
  msgstr ""
260
 
261
+ #: includes/options-general.php:135
262
  msgid "Thumbnail"
263
  msgstr ""
264
 
265
+ #: includes/options-general.php:136
266
  msgid "Thumbnail &amp; Text Link"
267
  msgstr ""
268
 
269
+ #: includes/options-general.php:137
270
  msgid ""
271
  "Videos cannot be embedded in feeds. Select how you wish them to be shown "
272
  "instead"
273
  msgstr ""
274
 
275
+ #: includes/options-general.php:141
276
  msgid "Thumbnail to use"
277
  msgstr ""
278
 
279
+ #: includes/options-general.php:143 includes/shared-functions.php:481
280
  msgid "Default"
281
  msgstr ""
282
 
283
+ #: includes/options-general.php:144
284
  msgid "Default (HQ)"
285
  msgstr ""
286
 
287
+ #: includes/options-general.php:145
288
  msgid "Start"
289
  msgstr ""
290
 
291
+ #: includes/options-general.php:146
292
  msgid "Middle"
293
  msgstr ""
294
 
295
+ #: includes/options-general.php:147
296
  msgid "End"
297
  msgstr ""
298
 
299
+ #: includes/options-general.php:148
300
  msgid "Which thumbnail to use"
301
  msgstr ""
302
 
303
+ #: includes/options-general.php:152
304
  msgid "Allow shortcodes in widgets"
305
  msgstr ""
306
 
307
+ #: includes/options-general.php:153
308
  msgid ""
309
  "Allow shortcodes to be used in widgets - this will apply to <strong>all</"
310
  "strong> widgets"
311
  msgstr ""
312
 
313
+ #: includes/options-general.php:157
314
  msgid "Alternative Shortcodes"
315
  msgstr ""
316
 
317
+ #: includes/options-general.php:157
318
  msgid ""
319
  "Specify up to 2 alternative shortcodes to compliment the standard "
320
  "<code>youtube</code> shortcode. <strong>NB: These should be specified "
321
  "without the surrounding square brackets.</strong>"
322
  msgstr ""
323
 
324
+ #: includes/options-general.php:161
325
  msgid "Alternative Shortcode 1"
326
  msgstr ""
327
 
328
+ #: includes/options-general.php:173
329
  msgid "Alternative Shortcode 2"
330
  msgstr ""
331
 
332
+ #: includes/options-general.php:185
333
  msgid "Migration"
334
  msgstr ""
335
 
336
+ #: includes/options-general.php:185
337
  msgid ""
338
  "Switch on compatibility with other embedding plugins. For more details "
339
  "please <a href=\"http://vixy.net/youtube-embed/documentation.php#Migrating"
340
  "\">click here</a>."
341
  msgstr ""
342
 
343
+ #: includes/options-general.php:189
344
  msgid "Bracket Embedding"
345
  msgstr ""
346
 
347
+ #: includes/options-general.php:190
348
  msgid ""
349
  "Allow embedding using URLs within brackets. Activating impacts performance"
350
  msgstr ""
351
 
352
+ #: includes/options-general.php:194
353
  msgid "Alternative Embedding"
354
  msgstr ""
355
 
356
+ #: includes/options-general.php:195
357
  msgid "Allow all other types of embedding. Activating impacts performance"
358
  msgstr ""
359
 
360
+ #: includes/options-general.php:202
361
  msgid "For above 2 options"
362
  msgstr ""
363
 
364
+ #: includes/options-general.php:206
365
  msgid "Admin Options"
366
  msgstr ""
367
 
368
+ #: includes/options-general.php:210
369
  msgid "Show Editor Button"
370
  msgstr ""
371
 
372
+ #: includes/options-general.php:211
373
  msgid "Show the YouTube button on the post editor"
374
  msgstr ""
375
 
376
+ #: includes/options-general.php:215
377
  msgid "Editor Button Shortcode"
378
  msgstr ""
379
 
380
+ #: includes/options-general.php:216
381
  msgid "Shortcode for editor button to use."
382
  msgstr ""
383
 
384
+ #: includes/options-general.php:220
385
  msgid "Add to Admin Bar"
386
  msgstr ""
387
 
388
+ #: includes/options-general.php:221
389
  msgid "Add link to options screen to Admin Bar"
390
  msgstr ""
391
 
392
+ #: includes/options-general.php:225
393
  msgid "Menu Screen Access"
394
  msgstr ""
395
 
396
+ #: includes/options-general.php:227
397
  msgid "Administrator"
398
  msgstr ""
399
 
400
+ #: includes/options-general.php:228
401
  msgid "Editor"
402
  msgstr ""
403
 
404
+ #: includes/options-general.php:229
405
  msgid "Author"
406
  msgstr ""
407
 
408
+ #: includes/options-general.php:230
409
  msgid "Contributor"
410
  msgstr ""
411
 
412
+ #: includes/options-general.php:231
413
  msgid "Specify the user access required for the menu screens"
414
  msgstr ""
415
 
416
+ #: includes/options-general.php:235
417
  msgid "Profile &amp; List Sizes"
418
  msgstr ""
419
 
420
+ #: includes/options-general.php:239
421
  msgid "Number of Profiles"
422
  msgstr ""
423
 
424
+ #: includes/options-general.php:240
425
  msgid "Maximum number of profiles"
426
  msgstr ""
427
 
428
+ #: includes/options-general.php:244
429
  msgid "Number of Lists"
430
  msgstr ""
431
 
432
+ #: includes/options-general.php:245
433
  msgid "Maximum number of lists"
434
  msgstr ""
435
 
436
+ #: includes/options-general.php:249
437
  msgid "Performance"
438
  msgstr ""
439
 
440
+ #: includes/options-general.php:253
441
  msgid "Embed Cache"
442
  msgstr ""
443
 
444
+ #: includes/options-general.php:254
445
  msgid "How many hours to retain embed output. 0 to switch off"
446
  msgstr ""
447
 
448
+ #: includes/options-general.php:258
449
  msgid "Video Information Cache"
450
  msgstr ""
451
 
452
+ #: includes/options-general.php:259
453
  msgid ""
454
  "How many hours to retain video information, including it's validity. 0 to "
455
  "switch off"
456
  msgstr ""
457
 
458
+ #: includes/options-general.php:263
459
  msgid "Transcript Cache"
460
  msgstr ""
461
 
462
+ #: includes/options-general.php:264
463
  msgid "How many hours to store transcripts for in cache. 0 to switch off"
464
  msgstr ""
465
 
466
+ #: includes/options-general.php:268
467
+ msgid "Comments Cache"
468
+ msgstr ""
469
+
470
+ #: includes/options-general.php:269
471
+ msgid "How many minutes to store video comments for in cache. 0 to switch off"
472
+ msgstr ""
473
+
474
+ #: includes/options-general.php:279
475
  msgid "You currently have cache for"
476
  msgstr ""
477
 
478
+ #: includes/options-general.php:279
479
  msgid "and"
480
  msgstr ""
481
 
482
+ #: includes/options-general.php:283
483
  msgid "Clear Cache"
484
  msgstr ""
485
 
486
+ #: includes/options-general.php:284
487
  msgid "Select this option to remove all YouTube Embed cache."
488
  msgstr ""
489
 
490
+ #: includes/options-general.php:287
491
  msgid "YouTube API"
492
  msgstr ""
493
 
494
+ #: includes/options-general.php:289
495
  msgid ""
496
  "The YouTube API is used to validate video IDs and to determine if it is a "
497
  "video or playlist."
498
  msgstr ""
499
 
500
+ #: includes/options-general.php:293
501
  msgid "API State"
502
  msgstr ""
503
 
504
+ #: includes/options-general.php:295
505
  msgid "API should not be used"
506
  msgstr ""
507
 
508
+ #: includes/options-general.php:296
509
  msgid "HTTP API used and errors are reported"
510
  msgstr ""
511
 
512
+ #: includes/options-general.php:297
513
  msgid "HTTPS API used and errors are reported"
514
  msgstr ""
515
 
516
+ #: includes/options-general.php:298
517
  msgid "HTTP API used and no errors are reported"
518
  msgstr ""
519
 
520
+ #: includes/options-general.php:299
521
  msgid "HTTPS API used and no errors are reported"
522
  msgstr ""
523
 
524
+ #: includes/options-general.php:304
525
  msgid "Error Reporting"
526
  msgstr ""
527
 
528
+ #: includes/options-general.php:306
529
  msgid ""
530
  "Playback errors are within the XHTML source code as comments - parameter "
531
  "errors and other types are displayed on the post output."
532
  msgstr ""
533
 
534
+ #: includes/options-general.php:309
535
  msgid "Video Playback Error Message"
536
  msgstr ""
537
 
538
+ #: includes/options-general.php:310
539
  msgid "This is the message that will be shown on the post"
540
  msgstr ""
541
 
542
+ #: includes/options-general.php:313
543
  msgid "Security"
544
  msgstr ""
545
 
546
+ #: includes/options-general.php:318
547
  msgid "Privacy-Enhanced Mode"
548
  msgstr ""
549
 
550
+ #: includes/options-general.php:320
551
  msgid "Cookies should always be stored"
552
  msgstr ""
553
 
554
+ #: includes/options-general.php:321
555
  msgid "Cookies should never be stored"
556
  msgstr ""
557
 
558
+ #: includes/options-general.php:322
559
  msgid "Cookies should be stored based on user's Do Not Track setting"
560
  msgstr ""
561
 
562
+ #: includes/options-general.php:323
563
  msgid "Read more about <a href=\"http://donottrack.us/\">Do Not Track</a>"
564
  msgstr ""
565
 
566
+ #: includes/options-general.php:326
567
  msgid "Compatibility"
568
  msgstr ""
569
 
570
+ #: includes/options-general.php:329
571
  msgid "Allow Frame Border on IFRAME"
572
  msgstr ""
573
 
574
+ #: includes/options-general.php:330
575
  msgid "FRAMEBORDER is not HTML5 compliant"
576
  msgstr ""
577
 
578
+ #: includes/options-general.php:335 includes/options-lists.php:119
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
579
  #: includes/options-profiles.php:395
580
  msgid "Save Settings"
581
  msgstr ""
1220
  msgid "An error occurred accessing the YouTube API for video ID %s - %s"
1221
  msgstr ""
1222
 
1223
+ #: includes/shared-functions.php:530
1224
  msgid "View on YouTube"
1225
  msgstr ""
readme.txt CHANGED
@@ -1,76 +1,352 @@
1
- === Vixy YouTube Embed and Download ===
2
- Contributors: Applian
3
- Tags: admin, annotations, applian, artiss, automatic, comments, download, editor, embed, embedding, embedplus, flash, flv, google, hd, height, iframe, manage, media, plugin, page, play, playlist, post, profile, responsive, search, seo, sidebar, simple, smart, url, user, valid, video, vixy, widget, width, xhtml, youtube, youtuber
 
4
  Requires at least: 2.9
5
- Tested up to: 3.9.1
6
- Stable tag: 3.2
7
 
8
- A simple method of embedding YouTube videos (with download links) into your pages. Easy to use, but with powerful features for those that need them.
9
 
10
  == Description ==
11
 
12
- Vixy YouTube Embed and Download is a simple, powerful method of embedding YouTube videos, offering your readers an easy way to download videos.
13
 
14
- Check out the [Vixy plugin video](http://www.youtube.com/watch?v=dsarVsN7SIE):
15
-
16
- http://www.youtube.com/watch?v=dsarVsN7SIE&hd=1
17
-
18
- **Easy to Use**
19
-
20
- Just add a shortcode with the YouTube video ID, and your video appears in the page. The shortcode looks like this:
21
-
22
- `[youtube]adVEYkQIxCg[/youtube]`
23
-
24
- **Important Setup**
25
-
26
- WordPress requires you to opt-in to the video download feature.
27
-
28
- 1. Go to the **Profile** section under the YouTube sidebar option in your WordPress Admin.
29
- 2. Tick the **Show Download Links** option under **Options for All Player Types**.
30
-
31
- **Powerful**
32
-
33
- With over 50 embedding options, Vixy YouTube Embed does everything any other WordPress plug-in does, and a lot of things they don't.
34
-
35
- Options include:
36
-
37
- * Set size of video, controls, other behaviors via profiles or inline commands.
38
- * Includes download links option.
39
- * Build your own playlists and play them back however you want
40
  * XHTML and HTML5 compliant - works with all the latest browsers
41
  * Multiple embedding methods available - OBJECT, IFRAME, CHROMELESS and EmbedPlus
42
  * Dynamic video sizing for responsive sites
43
  * Allow users to add videos to comments
 
44
  * Automatically generate playlists based on user name or search text
45
  * Create multiple profiles - use them for different videos to get the exact style that you want
46
  * Google compatible metadata is added to the video output - great for SEO!
47
  * Code is cached for maximum performance
48
- * Using a different YouTube plugin? Documentation and tools are provided to help you migrate to Vixy YouTube Embed
49
- * Fully internationalized ready for translations. **If you would like to add a translation to his plugin then please [contact us](http://wordpress.org/support/plugin/youtube-embed "YouTube Embed Support")**
50
  * Support for Do Not Track
51
- * Display video comments
52
  * Compatible with [Video SEO for WordPress](http://yoast.com/wordpress/video-seo/ "Video SEO for WordPress")
53
  * And much, much more!
54
 
55
- **Earn Money**
56
-
57
- Download links under each video gives you an opportunity to earn generous affiliate commissions from [Jaksta.com]("http://jaksta.com" Jaksta.com), a powerful video download and conversion suite for PC and Mac. (Optional).
58
-
59
- Vixy YouTube Embed has been rated 5/5 by [ThemesPlugins.com](http://www.themesplugins.com/wordpress-Plugin/useful-free-wordpress-plugin-youtube-videos-adjust-hide-link/ "Artiss YouTube Embed").
60
-
61
- **Get Started Quickly**
62
 
63
  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.
64
 
65
  Within the administration area of your blog you will find a new menu named `YouTube` (see screenshot 1). Click on the `Options` sub-menu to set a number of general options. Alternatively 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.
66
 
67
- You can read read the [Full Documentation](http://vixy.net/youtube-embed/documentation.php "Documentation") to learn about all the capabilities of Vixy YouTube Embed. This also includes details on how to migrate from another embedding plugin.
68
 
69
- Help is always available from the WordPress administration pages - just click on the "Help" button in the top right. If the Help and FAQ don't have an answer, ask us [on the forum](http://wordpress.org/support/plugin/youtube-embed "WordPress.org Forum").
70
 
71
  Not yet convinced? [See the feature comparison](https://spreadsheets.google.com/spreadsheet/pub?hl=en_GB&hl=en_GB&key=0AqxzQNe7e-NwdF80eUZuNjdtS1J1bWM4VERFVUN6ZHc&single=true&gid=4&output=html "YouTube Embed : Comparison") between this and the top 10 alternative plugins for embedding YouTube videos.
72
 
73
- [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.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
74
 
75
  [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.
76
 
@@ -82,24 +358,119 @@ Not yet convinced? [See the feature comparison](https://spreadsheets.google.com/
82
 
83
  == Installation ==
84
 
85
- Vixy YouTube Embed is easy to install:
 
 
86
 
87
- 1. Download the ZIP file containing the plug-in code.
88
- 2. Unzip, and upload the entire youtube-embed folder to your wp-content/plugins/ directory.
89
- 3. Activate the plug-in through the Plugins menu in WordPress.
90
- 4. Make sure to enable the video download option. Go to the plug-in settings, and check "Enable Download Links".
91
 
92
- That's it, you're done - you just need to add the shortcode wherever you need.
93
 
94
- Note: If you're updating from version 2.0.1 or before, please read the FAQ on backwards compatibility.
95
 
96
- == Frequently Asked Questions ==
 
 
97
 
98
- A full list of FAQs can be found [on the Vixy.net website](http://vixy.net/youtube-embed/faq.php "FAQ").
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
99
 
100
  == Screenshots ==
101
 
102
- 1. Vixy YouTube Embed in the administration menu
103
  2. The main options screen
104
  3. The profiles screen
105
  4. The lists screen - videos have been added and validated. The drop-down help is also shown
@@ -108,6 +479,10 @@ A full list of FAQs can be found [on the Vixy.net website](http://vixy.net/youtu
108
 
109
  == Changelog ==
110
 
 
 
 
 
111
  = 3.2 =
112
  * Bug: Prevented download bar SPAN from appearing even when switched off
113
  * Bug: Fixed issue that caused playlists to not appear
@@ -379,6 +754,9 @@ A full list of FAQs can be found [on the Vixy.net website](http://vixy.net/youtu
379
 
380
  == Upgrade Notice ==
381
 
 
 
 
382
  = 3.2 =
383
  * Update to add new features, including the ability to show a video's comments
384
 
1
+ === YouTube Embed ===
2
+ Contributors: dartiss
3
+ Donate link: http://artiss.co.uk/donate
4
+ Tags: admin, annotations, artiss, automatic, comments, download, editor, embed, embedding, embedplus, flash, flv, google, hd, height, iframe, manage, media, plugin, page, play, playlist, post, profile, responsive, search, seo, sidebar, simple, smart, url, user, valid, video, widget, width, xhtml, youtube, youtuber
5
  Requires at least: 2.9
6
+ Tested up to: 4.1.1
7
+ Stable tag: 3.2.1
8
 
9
+ A simple to use method of embedding YouTube videos into your posts and pages but with powerful features for those that need them.
10
 
11
  == Description ==
12
 
13
+ YouTube Embed is an incredibly simple, yet powerful, method of embedding YouTube videos into your WordPress site. Options include:
14
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
15
  * XHTML and HTML5 compliant - works with all the latest browsers
16
  * Multiple embedding methods available - OBJECT, IFRAME, CHROMELESS and EmbedPlus
17
  * Dynamic video sizing for responsive sites
18
  * Allow users to add videos to comments
19
+ * Build your own playlists and play them back however you want
20
  * Automatically generate playlists based on user name or search text
21
  * Create multiple profiles - use them for different videos to get the exact style that you want
22
  * Google compatible metadata is added to the video output - great for SEO!
23
  * Code is cached for maximum performance
24
+ * Using a different YouTube plugin? Documentation and tools are provided to help you migrate to YouTube Embed
25
+ * Fully internationalized ready for translations. **If you would like to add a translation to his plugin then please [contact me](http://www.artiss.co.uk/plugin-contact "Contact")**
26
  * Support for Do Not Track
 
27
  * Compatible with [Video SEO for WordPress](http://yoast.com/wordpress/video-seo/ "Video SEO for WordPress")
28
  * And much, much more!
29
 
30
+ It has all the features of other similar plugins - Smart YouTube, for instance. In fact if there's a feature in another YouTube embedding plugin that this doesn't have, let me know - I haven't come across it!
 
 
 
 
 
 
31
 
32
  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.
33
 
34
  Within the administration area of your blog you will find a new menu named `YouTube` (see screenshot 1). Click on the `Options` sub-menu to set a number of general options. Alternatively 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.
35
 
36
+ The above should get you started - for more information and advanced options please read the "Other Notes" tab. This also includes details on how to migrate from another embedding plugin to YouTube Embed.
37
 
38
+ 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").
39
 
40
  Not yet convinced? [See the feature comparison](https://spreadsheets.google.com/spreadsheet/pub?hl=en_GB&hl=en_GB&key=0AqxzQNe7e-NwdF80eUZuNjdtS1J1bWM4VERFVUN6ZHc&single=true&gid=4&output=html "YouTube Embed : Comparison") between this and the top 10 alternative plugins for embedding YouTube videos.
41
 
42
+ **For help with this plugin, or simply to comment or get in touch, please read the appropriate section in "Other Notes" for details. This plugin, and all support, is supplied for free, but [donations](http://artiss.co.uk/donate "Donate") are always welcome.**
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 - you can specify any of them but, depending on the type, they may be ignored. There are 3 types - OBJECT, IFRAME and EmbedPlus. IFRAME is the current YouTube default and will use HTML 5, if available - this makes it ideal for maximum compatibility. However, HTML5 has a number of features that's not available with the standard Flash player.
51
+
52
+ The following parameters work with all embed types:
53
+
54
+ * **audio** - yes or no, this will hide the video and display just the toolbar (ideal for audio only playback) if switched on
55
+ * **autoplay** - yes or no, should the video automatically start playing?
56
+ * **dynamic** - whether to use dynamic sizing 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.
57
+ * **height** - the video height, in pixels
58
+ * **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)
59
+ * **profile** - specify a different default profile (see section on Profiles for further details)
60
+ * **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
61
+ * **ssl** - Use SSL or not? Basically, if set on the URL will be HTTPS rather than HTTP.
62
+ * **start** - a number of seconds from where to start the video playing
63
+ * **style** - apply CSS elements directly to the video output
64
+ * **template** - specify a template (see section on Templates for further details)
65
+ * **type** - which embedding type to use, this can be `embedplus`, `iframe`, `object` or `chromeless`
66
+ * **width** - the video width, in pixels
67
+ * **vq** - the video quality that you'd like - see the seperate section below for further details about this
68
+
69
+ The following parameters will not work with EmbedPlus:
70
+
71
+ * **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.
72
+ * **color** - white or red, the colour of the progress bar (see the FAQ about having a white progress bar with the light theme)
73
+ * **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.
74
+ * **https** - yes or no, whether to use HTTPS for the video
75
+ * **info** - yes or no, show video information. If displaying a playlist this will show video thumbnails
76
+ * **loop** - yes or no, whether to start the video again once it ends
77
+ * **related** - yes or no, show related videos
78
+ * **theme** - dark or light, display player controls (like a 'play' button or volume control) within a dark or light control bar
79
+
80
+ The following parameters will not work with EmbedPlus or if IFRAME uses HTML5:
81
+
82
+ * **annotation** - yes or no, this determines if annotations are shown
83
+ * **cc** - yes or no, decided whether closed captions (subtitles) are displayed
84
+ * **disablekb** - yes or no, disable keyboard controls
85
+ * **fullscreen** - yes or no, this will add the fullscreen button to the toolbar. This also works with EmbedPlus.
86
+ * **link** - yes or no, link video to YouTube
87
+ * **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
88
+ * **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
89
+
90
+ The following parameters will not work if IFRAME uses HTML5:
91
+
92
+ * **stop** - this stops the video at a specific time, given in seconds
93
+
94
+ The following parameters are only for use with EmbedPlus:
95
+
96
+ * **hd** - play the video in HD quality, if available
97
+ * **react** - yes or no, this specified whether you wish to show the Real-time Reactions button
98
+ * **sweetspot** - yes or no, this will find sweet spots for the next/prev buttons
99
+
100
+ == Alternative Shortcodes ==
101
+
102
+ Within administration, selecting `Options` from the `YouTube` menu will provide a list of general options. One section is named `Alternative Shortcodes` and allows you to specify 1 or 2 additional shortcodes - these will work exactly the same as the standard shortcode of `[youtube]`.
103
+
104
+ There are 2 reasons why you might want to do this...
105
+
106
+ 1. If migrating from another plugin, it may use a different shortcode - more details can be found in the section named "Migration"
107
+ 2. If another plugin uses the same shortcode (e.g. Jetpack) this will allow you to specify and use an alternative
108
+
109
+ Each of the new shortcodes can also have their own default profile assigned to them (see the Profiles section for more details on this).
110
+
111
+ == Function Call ==
112
+
113
+ As well as a shortcode you can also use a PHP function call to display a video (e.g. in a sidebar). The function is named `youtube_video_embed` and has 2 parameters - the first is the video ID (or URL) and the second is a list of display parameters. The display parameters are the same as those used in the shortcode but are separated by an ampersand.
114
+
115
+ e.g. `youtube_video_embed( 'Z_sCoHGIpU0', 'width=300&height=200' )`
116
+
117
+ == Widgets ==
118
+
119
+ Sidebar 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 default profile.
120
+
121
+ 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.
122
+
123
+ And that's it! You can use unlimited widgets, so you can add different videos to different sidebars.
124
+
125
+ == Playlists ==
126
+
127
+ YouTube allows users to create their own playlists - collections of videos that can be played in sequence.
128
+
129
+ Before version 2 of YouTube Embed, separate shortcodes and function calls had to be used to specify these. However, now you can simply specify their ID or URL with the standard methods.
130
+
131
+ e.g. `[youtube]095393D5B42B2266[/youtube]`
132
+
133
+ Playlists cannot be used along with the EmbedPlus embedding method.
134
+
135
+ A better alternative to playlists is the build-in lists function in YouTube Embed - see the Lists section for further details.
136
+
137
+ == Video Quality ==
138
+
139
+ A parameter of `vq` can be used against a video to force a specific resolution (rather than the most appropriate being used).
140
+
141
+ **Note: This option is not officially supported by YouTube so should be considered as experimental**
142
+
143
+ The following parameters are possible...
144
+
145
+ `small` - 240p
146
+ `medium` - 360p
147
+ `large` - 480p
148
+ `hd720` - 720p
149
+ `hd1080` - 1080p
150
+
151
+ A default video quality can also be specified within the profiles screen.
152
+
153
+ == Templates ==
154
+
155
+ 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.
156
+
157
+ The template consists simply of any HTML that you wish but with `%video%` where you wish the video to appear.
158
+
159
+ e.g. `<div align="center">%video%</div>`
160
+
161
+ 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.
162
+
163
+ == Profiles ==
164
+
165
+ You've probably already had a look at the default profile, accessible by selecting `Profiles` from the `YouTube` administration menu option. Here you can specify the default option which will apply to any embedded video.
166
+
167
+ 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.
168
+
169
+ 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.
170
+
171
+ 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).
172
+
173
+ By default you have 5 extra profiles - if you wish to have more (or less) this number can be changed from the `Options` sub-menu.
174
+
175
+ == Lists ==
176
+
177
+ Although this plugin will play standard YouTube playlists their playback options are limited. Instead you can create your own video lists. Under the `YouTube` 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.
178
+
179
+ When saving the list each video is validated.
180
+
181
+ 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.
182
+
183
+ To use a list, simply specify the list name or number instead of a video ID.
184
+
185
+ e.g. `[youtube]List 1[/youtube]`
186
+
187
+ There is also a parameter, named `list`, that lets you modify the playback of the list. You can either play each in turn, play them randomly, or have just one played (but picked randomly).
188
+
189
+ == Transcripts ==
190
+
191
+ Some YouTube videos include transcripts - this is a text output of the speech from the video with timings added. These are available in XML format and can, via a function call or shortcode, be displayed in your post.
192
+
193
+ The shortcode `transcript` will display the transcript in your post along with the start time for each line. Simply supply the video ID as a parameter.
194
+
195
+ e.g. `[transcript]MSPsrhCPt-0[/transcript]`
196
+
197
+ If no transcript exists, nothing will be output.
198
+
199
+ There is an additional parameter of `LANGUAGE` which can be used to specify an alternative transcript language (the default is EN).
200
+
201
+ e.g. `[transcript language='DE']MSPsrhCPt-0[/transcript]`
202
+
203
+ For style purposes, the `SPAN` around the time has a class of `TranscriptTime`, the `SPAN` around the text has a class of `TranscriptText` and the `DIV` around the whole transcript output has a class of `Transcript`.
204
+
205
+ If you wish to use a PHP function call to get the transcript, then you would use the format `get_youtube_transcript( ID )`, where ID is the video ID.
206
+
207
+ In all of these cases, the original XML format has been changed to a readable output. If, though, you'd like to return the original XML format, then you can use the call `get_youtube_transcript_xml( ID )`.
208
+
209
+ == Automatically Generate Playlists ==
210
+
211
+ YouTube now includes options to automatically generate playlists based upon a user name or a search name.
212
+
213
+ 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).
214
+
215
+ == Migration ==
216
+
217
+ Within administration, selecting `Options` from the `YouTube` menu will provide a list of general options. One section is named `Migration`. There are 2 boxes that can be ticked to activate 2 different types of alternative embedding - these have been provided to allow easy migration from other similar plugins. You can also assign a specific profile to these migrated options.
218
+
219
+ The first option, `Bracket Embedding`, allows YouTube IDs to be assigned within brackets - similar to shortcodes but without the actual shortcode name. e.g. `[http://www.youtube.com/watch?v=Z_sCoHGIpU0]`.
220
+
221
+ The second option, `Alternative Embedding`, activates a short of other alternative embedding methods.
222
+
223
+ In both cases, activating these will impact performance so should only be used if absolutely necessary.
224
+
225
+ [Read more details](http://www.artiss.co.uk/youtube-embed-compatibility "YouTube Embed Compatibility") on which options to select for which plugin.
226
+
227
+ == Further options ==
228
+
229
+ **Thumbnails**
230
+
231
+ 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.
232
+
233
+ Use the function call `youtube_thumb_embed( 'id', 'paras', '', 'alt', 'nolink' )` to add a thumbnail to any part of your theme.
234
+
235
+ 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.
236
+
237
+ The parameters are different, however, but, again, are separated by ampersand.
238
+
239
+ The parameters are as follows...
240
+
241
+ * **rel** - specify a REL override, e.g. rel="nofollow"
242
+ * **target** - specify a TARGET override, e.g. target="_blank"
243
+ * **width** - this specifies the width of the thumbnail image
244
+ * **height** - this specifies the height of the thumbnail image
245
+ * **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
246
+
247
+ e.g. `youtube_thumb_embed( 'id', 'rel=nofollow&target=_blank', '', 'Demo Video' )`
248
+
249
+ 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.
250
+
251
+ 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...
252
+
253
+ * **alt** - specify some `ALT` text for the thumbnail image
254
+
255
+ e.g. `[youtube_thumb target="_blank" alt="Demo video"]id[/youtube_thumb]`
256
+
257
+ This overrides the `TARGET` and `ALT` elements of the thumbnail.
258
+
259
+ You can also use `nolink` as a parameter with the shortcode, which works in the same way as with the function call.
260
+
261
+ **Video name**
262
+
263
+ You can retrieve the name of a video via 1 of 2 methods.
264
+
265
+ You can call the PHP function `get_youtube_name`, passing it to the video URL or ID - this will return the name of the video.
266
+
267
+ e.g. `echo get_youtube_name( 'Z_sCoHGIpU0' );`
268
+
269
+ Alternatively, you can use the shortcode `[youtube_name]`, again passing the video URL or ID. The video name will be displayed.
270
+
271
+ e.g. `[youtube_name]Z_sCoHGIpU0[/youtube_name]`
272
+
273
+ **Shortened URL**
274
+
275
+ You may return a short URL for any YouTube video by way of either a function call or a shortcode.
276
+
277
+ 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.
278
+
279
+ e.g. `<a href="<?php echo youtube_short_url( 'Z_sCoHGIpU0' ); ?>"Click here for video</a>`
280
+
281
+ This will create a link to a video using the short URL standard.
282
+
283
+ 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.
284
+
285
+ **Downloading Videos**
286
+
287
+ 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.
288
+
289
+ 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.
290
+
291
+ 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.
292
+
293
+ e.g. `<a href="<?php echo get_video_download( 'Z_sCoHGIpU0' ); ?>">Download the video</a>`
294
+
295
+ 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...
296
+
297
+ * **id** - The ID of the video or playlist. This is required.
298
+ * **target** - The target of the link (e.g. `_blank`). This is optional.
299
+ * **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.
300
+
301
+ e.g. `[download_video id="Z_sCoHGIpU0" target="_blank"]Download the video[/download_video]`
302
+
303
+ **YouTube Comments**
304
+
305
+ A shortcode allows you to display any YouTube comments for a video, which will appear in published order.
306
+
307
+ Simply use [youtube_comments] with, as usual, the video ID to embed the comments on your post or page. For example...
308
+
309
+ [youtube_comments]adVEYkQIxCg[youtube_comments]
310
+ There are 3 optional parameters that can be specified too...
311
+
312
+ avatar - the size of the avatars displayed. Defaults to 32.
313
+ limit - the number of comments to display. Default to 10.
314
+ cache - how long to cache comments for, in minutes. Uses default in settings screen if not specified
315
+ The comments will use your site's default styling by default but all output has it's own CLASS, allowing you to re-style yourself using CSS.
316
+
317
+ **Caching**
318
+
319
+ Caches are used to improve plugin performance. Under the `YouTube` administration menu is a sub-menu named `Options`. Select this and find the section named `Performance`. From here there are 3 cache options...
320
+
321
+ 1. Embed Cache - this is how long to store the resulting cache code. It will update if you change any parameters so, theoretically, shouldn't need to change. It defaults to 24 hours.
322
+ 2. Video Information Cache - video IDs are checked with YouTube to ensure that they're valid. This option lets you to specify how often this should be checked. This defaults to 1 hour.
323
+ 3. Transcript Cache - how long to store transcripts. Defaults to 24 hours.
324
+
325
+ In all cases putting the cache to 0 will switch off caching for that option.
326
+
327
+ **Further Embedding Options**
328
+
329
+ Under the `YouTube` administration menu is a sub-menu named `Options`. Select this and find the section named `Embedding`. There are 3 options here...
330
+
331
+ 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).
332
+ 2. Comment Embedding - tick this to allow YouTube URLs added to comments to be converted to embedded videos.
333
+ 3. 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.
334
+
335
+ In the case of URL and Comment embedding a profile can be selected.
336
+
337
+ == Licence ==
338
+
339
+ This WordPress plugin is licensed under the [GPLv2 (or later)](http://wordpress.org/about/gpl/ "GNU General Public License").
340
+
341
+ == Support ==
342
+
343
+ For problems, suggestions or enhancements for this plugin, please use the [WordPress forum](https://wordpress.org/support/plugin/youtube-embed "WordPress Plugins Forum").
344
+
345
+ **This plugin, and all support, is supplied for free, but [donations](http://artiss.co.uk/donate "Donate") are always welcome.**
346
+
347
+ == Reviews & Mentions ==
348
+
349
+ [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.
350
 
351
  [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.
352
 
358
 
359
  == Installation ==
360
 
361
+ 1. Upload the entire `youtube-embed` folder to your wp-content/plugins/ directory.
362
+ 2. Activate the plugin through the 'Plugins' menu in WordPress.
363
+ 3. That's it, you're done - you just need to add the shortcode wherever you need.
364
 
365
+ == Frequently Asked Questions ==
 
 
 
366
 
367
+ = How do I find the ID of a YouTube video? =
368
 
369
+ 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`.
370
 
371
+ The video ID is the list of letters and numbers after `v=`, in this case `L5Y4qzc_JTg`.
372
+
373
+ = When trying to display a video it says "An error occurred accessing the YouTube API" =
374
 
375
+ This has been reported by a number of users - for some reason some people are unable to access the YouTube API, which is used by this plugin to determine the video type and whether it's valid or not. If you are one of them then simply go to the `Options` screen within the `YouTube Embed` administration menu and, near the bottom, there is an option to stop reporting API errors.
376
+
377
+ If you switch off API errors then the plugin will simply assume all IDs are valid and work out the type from the ID length (which is not set, so if this changes in future it may cause problems!).
378
+
379
+ I have requested further information on why these errors may be occurring from the YouTube forum but, as yet, I've had no response. [Click here](http://groups.google.com/group/youtube-api-gdata/browse_thread/thread/764f2f2a3b5863f8?hl=en "YouTube APIs Developer Forum") if you wish to track the request.
380
+
381
+ = So if I upgrade to this from an earlier version is it compatible? =
382
+
383
+ It should be, yes, but with one exception.
384
+
385
+ If you have upgraded from version 2.0.1 or before and used the `style` parameter then it may cause some problems. This is because the `style` parameter now affects the CSS of the video. Before, it added a DIV "wrapper" around the video and applied the styles to this.
386
+
387
+ Therefore, if you used the `style` parameter to centre a video this probably doesn't now work. However, you can do this now by using the `template` parameter instead - please read the section on that for further help.
388
+
389
+ However, with the change to the way the `style` works you can now apply more direct styling to the video - e.g. adding a border.
390
+
391
+ = Is the generated code standards compliant? =
392
+
393
+ In all cases, yes. However, it depends on which options you choose as to which DOCTYPE it will validate to.
394
+
395
+ IFRAME does not work with XHTML so will only validate as XHTML transitional (this includes if you use IFRAME as the fallback to EmbedPlus).
396
+
397
+ If you include Metadata then you must use the XHTML Strict + RDFa DOCTYPE - in this case it validates.
398
+
399
+ If you don't include Metadata then it will also validate as HTML5 compliant.
400
+
401
+ The [W3C Markup Validation Service](http://validator.w3.org/ "W3C Markup Validation Service") was used to test the above.
402
+
403
+ You can [read more about this here](http://www.artiss.co.uk/youtube-embed-help#ye-standards "Standards Compliance").
404
+
405
+ = Which browsers does the output work on? =
406
+
407
+ It uses standard OBJECT and IFRAME coding - this, along with the above standards compliance, means that the output should work on most browsers.
408
+
409
+ = The video output is overlapping or stuttering =
410
+
411
+ 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".
412
+
413
+ = No video is showing =
414
+
415
+ If you find no video is showing but there's no error either check the source code of the page. Can you find the text "<!--YouTube Error: bad URL entered-->" in the page? If so, you have Jetpack installed and that is displaying the video instead.
416
+
417
+ There are two ways around this.
418
+
419
+ First, you could disable all the shortcodes in Jetpack - Jetpack allows you to deactivate certain "modules" of the plugin and, if you can live without the other extra shortcodes, deactivating the shortcodes part will restore functionality back to YouTube Embed
420
+
421
+ Alternatively, you can use a secondary shortcode - [youtube_video]. Use this instead of [youtube] and YouTube Embed will render the results without a problem
422
+
423
+ This second suggestion will work for any plugin that may use the same shortcode.
424
+
425
+ = There used to be an option to allow the plugin to work with YouTube URLs. Where did it go? =
426
+
427
+ WordPress will, by default, convert YouTube URLs to videos using a very basic default configuration. Earlier versions of this plugin had an option to override this so this plugin would output the results instead (giving you full control of the output). Unfortunately, it stopped working and I do not have enough knowledge on the required WordPress code to work out how to fix it. Rather than leave broken code in place I have removed it.
428
+
429
+ If you wish to have full control over your YouTube output I would suggest placing all YouTube URLs within [youtube] shortcodes.
430
+
431
+ = My OPTIONS table seems to be full of cache entries for YouTube Embed =
432
+
433
+ Due to a housekeeping limitation in WordPress cache entries, which are stored in the OPTIONS table, may get left behind. There are 2 solutions to clearing this.
434
+
435
+ First of all, in the Options menu in YouTube Embed administration, there is an option in the performance section named "Clear Cache". Simply tick this box and click on the "Save Settings" button to clear out any cache.
436
+
437
+ However, the best option is to install the plugin [Artiss Transient Cleaner](http://wordpress.org/extend/plugins/artiss-transient-cleaner/ "Artiss Transient Cleaner"), which will housekeep the OPTIONS table automatically.
438
+
439
+ = Is this plugin compatible with Turn Off The Lights? =
440
+
441
+ If you display the video responsively then it doesn't work with [Turn Off The Lights](http://www.stefanvd.net/project/turnoffthelights.htm "Turn Off The Lights"). Switch this option off and it will.
442
+
443
+ I've raised this with the developer of Turn Off The Lights and he is going to implement a change in the future to improve compatibility with responsive video.
444
+
445
+ = I get the message "Blocked plug-in" in Safari =
446
+
447
+ Your version of Flash is out-of-date and needs updating.
448
+
449
+ = The "autostart" feature is not working in iOS =
450
+
451
+ Unfortunately, this is a restriction that has been put in place by Apple.
452
+
453
+ = I cannot get the video to start at a specific point in iOS =
454
+
455
+ This is a [known issue](https://code.google.com/p/gdata-issues/issues/detail?id=2937 "start position problem on iOS Mobile Safari") with the YouTube player and is with Google to fix.
456
+
457
+ = I can't get the video to play at a specific resolution by default =
458
+
459
+ There is no way to specify this - YouTube makes the decision on which version to play depending on a number of factors. The old version of their player had an "HD" option but that too didn't guarantee HD playback.
460
+
461
+ = I have another issue or a request =
462
+
463
+ 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.
464
+
465
+ = Which version of PHP does this plugin work with? =
466
+
467
+ It has been syntax checked as PHP 4. However, this does not guarantee PHP 4 compatibility and the minimum for WordPress is now PHP 5.2.4.
468
+
469
+ Although I attempt to keep with PHP 4 compatibility there are no guarantees of this.
470
 
471
  == Screenshots ==
472
 
473
+ 1. YouTube Embed in the administration menu
474
  2. The main options screen
475
  3. The profiles screen
476
  4. The lists screen - videos have been added and validated. The drop-down help is also shown
479
 
480
  == Changelog ==
481
 
482
+ = 3.2.1 =
483
+ * Bug: Fixed issue where playlist was appearing for single videos
484
+ * Maintenance: Improved Metadata standard
485
+
486
  = 3.2 =
487
  * Bug: Prevented download bar SPAN from appearing even when switched off
488
  * Bug: Fixed issue that caused playlists to not appear
754
 
755
  == Upgrade Notice ==
756
 
757
+ = 3.2.1 =
758
+ * Update to bring metadata up to latest standards and to fix playlist issue
759
+
760
  = 3.2 =
761
  * Update to add new features, including the ability to show a video's comments
762
 
screenshot-2.png CHANGED
Binary file
screenshot-3.png CHANGED
Binary file
screenshot-4.png CHANGED
Binary file
screenshot-5.png CHANGED
Binary file
youtube-embed.php CHANGED
@@ -3,7 +3,7 @@
3
  Plugin Name: Vixy YouTube Embed
4
  Plugin URI: http://vixy.net/youtube-embed
5
  Description: Embed YouTube Videos in WordPress
6
- Version: 3.2
7
  Author: Applian Technologies Inc.
8
  Author URI: http://www.applian.com
9
  */
@@ -17,7 +17,7 @@ Author URI: http://www.applian.com
17
  * @since 2.0
18
  */
19
 
20
- define( 'youtube_embed_version', '3.2' );
21
 
22
  $functions_dir = WP_PLUGIN_DIR . '/youtube-embed/includes/';
23
 
3
  Plugin Name: Vixy YouTube Embed
4
  Plugin URI: http://vixy.net/youtube-embed
5
  Description: Embed YouTube Videos in WordPress
6
+ Version: 3.2.1
7
  Author: Applian Technologies Inc.
8
  Author URI: http://www.applian.com
9
  */
17
  * @since 2.0
18
  */
19
 
20
+ define( 'youtube_embed_version', '3.2.1' );
21
 
22
  $functions_dir = WP_PLUGIN_DIR . '/youtube-embed/includes/';
23