开发者 | a.hoereth |
---|---|
更新时间 | 2016年12月18日 07:09 |
捐献地址: | 去捐款 |
PHP版本: | 3.7 及以上 |
WordPress版本: | 4.7 |
版权: | GPL-2.0 |
版权网址: | 版权信息 |
A picture is worth a thousand words. How many words is a video worth? Featured Videos work like Featured Images, just smoother: Paste a video URL into the designated new box on the post edit screen and the video will be displayed in place of a post image.There are three ways to get the videos onto your page:
[featured-video-plus]
-Shortcode in your posts orTheme compatibility Sadly many themes do not follow the WordPress standards and implement their own fancy functions for displaying featured images - those very likely break this plugin. Check out the FAQ. Another common problem are sliders: Videos, in general, do not like sliders at all.See the plugin in action on yrnxt.com. There is a button in the sidebar to switch between the different featured video display modes: Automatic, lazy and overlay. Besides Local Videos you can use videos from a whole lot of external providers like YouTube, Vimeo and Dailymotion. SoundCloud and Spotify (including playlists) are supported as well. Check the WordPress Codex for a complete list. If some provider is not listed you can always just use an embed code or whatever HTML you like. After installing the plugin check your site's Media Settings (
Settings -> Media
in the administration interface): The plugin adds quite some little helper options there. Change to lazy or overlay mode, tweak video sizing, individualize the look of the most prominent providers' video players and turn on autoplay or video looping. By default videos try to dynamically fit their parent containers width and adjust their size responsively.
Support I do read all support questions in the forums but cannot reply to all of them. The plugin is an unpaid side project and full support would require more time than I can invest for free for over 20k active installs. If you really need help, consider buying me a cookie - best way to attract my attention and to support future enhancements.
Plugins -> Add New
Featured Video Plus
, and click Install Now
below the plugin's nameActivate Plugin
Featured Video
box on the right! Plugin specific settings can be found under Settings -> Media
.
Theme integration
If the automatic integration fails you can always fallback to either using the shortcode or adjusting your themes sourcecode manually:
Shortcode
[featured-video-plus]
[featured-video-plus width=300]
PHP-functions
the_post_video( $size )
has_post_video( $post_id )
get_the_post_video( $post_id, $size )
get_the_post_video_url( $post_id )
get_the_post_video_image( $post_id )
get_the_post_video_image_url( $post_id )
All parameters are optional. If no $post_id
is given the current post's ID will be used. $size
is either a string keyword (thumbnail
, medium
, large
or full
) or a 2-item array representing width and height in pixels, e.g. array(560,320)
.
When editing your theme's sourcecode keep in mind that a future update through WordPress.org might overwrite your changes. Consider creating a child theme to prevent that.If the plugin just returns text instead of the actual video the pasted url is probably not valid or not from a valid video provider. Try inserting the raw embed code instead or check the docs to see which providers are supported.
Click the small media icon in the Featured Video input box on the post edit screen and upload your video or choose it from the media library. WordPress does not support all formats tho, check this table for details.
For the videos to be automatically displayed you need to define a Featured Image. Depending on your featured video settings this image will never be shown if a video is set. If your theme does not support featured images the plugin also has no chance of working out of the box.
Sadly not all themes work out of the box. Themes need to make use of WordPress' native Post Thumbnail functionality (specifically get_the_post_thumbnail()
and/or the_post_thumbnail()
) - these functions are where the plugin can hook into the theme and modify what is displayed. Consider contacting the theme's creator or modifying the theme's sourcecode in order to add the plugin's PHP-functions.
Take a look at your media settings and try using a fixed width instead of responsive sizing.
While the plugin tries to handle infinite scrolling automatically, it does not work for all configurations. In those cases you will want to manually call initFeaturedVideoPlus()
using JavaScript everytime new articles have been loaded. Most infinite scroll plugins should have some kind of post-load hook.
Yes, please! Check out the official Featured Video Plus Translation Project.
iframe
, object
, embed
) by default for new videos -- can be enabled in the settings. Could have been misused if somebody had gained access to an editor account beforehand. Reported by @jamesgol.has_post_video
function is now pluggable.get_the_post_video_url
function post id argument is now optional (*).[gallery]
).remove featured image
link. (*, *, *)always use replace mode when viewing single posts and pages
option, was implicitly true since 2.0.0. (*)WP_DEBUG
. (*)get_the_post_video_url
has a new second parameter (boolean) to get the fallback video's URL (*)get_the_post_video_url($post_id)
PHP-Functionenablejsapi
parameter with playerapiid
(fvpid + $post_id
) and iframe id (*)get_the_post_video
: get_the_post_video_filter
(*)wmode
autoplay
settingget_the_post_video_image
& get_the_post_video_image_url