This plugin allows you to embed video players from various video sharing sites. New services can be added by just editing a config file. This is not for displaying local video files.

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

The basic syntax looks like this: {{videosite>videoid?parameter1&parameter2|title}}

• Where videosite is one of the identifiers listed in Supported Services chapter
• and videoid is the identifier of the video at the respective site
• The parameters are optional. You start these with a ? and separate more of them by a &. Look in Parameters chapter
• The title is optional as well. Look in Examples chapter
• The video can be aligned by adding spaces on the left or right inside the curly brackets (like in the image syntax). Look in Examples chapter

A toolbar button pops up a prompt where you can simply paste the full URL to the page of the video you want to embed. The plugin will then try to figure out the video ID by itself. For some services you may need to paste a special URL. See the table below.

When embedding a video you should add a size parameter.

You can either give it in the form:

• widthxheight like 500×300
• or use the keywords small, medium or large
• you can also use the keywords full or half to have the video adjust to the available screen width (either 100% or 50% width)

All additional parameters will be passed on as-is to the video service. Refer to their documentation for what is available. There are also hints in the table below.

Display a YouTube Video:

{{youtube>L-WM8YxwqEU}}

Show a larger player:

{{youtube>L-WM8YxwqEU?large}}

Right-align the player:

{{ youtube>L-WM8YxwqEU}}

Show a small, centered player:

{{ youtube>L-WM8YxwqEU?small }}

Show a small, centered player with a title (look for right space!):

{{ youtube>L-WM8YxwqEU?small |Some funny video}}

Some other additional parameters are supported (depending on video service) as well:

{{youtube>L-WM8YxwqEU?small&start=30&end=45|A random segment of 15 seconds}}

Copy paste the video url in the toolbar pop-up prompt to generate the syntax

For other video sharing sites not supported by vshare, particularly those using PeerTube, you could use the oEmbed plugin to embed videos and other medias

When enabling the gdpr option, videos will not be embedded right away. Instead the user needs to click on the embed first. This will embed the video.

The extrahard option will set a whole bunch of extra attributes on the iframe, instructing the browser to access the video in it's own sandboxed context. This will send less personal data to the video site but will also disable features logged in users might usually expect. Eg. ad-less videos for premium subscribers, the use of watch-later lists, etc.

Enabling the debug option enables the syntax macro ~~vshare-debug~~. Using that macro in a page, will embed a video from each of the configured video sites. This makes it easy to check that all services still work as expected. It is probably only useful for developers.

New services can easily be added by editing the sites.ini file in the plugin's main directory. Each service expects the following settings:

Pull requests providing this data are welcome.

• Version upped (2024-03-24 23:50)
• move noreferrer policy to hardend mode (2024-03-24 19:35)
• Version upped (2024-02-28 23:50)
• lazy load iframes (2024-02-28 17:33)
• automatic style fixes (2024-02-28 16:03)
• added extra hardening option (2024-02-28 15:58)
• Merge pull request #131 from dokuwiki-translate/lang_update_648_16853… (2023-05-31 08:15)
• translation update (2023-05-29 20:25)

Please report bugs and request features at the issue tracker.