Plugin OEmbed
This wiki plugin enables embedding of external videos or media into Tiki pages using the oEmbed protocol. It fetches metadata from the provided media URL and generates an embedded media player to display the content on your Tiki page. This is useful for integrating platforms like PeerTube, YouTube, Vimeo, and others that support the oEmbed standard.
Parameters
Embed a video or media using oEmbed protocol
Introduced in Tiki 28. 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:
{oembed url="https://videos.evoludata.com/w/2aGghaFr12Cg1Nj1ckqznH" background="000000" border="ff0000" allowFullScreen="y"}
Important Notes:
- This plugin is only available starting from
Tiki 28. - This integration works with services that follow the oEmbed specification and provide the
/services/oembedendpoint (e.g., PeerTube). - Example videos can be found on public PeerTube instances like Evoludata's PeerTube.
Known Limitations:
- The current implementation only supports services using
/services/oembedas oEmbed endpoint (like Peertube for example). - No automatic discovery protocol is currently implemented. Users must provide the exact URL for oEmbed integration.
- Only services that provide an iframe in the
HTMLattribute 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.