ウィジェット コネクタ マクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

ウィジェット コネクター マクロを使用して、オンライン ビデオ、スライドショー、写真ストリームをページに直接埋め込みます。 

マクロは現在、これらのサイトのコンテンツをサポートしています。

  • YouTube
  • Vimeo
  • Twitter
  • Google カレンダー
  • Google Docs
  • Wufoo

It can also display content from these sites, once they have been added to the whitelist:

  • Scribd
  • Flickr (requires Flash)
  • Slideshare (requires Flash)
  • Viddler (requires Flash)


ウィジェット コネクタの使用

ウィジェット コネクタをページに追加するには:

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

オートコンプリートを活用して素早く入力: {」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。

このページの内容:

パラメータ

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

パラメータ

説明

Web サイトのウィジェット URL
(url

これは、外部サイトの URL です。一部のサイトでは、ブラウザのアドレス バーに表示される URL です。他のサイトでは、[共有] または [リンク] ボタンをクリックして URL を取得する必要が出る場合があります。

ピクセルの高さ (値のみ)
(height

ディスプレイの高さ (ピクセル単位)

ピクセル幅 (値のみ)
(width

ピクセル単位で示されるディスプレイの幅。

すべてのサイトは他のサイトとは少し異なりますので、各サイトのコンテンツをページに埋め込むために必要な情報をまとめました。 

YouTube

YouTube ビデオを埋め込む最も速い方法は、エディターに URL を貼り付けることです。Confluence はリンクを自動変換し、マクロを挿入します。 自動変換は YouTube URL が長くても短くても機能します。 

ウィジェット コネクタ マクロの URL フィールドに手動で URL を貼り付ける場合、アドレス バーに表示された長い URL を使用する必要があります。長い URL は次のようになります: https://www.youtube.com/watch?v=k6lK5hlB1nQ

  • 同じブラウザでビデオを表示できない場合は、リンクに http ではなく https を使用してください。
  • 特定の時間にビデオを開始するパラメーターを含むリンクは、ウィジェット コネクタ マクロで自動変換されず、動作もしません (例: https://www.youtube.com/watch?t=15&v=LhHKkodOPFo)。動作させるようにするには、短い共有 URL として貼り付けます。


Vimeo

Vimeoe ビデオを埋め込む最も速い方法は、エディターに URL を貼り付けることです。Confluence はリンクを自動変換し、マクロを挿入します。 

ブラウザのアドレス バーから URL を入力するか、Vimeo の 共有 ボタンを使用できます。

Flickr

You can embed albums (formerly known as sets) and tags. You can't embed individual photos or user photostreams. 

You'll need to add the Widget Connector macro to the page first and then paste your link into the URL field. Use the URL from the address bar in your browser.

The Widget Connector uses Flash to display this content. For security reasons, Flash is disabled in most modern browsers. 

Twitter

1 つのツイートを埋め込むには、ツイートの [ツイートへのリンクをコピーする] をクリックします。URL は次のようになります: https://twitter.com/atlassian/status/346976521250037760

Twitter でウィジェットの動作が変更されたため、現在、ツイートのリストを埋め込むことはできません。 

ツイートのリストを表示するための回避策として、HTML Macro を有効化してから、https://publish.twitter.com/ を使用して埋め込みコードを生成します。 

Google カレンダー

We don't autoconvert Google Calendars, so you'll need to add the Widget Connector macro to your page first, and then paste the calendar address into the URL field. 

パブリックカレンダーのみを埋め込むことができます。カレンダーの URL を取得するには、Google Calendar で カレンダー設定 > カレンダー アドレスに移動し、HTML ボタンをクリックします。 

URL は次のようになります: https://www.google.com/calendar/embed?src=en.australian%23holiday%40group.v.calendar.google.com&ctz=Australia/Sydney

トラブルシューティング

ウィジェット コネクタが外部サイトのコンテンツを表示できない場合、マクロは次のようになります。

外部 Web サイトの API に依存し、ウィジェット コネクタ マクロのコンテンツを表示しています。API は時折変更されます。これによりウィジェット コネクタ マクロがコンテンツのレンダリングを停止する場合があります。 

If you experience problems, you can raise an issue about it to let us know. 

Some sites must be whitelisted

The following sites need to be added to Confluence's whitelist before the macro can display any content. This is due to the way we need to connect to that site. 

  • Scribd
  • Flickr 
  • Slideshare 
  • Viddler

Some content requires Flash

The Widget Connector requires Flash for Flickr, Slideshare, and Viddler. This is blocked by most modern browsers due to security concerns. We don't recommend you enable the Flash plugin in your browser. 

Wiki マークアップの例

以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。

マクロ名: widget

マクロ本文: なし。

{widget:height=400|width=400|url=http://youtube.com/watch?v=23pLByj_q5U}
最終更新日 2019 年 9 月 9 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.