- How Lazyload Works in ARVE
- How to Downgrade ARVE or any WordPress plugin
- How to Embed (Self Hosted) HTML5 Video With ARVE
- How to Embed a Video to Start at a Specific Time
- How to Get a Vimeo Access Token
- How to Replace Old Shortcodes With New [arve] Shortcodes.
- Installing and License Management
- The ‘Expand on Click’ Feature Explained.
The “Video Embed (ARVE)” Gutenberg block support all the ARVE settings for individual videos in the sidebar. Be sure to set the defaults on the settings page to there is no need to set everything for each video, only what is needed.
The default “embed/YouTube/Vimeo/…” blocks also work but without support for per video settings. You can also use the “Shortcode” block.
Embedding Videos via URL (Classic Editor)
This is the WordPress way to embed videos. If you not want to be ‘locked in’ and only care about providers WordPress already supports (not responsively and without any customization options) then you can simply enable this plugin and see your videos magically become responsive. If you keep to providers WordPress also supports this means you are not getting ‘locked in’ by ARVE and may at any time delete the plugin and still have your Videos in place (basic unresponsive of course). Any special options and parameters will then be ignored.
To embed a video into a post or page, place its URL into the content area. Make sure the URL is on its own line and not hyper-linked (click-able when viewing the post).
Check out this cool video: -http://www.youtube.com/watch?v=dQw4w9WgXcQ That was a cool video.
Recommended Use of Options and Attributes
Shortcode Attributes (Options selected in the ‘Embed Video Dialog’) always override settings on the ARVE settings page. It is recommended that you set the the options Mode, Maximal Video Width, Autoplay … in a way that you want most (if not all) Videos appear on your site. You should only use attributes for settings that are also present on the settings page if you want some videos appear different then general ones rather then declaring this attributes for every single video.
For example if you have set Mode to Normal and Maximal Video Width to 500 the plugins options page, then URLs and Shortcodes will use that options to embed your videos. You can then decide to have a specific videos displayed differently by applying attributes to URLs or Shortcodes.
Embedding via Shortcodes
Press the Embed Video button in your post editor in WordPress and paste the URL or embed code into the field, optionally select options and press Update. You can of course manually write Shortcodes. They have the advantage of being easier to read then URLs and you also can place them everywhere without the need for them to be on their own line, this becomes useful when aligning videos to text. You can also use them inside text widgets to, for example, put videos in your sidebar.
How to manually write shortcodes:
You pick video URL from YouTube or another supported host and then.
[arve url="https://www.youtube.com/watch?v=Z7g8-GxLTSc" /]
For parameters you can look below.
If the host is not listed or listed as not supported with URL you need to use the
src from a
iframe embed code a video host may give out.
[arve url="https://example.com/iframe-src-url-here" /]
SEO ready Shortcode would be:
[arve url="https://youtu.be/Z7g8-GxLTSc" title="Your SEO Title" description="Your SEO Description" upload_date="2016-09-14" /]
One thing is a little tricky without a UI: If you need a ID for the thumbnail parameter you can get if from the WP Media Gallery by clicking on the image and looking at the address bar
../wp-admin/upload.php?item=1234 the number on the end is the ID. So a video with this image as responsive custom thumbnail would be:
[arve url="https://youtu.be/Z7g8-GxLTSc" thumbnail="1234" /]
Do not confuse providers URL-parameters with shortcode attributes when writing Shortcodes.
[arve url="https://vimeo.com/136395742" aspect_ratio="3:1" title="0" byline="1" portrait="0" loop="1" /]
[arve url="https://vimeo.com/136395742" aspect_ratio="3:1" parameters="title=0&byline=0&portrait=0&loop=1" /]
With the exception of
autoplay all parameters that control the providers’ player need to be inside the
parameters attribute. These parameters are different based on the provider options. Youtube Parameters, Dailymotion Parameters, Vimeo Parameters. For the actual shortcode attributes that control ARVE look below.
The old style shortcodes like
[vimeo id="136395742" /] are still supported for backwards comparability but not recommended to use.
Note that this table is generated from the plugins code for the shortcode UI dialog and Gutenberg Block sidebar, so you have that exact same descriptions inside your WordPress admin
|url||Post the URL of the video here. For Mail.ru, Brightcove, Comedy Central, IMDB, ooyala, VK and any unlisted video hosts paste their iframe embed codes.|
|title||Used for SEO, is visible on top of thumbnails in Lazyload/Lightbox modes, is used as link text in link-lightbox mode. ARVE Pro is able to get them from Dailymotion, Rumble.com, TED Talks, Viddler, Vimeo, Yahoo, YouTube automatically.|
|description||Needed for SEO ARVE Pro fills this automatically|
|upload_date||ARVE Pro fills this automatically.|
For Lazyload, Lightbox and Link mode check out ARVE Pro. Only use normal when Pro is not installed!
|thumbnail||Media library image ID (Select above in Gutenberg) or image URL for preview image for Lazyload modes, always used for SEO. ARVE Pro is able to get them from Alugha, Dailymotion, LiveLeak, Rumble.com, TED Talks, Twitch, Viddler, Vimeo, Yahoo, YouTube, YouTube Playlist automatically.|
|hide_title||Usefull when the thumbnail image already displays the video title (Lazyload & Lightbox modes).|
Expands video size after clicking the thumbnail (Lazyload Mode)
Prevent embeds to open new popups/tabs from links inside video embeds. Note: breaks functionality like sharing.
Shows a small 'ARVE' link below the videos. Be the most awesome person and help promoting this plugin.
|duration||`1H2M3S` for 1 hour, 2 minutes and 3 seconds. `5M` for 5 minutes.|
Do not expect this to work! Browsers (especially mobile) or user settings prevent it, some video hosts do not support it at all. Only used in normal mode. ARVE will mute HTML5 video playback in case to make autoplay work for the broadest audience.
|maxwidth||In pixels. If set to 0 (default) the $content_width value from your theme is used if present, otherwise the default is 900.|
Keep the video on the screen when scrolling.
Stick the video to the top of screens below 768px width in portrait orientation. The Video will always be as wide as the screen ignoring the Stick Width and Stick Maxwidth settings.
Corner the video gets pinned to on bigger screens.
|aspect_ratio||E.g. 4:3, 21:9. ARVE is usually smart enough to figure this out on its own.|
|parameters||Provider specific player settings on iframe src. See documentation.|
|controlslist||controlsList attribute on <video> for example use |
Show controls on HTML5 video.
|loop||Loop HTML5 video.|
|muted||Mute HTML5 video.|
|volume||Works with video files only.|
|random_video_url||Youtube Playlist or Vimeo showcase URL(Random Video Addon).|
|random_video_urls||Video URLs seperated by commas. (Random Video Addon).|
|sandbox||Only disable if you have to. If you embed encrypted media you have to disable this. 'Disable Links' feature from ARVE Pro will not work when without sandbox.|
parameters attribute is used for provider specific url parameters added to the
iframe src. These values can be used to alter video players. When set these values get merged with the global values on your ARVE settings page. See Youtube Parameters, Dailymotion Parameters, Vimeo Parameters.
Example for YouTube
fs=0&start=30 will hide the fullscreen button, and make the video start at 30 seconds.
General Iframe Embedding
Generally speaking ARVEs embedding for unlisted providers should be pretty straight forward.
All you have to do is paste the iframe embed code a site gives you into the Gutenberg block or when using Classic Editor and Shortcode UI you can also just paste the iframe embed code and the
src url and aspect ratio get extracted automatically.
When manually writing a shortcode all you need it the url from the
src attribute. Optionally you can use width and height linked with a colon as aspect ratio (default is 16:9 that is correct for most videos)
<iframe src="https://example.com/embed/1234" width="640" height="480"></iframe>
[arve url="https://example.com/embed/1234" aspect_ratio="640:480" optional="foobar" optional2="foobar2" /]
ARVE assumes a URL is an iframe
src if ARVE can’t detect it see the Provider Support Table to see what providers will need an embed code.