Atlassian产品培训知识库
空间快捷链接
页面树结构
Skip to end of metadata
Go to start of metadata

组件宏或者组件连接器宏，允许你向 Confluence 页面中嵌入其他网站的多媒体内容。

这个组件支持下面的一些内容：

小工具和其他的组件： Google Gadgets, Widgetbox.
视频： YouTube, MySpace Video, Yahoo Video, Dailymotion, Episodic, Vimeo, Metacafe, blip.tv,Viddler.
照片和图片： Flickr, Skitch.com.
微博： Twitter, FriendFeed, BackType.
文档和演示文稿： SlideShare, SlideRocket, Scribd, Google Docs 显示的演示文稿。注意：当前有关 Google Doc 的组件已经损坏不能使用。请参考 CONF-24927 有关这个问题的详细信息。
日历：Google Calendar.
表单和在线数据库： Wufoo HTML Form Builder and Wufoo Reports.
支持和客户反馈： Get Satisfaction.
有关支持组件在页面中的实际应用，请参考页面 组件（Widget）连接器实例 中的内容。如果你希望对这个功能进行扩展的话，请参考 扩展组件连接器 页面中的内容。

使用组件连接器宏

希望在页面中使用组件连接器宏：


  1. 打开你希望编辑 Confluence 页面，然后单击 编辑（Edit）按钮。页面的编辑模式将会被打开。
  2. 下一步，在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
  3. 在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击 插入（insert）来将需要的宏插入到页面中。


参数

宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(example)。


参数

说明

组件的 URL （Web Site's Widget URL）
(url) 

外部网站提供的 URL，宏将会使用这个 URL 获取内容后将内容嵌入到页面中。

高度像素（Pixel Height）
(height) 

指定高度的像素，这里只能输入值，使用的是像素值，不能使用百分比。

宽度像素（Pixel Width）
(width) 

指定宽度的像素，这里只能输入值，使用的是像素值，不能使用百分比。

实际使用案例


Google 小工具

你需要找到你希望显示的 Google 小工具 URL 地址。

下面是找到这个地址的相关方法：

  1. 进入 Google 小工具目录.
  2. 找到你希望插入到页面的小工具地址，通过单击名字，例如 'Spider'。

  3. 这个小工具的摘要信息将会在页面中显示出来。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://www.google.com/ig/directory?synd=open&num=24&url=http://abowman.googlepages.com/spider.xml&output=html

你也可以使用添加小工具页面中的 URL。这个页面在 iGoogle 页面中被称为 'Add "gadgetx" to your iGoogle page'。

  1. 有下面的一些步骤将小工具添加到页面中。
    • 在小工具下面单击 '+Google' 按钮。
    • 或者单击 'Add Stuff' 在你的 iGoogle 页面中。

  2. 从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://www.google.com/ig/adde?synd=open&source=ggyp&moduleurl=abowman.googlepages.com/spider.xml


Widgetbox 组件

你需要为 Widgetbox 组件找到你希望显示的 URL。

这里是找到这个 URL 的一个方法：

  1. 请确定你已经登录到 Widgetbox 然后查看 Widgetbox Gallery。
  2. 找到你希望的小工具，然后单击名字，例如  'cyber-pet'。
  3. 小工具的摘要页面将会打开。在获得小工具部分，单击  Atlassian Confluence 图标 。Widgetbox 添加到 Confluence （Add to Confluence）对话框将会显示出来。这里面包含了显示需要的 URL 地址。
    (信息) 如果你不能找到这个图标，单击 更多（more...） 来找到这个。
  4. 在 Widgetbox 的添加到 Confluence 对话框，然后单击拷贝。

  5. 从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://widgetbox.com/confluence/b8327e33-c8eb-4a38-b842-fba866ffdd28


YouTube 视频分享网站

你需要从 Youtube 中找到你需要显示视频的 URL。

