Differences

This shows you the differences between two versions of the page.

--- plugin:oembed [2010-01-09 19:24] – zengei
+++ plugin:oembed [2023-10-31 00:41] (current) – Klap-in
@@ Line 1: / Line 1: @@
-====== OEmbed Plugin ======
+====== oEmbed Plugin ======
 ---- plugin ----
-description: Easily embed media from OEmbed providers.
+description: Embed media from oembed providers
-author     : Dwayne Bent
+author     : Dwayne Bent, Nik Gaffney
-email      : dbb.1@liqd.org
+email      : nik@fo.am
 type       : syntax
-lastupdate : 2008-07-31
+lastupdate : 2021-06-07
-compatible : 2008-05-05
+compatible : Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
 depends    :
 conflicts  :
 similar    :
-tags       : media, images, video, music, embed
+tags       : media, images, video, music, embed, flickr
-downloadurl: http://liqd.org/wiki/_media/oembed/oembed-latest.zip
+downloadurl: https://github.com/zzkt/dokuwiki-oembed/zipball/endless
+bugtracker : https://github.com/zzkt/dokuwiki-oembed/issues
+sourcerepo : https://github.com/zzkt/dokuwiki-oembed/
+donationurl: https://www.sarcoma.org.au/donations
+screenshot_img : :plugin:oembed.png
 ----
-[[http://www.oembed.com/|OEmbed]] is a format for transferring media embed information.
+The oEmbed plugin allows you to easily embed media from any provider that supports the [[https://oembed.com/|oEmbed]] format.
+===== Install =====
+Search for and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
+===== Syntax =====
+The simplest way to embed media is with its url. e.g. ''%%{{>http://example.com/}}%%''
+Some providers can be given extra options in the form ''%%{{>url?options}}%%'' such as ''maxwidth'' or ''maxheight''
+An oembed provider will specify a URL scheme and API endpoint pairs. If you know the endpoint you can also use the ''!direct'' keyword to send paramaters to the API endpoint
+===== Examples =====
+embed a single image from Flickr
+  {{>http://www.flickr.com/photos/foam/41018347952}}
+embed an image with a maximum width of 800px
+  {{>http://www.flickr.com/photos/foam/41018347952?maxwidth=800}}
+embed a gallery
+  {{>http://www.flickr.com/photos/flickr/galleries/72157667259442778/}}
+use the API endpoint directly
+  {{>http://www.flickr.com/services/oembed/ !direct ?url=http://www.flickr.com/photos/sdasmarchives/5018415361/}}
+===== Further =====
+A list of oembed providers can be found on the [[https://oembed.com/|oEmbed website]] and [[https://noembed.com/|Noembed]] can provide a consitent inferface for supported and unsupoprted site.
+===== Known issues =====
+The current plugin (as of 2019) has been updated from an old unmaintained version but doesn't use the new plugin skeleton and may not be fully compatible with current/future versions of DokuWiki.
+Any known issues are on [[https://github.com/zzkt/dokuwiki-oembed/issues|github]].
-[[http://liqd.org/wiki/oembed|Details and Download]]