PluginProbe
Embed Plus for YouTube Gallery, Livestream and Lazy Loading with Facades / 10.1
Embed Plus for YouTube Gallery, Livestream and Lazy Loading with Facades v10.1
trunk 1.0 1.1 10.0 10.1 10.2 10.3 10.4 10.5 10.6 10.7 10.8 10.9 11.0 11.0.1 11.1 11.2 11.3 11.3.1 11.4 11.5 11.6 11.7 11.7.1 11.8 All 143 releases
youtube-embed-plus / readme.txt

readme.txt in Embed Plus for YouTube Gallery, Livestream and Lazy Loading with Facades 10.1, at readme.txt

335 lines 21.1 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === YouTube ===
2 Contributors: embedplus
3 Plugin Name: YouTube Embed
4 Tags: accessibility, analytics, api, blocked youtube videos, cache, caching, channel, deleted youtube videos, effects, embed youtube, embedding youtube, featured image, get_locale, i18n, internationalization, l10n, language, lazy, lazy load, load, locale, localization, mobile, mute, no-cookie, oembed, page load, page speed, playlist, playlists, plugin, Reddit, responsive, rich snippets, origin, screen reader, secure, security, seo, short code, shortcode, sidebar, special effects, ssl, subtitles, thumbnail, thumbnail image, thumbnails, TinyMCE, translate, translator, video, video analytics, video plugin, video seo, video shortcode, video thumbnails, view count, volume, widget, wordpress security, wordpress youtube embed, xss, youtube, youtube api, youtube analytics, youtube embed, youtube impressions, youtube player, youtube playlist, youtube plugin, youtube shortcode, youtube snippets, youtube takedowns, youtube thumbnails, youtube plugin migration
5 Requires at least: 3.1
6 Tested up to: 4.2
7 Stable tag: 10.1
8 License: GPLv3 or later
9
10 YouTube embed plugin. Embed responsive YouTube video players & playlists in posts & widgets. Add video thumbnails, analytics, SEO, caching...
11
12 == Description ==
13
14 **Here are a few recently added features (even more features below):**
15
16 * Improved accessibility by using title attributes for screen reader support. It should help your site [pass functional accessibility evaluations (FAE)](https://www.youtube.com/watch?v=gpAiFnYYkbk).
17 * Site origin information with each embed code as an extra security measure. In YouTube's/Google's own words, checking this option "protects against malicious third-party JavaScript being injected into your page and hijacking control of your YouTube player." We especially recommend checking it as it adds higher security than the built-in YouTube embedding method that comes with the current version of WordPress (i.e. oembed).
18 * Easy "Insert" button for both the Visual and Text mode of the editor
19 * [Embed an entire channel as a playlist >>](https://www.youtube.com/watch?v=_9D4yMyd40g)
20 * Volume level initialization ( [helpful for autoplay >>](http://www.embedplus.com/mute-volume-youtube-wordpress.aspx) )
21 * iOS playback preferences
22 * [Automatic localization/internationalization](http://www.embedplus.com/youtube-iso-639-1-language-codes.aspx) so you can set the player's interface language from English to another
23 * Instant HTTPS support. It can even convert past non-HTTPS videos to HTTPS. Did you know that Google uses [HTTPS/SSL support as a ranking signal for SERP?](http://embedplus.com/convert-old-youtube-embeds-to-https-ssl.aspx)
24 * "At a Glance" direct access to your YouTube posts/pages
25 * Shortcode support for [embedding multiple videos on one line >>](https://www.youtube.com/watch?v=KU6lzcNR1FI)
26 * [General playlist embedding support >>](https://www.youtube.com/watch?v=J50PlRZHH9I)
27 * [Default HTML5 YouTube player support >>](http://www.embedplus.com/make-sure-youtube-defaults-to-html5-on-wordpress.aspx)
28 * YouTube plugin migration support
29
30 You can even extend the plugin with PRO features like:
31
32 * Caching to avoid making frequent requests to YouTube.com and speed up your page loads.
33 * [Automatic video thumbnail images](http://embedplus.com/add-youtube-video-thumbnails-featured-image-wordpress.aspx): each post or page that contains at least one video will have the thumbnail of its first video serve as its featured image.
34 * [Eye-catching special effects for YouTube embeds >>](http://www.embedplus.com/add-special-effects-to-youtube-embeds-in-wordpress.aspx) (uses lazy loading)
35 * Automatic tagging for video SEO
36 * Automatic Open Graph tagging for Facebook
37 * Deleted video alerts (i.e., did Google remove or take down videos I previously embedded?)
38 * Mobile compatibility checking (i.e., see if your embeds have restrictions that can block your site's mobile visitors from viewing)
39 * Alerts when visitors from different countries are blocked from viewing your embeds
40 * And more features and analytics...
41
42 **Click the Download button to start exploring now, or take a look at some details below.**
43
44 This plugin helps you easily manage the growing complexity of YouTube embedding. It provides a spectrum of basic and advanced features of the YouTube embedded player and will have you posting videos in seconds after installing it. **All you have to do is simply paste an unformatted YouTube link on its own line (shortcodes are also supported).** Your YouTube embeds will then show up when you preview or publish the post.
45
46 The settings page has plenty of default options that you can automatically apply to all your embedded YouTube videos. **Check out the free options below:**
47
48 * Force HD quality when available
49 * Make your videos responsive so that they dynamically fit in all screen sizes (smart phone, PC and tablet)
50 * Modest branding - hide YouTube logo while playing
51 * Turn on/off all annotations by default
52 * Automatically center all your videos
53 * Automatically start playing your videos
54 * Autohide controls until hovering
55 * Loop your videos
56 * Show/hide related videos at the end
57 * Show/hide the video title and other info
58 * Use the light theme
59 * Show/hide player controls
60 * Turn on/off closed captions by default
61 * Use "opaque" wmode
62
63 Customizations can be also made to each YouTube embed by adding more to the link as shown below. Adding these will override the above global defaults that you set:
64
65 * width - Sets the width of your player. If omitted, the default width will be the width of your theme's content. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&width=500&height=350`
66 * height - Sets the height of your player. If omitted, this will be calculated for you automatically. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&width=500&height=350`
67 * vq - Set this to `hd720` or `hd1080` to force the video to play in HD quality, if available. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&vq=hd720`
68 * autoplay - Set this to 1 to autoplay the video (or 0 to play the video once). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&autoplay=1`
69 * cc_load_policy - Set this to 1 to turn on closed captioning (or 0 to leave them off). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&cc_load_policy=1`
70 * iv_load_policy - Set this to 3 to turn off annotations (or 1 to show them). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&iv_load_policy=3`
71 * loop - Set this to 1 to loop the video (or 0 to not loop). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&loop=1`
72 * modestbranding - Set this to 1 to remove the YouTube logo while playing (or 0 to show the logo). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&modestbranding=1`
73 * rel - Set this to 0 to not show related videos at the end of playing (or 1 to show them). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&rel=0`
74 * showinfo - Set this to 0 to hide the video title and other info (or 1 to show it). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&showinfo=0`
75 * theme - Set this to 'light' to make the player have the light-colored theme (or 'dark' for the dark theme). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&theme=light`
76 * autohide - Set this to 1 to slide away the control bar after the video starts playing. It will automatically slide back in again if you mouse over the video. (Set to 2 to always show it). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&autohide=1`
77
78 You can also start and end each individual video at particular times. Like the above, each option should begin with '&'
79
80 * start - Sets the time (in seconds) to start the video. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&width=500&height=350&start=20`
81 * end - Sets the time (in seconds) to stop the video. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&width=500&height=350&end=100`
82
83 **About the PRO version:**
84
85 Beyond the above features, you have the option of upgrading to PRO to add enhanced features like the full visual embedding wizard (so you can avoid memorizing codes), priority support, and security/performance. As a PRO user, you also get access to our deleted video alerts to help avoid showing embedded videos that are later removed from YouTube.com. You even get an embedder-centric analytics dashboard that adds view tracking to each of your embeds so that you can answers questions like:
86
87 * How much are your visitors actually watching the videos you post?
88 * How does the view activity on your site compare to other sites like it?
89 * What and when are your best and worst performing YouTube embeds?
90 * How much do the producers of the YouTube videos you embed rely on **your site**, versus other sites and YouTube.com, for views?
91 * Are you embedding videos that are blocked in other countries?
92
93 See more details after installing. Enjoy!
94
95 [Maintained by EmbedPlus for YouTube >>](http://www.embedplus.com/)
96
97 == Installation ==
98
99 1. Use the WordPress plugin installer to install the plugin. Alternatively, you can just extract the folder in our download package and upload it to your plugin directory.
100 1. Access the Plugins admin menu to activate the YouTube embed plugin.
101 1. Make your default settings after clicking the new YouTube menu item that shows up in your admin panel.
102 1. To embed videos in your post, start pasting the links with any desired additional codes needed for your YouTube embed (see below section for additional codes). Make sure each link is on its own line. Or, if you need multiple videos on the same line, make sure each URL is wrapped properly with the shortcode. Example: `[embedyt]http://www.youtube.com/watch?v=ABCDEFGHIJK&width=400&height=250[/embedyt]` If you don't know exactly which video you want to embed, use the free built-in search feature to find and insert one.
103 1. To get video SEO, an analytics dashboard and many other premium features, [sign up for one of the options here >>](https://www.embedplus.com/dashboard/pro-easy-video-analytics.aspx)
104
105 **Additional codes (adding these will override the default settings in the admin):**
106
107 * width - Sets the width of your player. If omitted, the default width will be the width of your theme's content. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&width=500&height=350`
108 * height - Sets the height of your player. If omitted, this will be calculated for you automatically. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&width=500&height=350`
109 * vq - Set this to `hd720` or `hd1080` to force the video to play in HD quality. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&vq=hd720`
110 * autoplay - Set this to 1 to autoplay the video (or 0 to play the video once). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&autoplay=1`
111 * cc_load_policy - Set this to 1 to turn on closed captioning (or 0 to leave them off). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&cc_load_policy=1`
112 * iv_load_policy - Set this to 3 to turn off annotations (or 1 to show them). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&iv_load_policy=3`
113 * loop - Set this to 1 to loop the video (or 0 to not loop). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&loop=1`
114 * modestbranding - Set this to 1 to remove the YouTube logo while playing (or 0 to show the logo). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&modestbranding=1`
115 * rel - Set this to 0 to not show related videos at the end of playing (or 1 to show them). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&rel=0`
116 * showinfo - Set this to 0 to hide the video title and other info (or 1 to show it). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&showinfo=0`
117 * theme - Set this to 'light' to make the player have the light-colored theme (or 'dark' for the dark theme). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&theme=light`
118 * autohide - Set this to 1 to slide away the control bar after the video starts playing. It will automatically slide back in again if you mouse over the video. (Set to 2 to always show it). Example: `http://www.youtube.com/watch?v=quwebVjAEJA&autohide=1`
119
120 You can also start and end each individual video at particular times. Like the above, each option should begin with '&'
121
122 * start - Sets the time (in seconds) to start the video. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&width=500&height=350&start=20`
123 * end - Sets the time (in seconds) to stop the video. Example: `http://www.youtube.com/watch?v=quwebVjAEJA&width=500&height=350&end=100`
124
125 **Always follow these rules when pasting a link:**
126
127 * Make sure the url is really on its own line by itself. Or, if you need multiple videos on the same line, make sure each URL is wrapped properly with the shortcode. Example: `[embedyt]http://www.youtube.com/watch?v=ABCDEFGHIJK&width=400&height=250[/embedyt]`
128 * Make sure the url is not an active hyperlink (i.e., it should just be plain text). Otherwise, highlight the url and click the "unlink" button in your editor.
129 * Make sure you did **not** format or align the url in any way. If your url still appears in your actual post instead of a video, highlight it and click the "remove formatting" button (formatting can be invisible sometimes).
130 * Finally, there's a slight chance your custom theme is the issue, if you have one. To know for sure, we suggest temporarily switching to one of the default WordPress themes (e.g., "Twenty Thirteen") just to see if your video does appear. If it suddenly works, then your custom theme is the issue. You can switch back when done testing.
131
132 == Screenshots ==
133
134 1. YouTube Embed Screenshot 1: Paste a YouTube link on its own line and it will become a YouTube embed on your website. Or, use the shortcode method.
135 2. YouTube Embed Screenshot 2: How to get to YouTube's admin settings.
136 3. YouTube Embed Screenshot 3: Visual YouTube Wizard and Search Tool
137 4. YouTube Embed Screenshot 4: Wizard Insert Search Result Screenshot
138 5. YouTube Embed Screenshot 5: Wizard Search Results Screenshot
139 6. YouTube Embed Screenshot 6: Localization/internationalization so you can set the player's interface language
140
141 == Changelog ==
142
143 = YouTube Embed 10.1 =
144 Adds the ability to automatically migrate from another plugin's shortcode. Caching feature now allows lifetime settings. Improved compatibility with other plugins using the YouTube API.
145
146 = YouTube Embed 10.0 =
147 This update includes improved tips (Free and Pro) and adds caching to the Pro version for faster page loading.
148
149 = YouTube Embed 9.8 =
150 Upgraded code to use YouTube API v3.
151
152 = YouTube Embed 9.7 =
153 Adds improved accessibility for screen readers and video thumbnail as featured image support.
154
155 = YouTube Embed 9.5 =
156 Site origin information with each embed code as an extra security measure. In YouTube's/Google's own words, checking this option "protects against malicious third-party JavaScript being injected into your page and hijacking control of your YouTube player." We especially recommend checking it as it adds higher security than the built-in YouTube embedding method that comes with the current version of WordPress (i.e. oembed).
157
158 = YouTube Embed 9.4 =
159 Adds Autofit Widget option for Free and PRO users. Also adds slide from left animation to [PRO effects >>](http://www.embedplus.com/add-special-effects-to-youtube-embeds-in-wordpress.aspx)
160
161 = YouTube Embed 9.3 =
162 Improved volume functionality and interface updates (Free and PRO). [Special effects added to PRO version >>](http://www.embedplus.com/add-special-effects-to-youtube-embeds-in-wordpress.aspx)
163
164 = YouTube Embed 9.2 =
165 HTTPS/SSL detection is now fully automatic. The manual checkbox is no longer needed.
166
167 = YouTube Embed 9.1 =
168 With this version, the plugin can now automatically detect your site's default language and set the interface of the embedded YouTube player to match.
169
170 = YouTube Embed 9.0 =
171 Adds automatic localization/internationalization so you can set the player's interface language from English to another.
172
173 = YouTube Embed 8.9 =
174 Allows volume level initialization.
175
176 = YouTube Embed 8.8 =
177 * Better embedplus plugin conflict notifications.
178 * Greater emphasis on HTTPS support due to Google's recent announcement about [HTTPS/SSL as an SEO/SERP signal](http://embedplus.com/convert-old-youtube-embeds-to-https-ssl.aspx).
179 * Supports latest version of WordPress (3.9.2).
180
181 = YouTube Embed 8.7 =
182 (PRO) Extends the plugin's existing tagging capabilities by also adding Open Graph markup to enhance Facebook sharing/discovery of your pages.
183
184 = YouTube Embed 8.6 =
185 Expanded HTTPS/SSL support.
186
187 = YouTube Embed 8.5 =
188 This update features a new iOS related option for both Free and PRO users. PRO users additionally have the new mobile compatibility checker.
189
190 = YouTube Embed 8.4 =
191 This update features improved responsive theme support for both Free and PRO versions. It also adds refined schema tag support to the Pro SEO feature.
192
193 = YouTube Embed 8.3 =
194 Now compatible with WordPress 3.9.
195
196 = YouTube Embed 8.2 =
197 An at a glance regex impromevent (all users). Dashboard now warns you of embeds that are blocked from your visitors in other countries (PRO).
198
199 = YouTube Embed 8.1 =
200 Fixes rare YouTube ID issue.
201
202 = YouTube Embed 8.0 =
203 Fixes rare ajax issue.
204
205 = YouTube Embed 7.9 =
206 YouTube searching and inserting now works in Text mode of the editor too.
207
208 = YouTube Embed 7.8 =
209 "At a Glance" direct access to YouTube posts/pages.
210
211 = YouTube Embed 7.7 =
212 Fixes black bar issue when no height/width is specified.
213
214 = YouTube Embed 7.6 =
215 Added notice about Google's HD problem.
216
217 = YouTube Embed 7.5 =
218 Ability to embed an entire channel as a playlist embed.
219
220 = YouTube Embed 7.3 =
221 Change the color of the progress bar from red to white.
222
223 = YouTube Embed 7.2 =
224 Added music video extras to inspire your posts (PRO).
225
226 = YouTube Embed 7.1 =
227 Added autohide controls feature
228
229 = YouTube Embed 7.0 =
230 Shortcode support for embedding multiple videos on one line
231
232 = YouTube Embed 6.4 =
233 Fixes for some users of WordPress 3.8
234
235 = YouTube Embed 6.3 =
236 Removed possible e_notices.
237
238 = YouTube Embed 6.2 =
239 Given the increasing focus on privacy, the no-cookies options was added as a free option to all users. Priority support enhancements also made.
240
241 = YouTube Embed 6.1 =
242 Easier access to general settings and dashboard.
243
244 = YouTube Embed 6.0 =
245 This version opens up the ability to view Internet video discussions to all wizard users.
246 **Also, due to numerous users being unable to find the wizard button, we moved it up next to the "Add Media" button.**
247 Finally, we added Video SEO tags as a PRO option.
248
249 = YouTube Embed 5.1 =
250 Added ability to set default dimensions.
251 Enhanced compatibility with SSL sites.
252
253 = YouTube Embed 5.0 =
254 Built-in YouTube video search, viewing, and insertion right from your editor tab (for all users).
255 The ability to review the latest web discussions about a video you want to embed before embedding it (PRO users).
256 Other minor optimizations.
257
258 = YouTube Embed 4.8 =
259 Works when pasting embed link in sidebar text widgets
260
261 = YouTube Embed 4.7 =
262 Improved separation of PRO and Free features in the UI
263
264 = YouTube Embed 4.6 =
265 Added optional responsive video layout to fit all screen sizes. (smart phone, PC and tablet)
266
267 = YouTube Embed 4.5 =
268 Added support for playlists.
269 added support for wmode.
270
271 = YouTube Embed 4.1 =
272 Fixed spacing issue. Also added ability to fall back to old spacing format.
273
274 = YouTube Embed 4.0 =
275 New features for all users: lazy loading for the flash player by default and the ability to hide player controls for a cleaner look.
276
277 = YouTube Embed 3.7 =
278 Enhanced deleted video checker for PRO users
279
280 = YouTube Embed 3.5 =
281 Added ability to try to force HTML5 player to speed up page loading
282
283 = YouTube Embed 3.3 =
284 HTTPS: Added secure YouTube embedding
285
286 = YouTube Embed 3.2 =
287 Ensures video-specific height overrides defaults properly
288
289 = YouTube Embed 3.1 =
290 Fixed obscure height problem
291
292 = YouTube Embed 3.0 =
293 Added Visual YouTube Wizard for PRO users
294 Added autologin to analytics for PRO users
295 Added priority support form for PRO users
296
297 = YouTube Embed 2.6 =
298 Compatible with WP 3.6
299
300 = YouTube Embed 2.4 =
301 Added auto HD support
302 Support for shorthand (i.e. `http://www.youtu.be`)
303 Fixed editor issue
304
305 = YouTube Embed 2.3 =
306 Start/end time shortcut bug fix
307
308 = YouTube Embed 2.2 =
309 Minor changes
310
311 = YouTube Embed 2.1 =
312 By request from several users, we've added easier access to the video analytics dashboard
313
314 = YouTube Embed 2.0 =
315
316 This upgrade specifically integrates a user-friendly YouTube Analytics Dashboard to this plugin so you can learn a lot more about the videos you post. Download it if you would like it to use your site's YouTube-related activity to help answer questions like:
317
318 * How much are your visitors actually watching the videos you post?
319 * How does the view activity on your site compare to other sites like it?
320 * What and when are your best and worst performers?
321 * How much do the producers of the YouTube videos you embed rely on **your site** for views?
322
323 We think these are all interesting questions; however, note that there's no need to upgrade if you don't.
324
325 = YouTube Embed 1.1 =
326 Fixed minor bug.
327
328 = YouTube Embed 1.0 =
329 First release uploaded to the plugin repository.
330
331 == Other Notes ==
332
333 This YouTube plugin can include premium features like animation effects using lazy loading, automatic video thumbnail support, automatic schema tagging for video SEO, mobile compatibility checking, and deleted video alerts when you [upgrade to PRO](https://www.embedplus.com/dashboard/pro-easy-video-analytics.aspx).
334
335 We also have a YouTube channel with some helper videos. [Check them out here >>](https://www.youtube.com/user/EmbedPlus)