Loading...
 

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 (e.g., 315). Leave empty to use provider dimensions.
width digits Width in pixels (e.g., 560). Leave empty to use provider dimensions.
start digits Start time offset in seconds 0
bg Object background color. Example: #ffffff, rgb(255, 255, 255), white
border Object border color. Example: #ffffff, rgb(255, 255, 255), white
privacyEnhanced (blank)
y
n		 Enable privacy-enhanced mode (if applicable)
allowFullScreen y
n		 Enlarge video to full screen size y
borderRadius y
n		 Apply rounded corners to the container. Default: Yes y



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 28.
  • This integration works with services that follow the oEmbed specification and provide the /services/oembed endpoint (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/oembed as 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 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.