希望找到 Youtube 需要显示的视频：

  1. 导航到 YouTube 网站，然后查找你需要的视频。
  2. 单击视频的标题。

  3. 视频的概要页面将会显示出来，在这个时候选择 分享（Share）。

  4. 选择 选项（Options），在视频的 URL 下面。

  5. 选择 长连接（Long link）然后拷贝这个连接。这个 URL 地址看起来像下面的格式：

    http://au.youtube.com/watch?v=-dnL00TdmLY


    注意：在 Youtube 中，你必须使用长链接。Youtube 的短链接不能在组件连接器中正常使用。Youtube 的短链接如下格式: http://www.youtu.be/<video_key>。如果你的视频不能够正常的显示，你可以尝试使用 https 替代掉 http。



MySpace 视频

你需要从 MySpace 视频 中找到你需要显示视频的 URL。

希望找到 MySpace 需要显示的视频：

  1. 导航到 MySpace Video 网站，然后查找你希望显示的视频。
  2. 单击视频的标题。

  3. 视频的概要页面将会显示出来。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://vids.myspace.com/index.cfm?fuseaction=vids.individual&videoid=3376248&searchid=20c789f6-1ae9-459a-bfec-75efcfc2847c


Yahoo 视频

你需要从 Yahoo 视频 中找到你需要显示视频的 URL。

希望找到 Yahoo 需要显示的视频：

  1. 导航到 Yahoo Video 网站，然后查找你希望显示的视频。
  2. 单击视频的标题。

  3. 视频的概要页面将会显示出来。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://video.yahoo.com/watch/423158/2424140

    (信息) 如果你不能从浏览器的地址栏中获得唯一的 URL 地址，单击 信封图标（Share），这个通常位于视频屏幕下部，然后拷贝链接字段中的内容。


Dailymotion 视频

你需要从 Dailymotion 视频 中找到你需要显示视频的 URL。

希望显示 Dailymotion 需要显示的视频：

  1. 导航到 Dailymotion 网站，然后查找你希望显示的视频。
  2. 单击视频的标题。

  3. 视频的概要页面将会显示出来。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://www.dailymotion.com/user/spacevidcast/video/x7zevj_spacevidcast-2009-promo-video_tech

    (信息) 如果你不能从浏览器的地址栏中获得唯一的 URL 地址，单击 菜单图标（Menu ）这个通常位于视频屏幕下部。选择 URL & Embed Code 然后拷贝链接字段中的内容。


Episodic 视频

你需要从 Episodic 视频 中找到你需要显示视频的 URL。

希望显示 Episodic  需要显示的视频：

  1. 找到你需要的视频，然后从浏览器中直接拷贝 URL。这个 URL 地址看起来像下面的格式：

    http://app.episodic.com/shows/13/episodes/493
  2. 粘贴这个 URL 到宏浏览器的组件 URL 框中。


Vimeo 视频

你需要从 Vimeo 视频 中找到你需要显示视频的 URL。

希望显示 Vimeo 需要显示的视频：

  1. 导航到 Vimeo 网站，然后查找你希望显示的视频。
  2. 单击视频的标题。

  3. 视频的概要页面将会显示出来。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://www.vimeo.com/909808


Metacafe 视频

你需要从 Metacafe 视频 中找到你需要显示视频的 URL。

希望显示 Metacafe 需要显示的视频：

  1. 导航到 Metacafe 网站，然后查找你希望显示的视频。
  2. 单击视频的标题。

  3. 视频的概要页面将会显示出来。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://www.metacafe.com/watch/679493/wikis_in_plain_english_how_to/


blip.tv

当前有关组件已经损坏不能使用。请参考 CONF-27266 来获得详细信息。


Viddler

当前有关组件已经损坏不能使用。请参考 CONF-27267 来获得详细信息。


Flickr

你可以从 Flickr 提供的 URL 中将图片嵌入到页面中，使用下面的类型：

  • 照片指定了 标签（tag）。
  • 照片指定了特定的 Flickr 用户。
  • 特定用户的照片。
  • 用户照片流中的特定照片。

如果你希望使用其他什么内容，我们建议你尝试使用 Flickr 的 URL。这个应该是可以工作的。

下面是有关 Flickr 图片宏代码的示例。

Flickr 指定标签的照片

