History: PluginOEmbed
Preview of version: 19
Plugin OEmbed
This wiki plugin enables embedding of external videos or media into Tiki pages using the oEmbed protocol. It fetches and processes metadata from a provided media URL, generating an embedded media player.
Parameters
Embed a video or media using oEmbed protocol
Introduced in Tiki 29. Required parameters are in bold.
Go to the source code
Preferences required: wikiplugin_oembed
| Parameters | Accepted Values | Description | Default | Since |
url | url | Complete URL to the oEmbed video or media | ||
height | digits | Height in pixels. Default: 315 | 315 | |
start | digits | Start time offset in seconds | 0 | |
width | digits | Width in pixels. Default: 560 | 560 | |
privacyEnhanced | y n | Enable privacy-enhanced mode (if applicable) | ||
allowFullScreen | y n | Enlarge video to full screen size | y | |
background | Object background color. Use an HTML color code. Example: ffffff | |||
border | Object border color. Use an HTML color code. Example: ffffff |
Note : You can use the provided parameters like width, height, allowFullScreen, etc. to customize the oEmbed output. Refer to the oEmbed documentation for additional details.
Show a video
Here is an example of how to use the oEmbed plugin:
Copy to clipboard
{oembed url="https://videos.evoludata.com/w/2aGghaFr12Cg1Nj1ckqznH" background="000000" border="ff0000" allowFullScreen="y"}
Important Notes:
- This plugin is only available starting from
Tiki 29. - It is not possible to display the video here because doc.tiki.org is currently running Tiki 28.
- This integration works with
PeerTubeinstances that follow the oEmbed specification and provide the/services/oembedendpoint. - No automatic discovery protocol is currently implemented. Only services using the
/services/oembedURL are supported in this version. - Example videos can be found on public PeerTube instances like Evoludata's PeerTube.
Known Limitations:
- The current implementation only supports PeerTube instances with oEmbed endpoints (e.g., `/services/oembed`).
- No automatic URL discovery is available for PeerTube. Users must provide the exact URL for oEmbed integration.
- Only services that provide an iframe in the HTML attribute are supported for embedding.
To Do:
- Consider adding a more complex URL discovery mechanism in future versions.
- Test the implementation with multiple PeerTube instances to ensure compatibility.