collective.oembed 2.0.1

简介

此插件将oembed集成到Plone中。您可以在http://youtu.be/kHikGIWrvCs找到演示。

oEmbed官方文档：http://oembed.com/

您需要知道此插件试图超越已支持的网站，尽可能多地集成提供者，而不使用第三方服务。

如何安装

此插件可以像其他插件一样安装。请遵循官方文档。

oembed提供者

您的网站将使用@@oembed视图作为端点成为oembed提供者

URL Scheme: http://mysite.com/*
API endpoint: http://mysite.com/@@oembed
Supports discovery via <link> tags

此插件使用archetypes getPrimaryField获取您内容类型的最具代表性的字段，然后构建嵌入此内容的详细信息

要更改此行为，您可以覆盖特定上下文中的视图

<browser:page
    name="oembed"
    for="my.specific.context.IMYContent"
    class="my.specific.provider.OEmbedProvider"
    permission="zope2.View"
    layer="my.specific.layer.Layer"
    />


from collective.oembed.provider.
class OEmbedProvider(OEmbedProvider):
    def add_context_info(self, ob, site):
        self.embed['type'] = 'rich'
        ...

oembed客户端

此插件提供jquery.oembed插件的集成。由于存在许多分支，您必须选择您要使用的一个。官方插件已通过插件collective.js.oembed集成到plone中。

oembed客户端是通过一个默认未激活的viewlet集成的。您需要通过控制面板来激活它。它就是这样配置的

<script type="text/javascript">
  jqueryOmebedSettings = {...} //extracted from the controlpanel
</script>
<script type="text/javascript">
        $(document).ready(function() {
            $(".oembed").oembed(null,jqueryOmebedSettings);
        });
</script>

消费者

消费者可以通过一个实用工具获得

>>> url = "http://www.youtube.com/watch?v=it1hMtZKle8"
>>> consumer = component.getUtility(collective.oembed.interfaces.IConsumer)
>>> consumer.get_data(url, maxwidth=300, maxheight=None, format='json')
{...}

还有一个@@collective.oembed.consumer视图，它可以通过属性传递参数

>>> consumer_view = component.queryMultiAdapter((self.context,self.request),
...                                 name=u'collective.oembed.consumer')
>>> consumer_view._url = url
>>> consumer_view.embed_auto()
<div class="oembed-wrapper oembed-video">...</div>

OEmbed链接视图

此插件将oembed视图注册到链接内容类型。它显示来自远程URL提供的内容，不设置最大宽度和最大高度。这应由集成商实现。

链接视图存储3个不同的组件列表

• oembed

• api2embed

• url2embed

While the returned data will be sufficient to embed the target
widget in your view, you won't be able to access the metadata which
could have been associated with it in a straight oEmbed format.

Embed.ly

此插件可以使用embed.ly服务。您可以在控制面板中设置embed.ly API密钥，或安装和配置collective.embedly，此插件将使用此提供的配置。

提供者

只有当您添加了api_key或配置了collective.embedly时，embed.ly才会被激活。插件为以下服务提供原生支持

外部提供者

• Embedly (http://embed.ly)

视频提供者

• 5min (http://www.5min.com/)

• Youtube (http://www.youtube.com/)

• Qik (http://qik.com/)

• Revision3 (http://revision3.com/)

• Hulu (http://www.hulu.com/)

• Vimeo (http://vimeo.com/)

• CollegeHumor (http://www.collegehumor.com/)

• Kinomap (http://wwww.kinomap.com/)

• Dailymotion (http://www.dailymotion.com/)

• Clikthrough (http://clikthrough.com)

• Dotsub (http://dotsub.com/)

• Vhx.tv (http://vhx.tv) 注意：仅适用于分享的专用URL

• Nfb.ca (http://http://www.nfb.ca/)

• Wordpress TV (http://wordpress.tv/)

• Screenr (http://screenr.com/)

照片提供者

• 23hq (http://www.23hq.com/)

• Flickr (http://www.flickr.com/)

• SmugMug (http://www.smugmug.com/)

• Photobucket (http://photobucket.com)

• Instagr (http://instagr.am/)

• Picasa (https://picasa.google.com/)

丰富提供者

• Occipital (http://360.io)

• iFixit (http://www.iFixit.com)

• Apple (http://itunes.apple.com)

• Poll Everywhere (http://www.polleverywhere.com/)

• SlideShare (http://www.slideshare.net/)

• WordPress (http://wordpress.com/)

• Official.FM (http://official.fm)

• Gist Github (https://gist.github.com)

• Google Calendar (https://www.google.com/calendar)

• 谷歌文档 (https://docs.google.com/)

• 谷歌地图 (http://maps.google.com)

• Issuu (http://issuu.com)

• Scribd (http://www.scribd.com)

• SoundCloud (http://soundcloud.com/)

• Spotify (http://open.spotify.com/)

代理OEmbed端点

此插件提供消费者和提供者。两者可以在代理OEmbed端点同时使用。这意味着你可以询问你的网站如何显示URL，无论它是来自网站本身还是来自外部。

其他Plone插件

• collective.portlet.oembed

• collective.js.oembed

• collective.embedly

插件设计（针对2.0版本）

2.0版本完全重写了内部代码

目标

• 代码更容易理解

• 组件更少

• 性能优化

提供的集成仅通过ajax请求使用json。

我们有一个主要视图实现这一功能：@@proxy-oembed-provider

该视图使用基于以下内容的ram缓存和缓存键：* url + 最大宽度 + 最大高度 * 1小时（如果远程HTML已更改）

存在一个结构键/值，以主机名作为键，以低级别消费者名称作为值。这些值在需要时实例化（懒加载），因此它使用更少的内存。

致谢

公司

• Planet Makina Corpus

• 联系我们

作者

• JeanMichel FRANCOIS（又名toutpt）<toutpt@gmail.com>

贡献者

• Raphael Gaziano（又名raphigaziano）<r.gaziano@gmail.com>

• Alejandro Pereira（又名aleGpereira）<alepereira86@gmail.com>

• Sylvain Bouchard（又名bouchardsyl）<sylvain.bouchard@savoirfairelinux.com>

变更日志