- How Lazyload Works in ARVE
- How to Downgrade
- 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.
Version 9.0 with a Gutenberg block is in the works. You can use the shortcode block if you want to customize your embeds right now. The embed, youtube, vimeo … blocks do work but have no special options for ARVE.
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
autoplayall parameters that control the providers player need to be inside the
parameters attribute. This 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 Block sidebar (in beta), so you have that exact same descriptions inside your WordPress admin
|url||Placeholder: Video URL / iframe Embed Code|
Post the URL of the video here. For Brightcove, Comedy Central, Spike, VK, ooyala, IMDB and any unlisted video hosts paste their iframe embed codes.
|title||Used for SEO, is visible on top of thumbnails in Lazyload modes, is used as link text in link-lightbox mode. ARVE Pro is able to get them from CollegeHumor, Dailymotion, Funny or Die, TED Talks, Viddler, Vimeo, Yahoo, YouTube automatically.|
|description||Placeholder: Used for SEO (needed, ARVE Pro auto fills this)|
ARVE Pro fills this automatically
|upload_date||Placeholder: 2019-09-29 (ARVE Pro fills this with post date)|
ARVE Pro fills this automatically
For Lazyload, Lightbox and Link mode check out ARVE Pro.
|thumbnail||Placeholder: Media library image ID or image URL|
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, CollegeHumor, Dailymotion, Facebook, Funny or Die, LiveLeak, 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).|
|grow||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.
`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.|
|lightbox_maxwidth||Placeholder: Leave empty for default from settings page|
|aspect_ratio||Placeholder: 4:3, 21:9 ...|
E.g. 4:3, 21:9. Only needed in rare cases. ARVE is usually smart enough to figure this out on its own.
Provider specific player settings on iframe src. See documentation.
|controlslist||Placeholder: nodownload nofullscreen noremoteplayback|
controlsList attribute on <video> for example use
Show controls on HTML5 video.
|loop||Loop HTML5 video.|
|muted||Mute HTML5 video.|
Works with video files only.
|random_video_url||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.
For versions 9.0+ all you have to do is paste the iframe embed code a site give you into the Gutenberg block. When using Classic Editor and Shortcode UI you can also just paste the iframe embed code and the
src url will be extracted automatically.
When using shortcodes use the
src from any
<iframe src="this" [...] > embed code in the ARVE shortcode like this
[arve url="src_here"] or paste the iframe embed code in the ‘Embed Video’ dialog and be happy. But there are exceptions.
ARVE supports responsive embedding for any video provider gives out iframe embeds codes that handle resizing well. You can test this by taking the URL from the
src attribute of the embed code and open it on your browser then resizing the browser window.
Example embed code a providers may give out:
<iframe src="http://example.com/embed.php?width=640&height=480" width="640" height="480"></iframe>
There are embed codes that have height and width parameters in the URL as well, specifically speaking about the URL here not the iframe attributes. That is often a bad sign for fixed size embeds. But I also have seen this kinds of embeds work responsively. If they do you should change the dimensions to something that represents the highest possible size you want you embeds to be on your site. If your embed code has a unusual aspect ratio you need to provide that as well. The above example has a 4:3 aspect ratio. Manually creating a arve embed for the above example would be:
[arve url="http://example.com/embed.php?width=1280&height=1024" aspect_ratio="4:3" /]
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.