找到照片被标记为 'Atlassian' 的链接： http://www.flickr.com/photos/tags/atlassian/

Flickr 指定用户的照片

找到照片属于用户 'Atlassian' 的链接：http://www.flickr.com/photos/atlassian/

Flickr 指定集合的照片

找到照片属于用户 'Atlassian' 用户和 'Melbourne Cup - November 2008' 集合： http://www.flickr.com/photos/atlassian/sets/72157608657271078/

Flickr 指定的一系列照片

找到照片属于用户 'Atlassian' 用户和特定的相片： http://www.flickr.com/photos/atlassian/3003538919/


Skitch.com

你可以从 Skitch 提供的 URL 中将图片嵌入到页面中。

希望在 Confluence 页面中嵌入 Skitch ：

  1. 访问 Skitch.com 网站。

  2. 找到需要显示的图片。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://skitch.com/atlassian/411g/example-image

注意： 

Skitch 现在已经整合到 Evernote 中，正如下面博客中描述的内容一样：Evernote is bringing Skitch into its core service, Skitch.com will be archived。 Skitch.com 私人图片不再访问，不会在 Confluence 部件连接器一起工作。但是 Skitch.com 现有公共图片将保持可用。



Twitter

说明： 基于 Twitter API 的近期修改，显示 Twitter 的内容将会有所修改。下面的指南是针对 v 2.1.6 的 组件连接器插件。有关 Twitter 的组件连接器将不能够在 Tweets 中正确显示了。

希望嵌入一个单一微博：

  1. 在 Twitter 中，导航到你希望嵌入的微博页面，然后单击细节来在浏览器中显示。
  2. 拷贝页面的 URL，URL 应该看起来像下面的格式：https://twitter.com/atlassian/status/346976521250037760
  3. 在 Confluence 中粘贴 URL 到组件连接器中。
  4. 单一的微博显示的内容如下。

希望子页面中嵌入整个微博动态列表：

  1. 在 Twitter 页面中，选择 Widget （进入 Settings > Widgets）。 
  2. 配置你希望嵌入的微博的显示组件。
  3. 保存组件，然后拷贝页面的 URL ，URL 应该看起和下面的格式是这样的  https://twitter.com/settings/widgets/354381809263472640/edit
  4. 在 Confluence 页面中，粘贴 URL 到组件连接器中。
  5. 在 Twitter 列表，显示的结果如下。


FriendFeed

从  FriendFeed 用户显示最新的消息。添加用户的 FriendFeed 链接到组件连接器宏中。


BackType

从  BackType 用户显示最新的消息。添加用户的 BackType 链接到组件连接器宏中。


SlideShare 文档在线阅读

你可以使用 SlideShare 文档的 URL 在 Confluence 页面中显示可读的文档。

希望显示 SlideShare 需要显示的文档：

  1. 你需要从 SlideShare 网站中中找到你需要显示视频的 URL。
  2. 单击文档的标题。

  3. 文档的概要将会显示出来。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://www.slideshare.net/jleyser/using-jira-greenhopper-for-agile-development-presentation


SlideRocket

你可以使用 SlideRocket 文档的 URL 在 Confluence 页面中显示可读的文档。

希望显示 SlideShare 需要显示的文档：

  1. 登录 SlideRocket 页面中，然后找到你的文档库。

  2. 拷贝你希望显示的网页链接。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://app.sliderocket.com/app/FullPlayer.aspx?id=132f9db7-b0fb-4f51-b974-36652774971b
  3. 粘贴 URL 链接到你的组件连接器宏中。


Scribd 文档

你可以使用 Scribd 文档的 URL 在 Confluence 页面中显示可读的文档。

找到你希望显示文档的 URL：

  1. 登录 Scribd 网站，然后找到你需要显示的内容。
  2. 单击文档的标题。

  3. 文档的概要将会显示出来。从浏览器中拷贝这个页面的 URL 地址。这个 URL 地址看起来像下面的格式：

    http://www.scribd.com/doc/5683554/My-Sea-Friends-Coloring-Book
  4. 粘贴 URL 链接到你的组件连接器宏中。


  • 无标签