History: PluginPeerTube

            ! {icon name="video"} ~hs~ PluginPeerTube

This ((wiki plugin)) embeds a PeerTube video in a Tiki page.
It uses PeerTube’s oEmbed under the hood but exposes familiar Tiki parameters.
Available since Tiki 30.x.


!! Parameters
Embed a PeerTube video (uses oEmbed under the hood). 
''Introduced in Tiki 30.x. Required parameters are in'' -+__bold__+-.
[https://gitlab.com/tikiwiki/tiki/-/merge_requests/8109/diffs#diff-content-e90771370fb0293b7bf1c429c7e38b159c51a24b|Go to the source code]
''Required preferences:'' -+wikiplugin_peertube+- and -+feature_peertube+-.

|| __Parameter__ | __Accepted values__ | __Description__ | __Default__ | __Since__
 -+url+- | url | Full watch URL of the PeerTube video (e.g., https://videos.example.com/w/abc123xyz) | | Tiki 30.x
 -+height+- | digits | Height in pixels (e.g., 315). Leave empty to use provider dimensions | | Tiki 30.x
 -+width+- | digits | Width in pixels (e.g., 560). Leave empty to use provider dimensions | | Tiki 30.x
 -+start+- | digits | Start time offset in seconds | 0 | Tiki 30.x
 -+privacyEnhanced+- | y / n | Enable “privacy-enhanced” mode (if supported by the provider) | | Tiki 30.x
 -+bg+- | text | Container background color. Examples: -+#ffffff+-, -+rgb(255,255,255)+-, -+white+- | | Tiki 30.x
 -+allowFullScreen+- | y / n | Allow full-screen playback | y | Tiki 30.x
 -+borderRadius+- | y / n | Apply rounded corners to the container | y | Tiki 30.x
 -+border+- | text | Container border color. Examples: -+#ffffff+-, -+rgb(255,255,255)+-, -+white+- | | Tiki 30.x
||


!! Show a video
''Examples of using the PeerTube plugin:''

Minimal
{CODE(colors="tiki")}
{peertube url="https://videos.example.com/w/abc123xyz"}
{CODE}

With display options
{CODE(colors="tiki")}
  {peertube
    url="https://videos.example.com/w/abc123xyz"
    width="560" height="315"
    allowFullScreen="y"
    bg="#000000" border="#ff0000" borderRadius="y"
    start="30"
  }
{CODE}

{oembed url="https://videos.evoludata.com/w/2aGghaFr12Cg1Nj1ckqznH" background="000000" border="ff0000" allowFullScreen="y"}


!! Important notes
* Always use the full watch URL (the …/w/shortUUID form).
* Private/Internal videos may not embed due to instance privacy policy.
* If -+width+-/-+height+- are empty, Tiki uses the default responsive dimensions returned by oEmbed.
* -+bg+-, -+border+-, and -+borderRadius+- style the container (not the remote player UI).


!! Known limitations
* No automatic oEmbed discovery: you must provide a valid PeerTube watch URL.
* Works if the PeerTube instance exposes an oEmbed endpoint and allows iframe embedding.


!! To do (ideas)
* Add smarter URL discovery.
* Regularly test against multiple PeerTube instances/versions.

!! See also
((PeerTube)) • ((PluginOembed)) • ((Trackers))