ウィジェット コネクタ マクロ
ウィジェット コネクター マクロを使用して、オンライン ビデオ、スライドショー、写真ストリームをページに直接埋め込みます。
マクロは現在、これらのサイトのコンテンツをサポートしています。
- YouTube
- Vimeo
- Google カレンダー
- Google ドキュメント
- Wufoo
これらのサイトについては、ホワイトリストに追加することでコンテンツを表示できます。
- Scribd
- Flickr (Flash が必要)
- Slideshare (Flash が必要)
- Viddler (Flash が必要)
ウィジェット コネクタの使用
ウィジェット コネクタをページに追加する方法
- エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートを活用して素早く入力: 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
On this page:
パラメーター
パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
パラメーター | 説明 |
---|---|
Web サイトのウィジェット URL | これは、外部サイトの URL です。一部のサイトでは、ブラウザのアドレス バーに表示される URL です。他のサイトでは、[共有] または [リンク] ボタンをクリックして URL を取得する必要が出る場合があります。 |
ピクセルの高さ (値のみ) | ディスプレイの高さ (ピクセル単位) |
ピクセル幅 (値のみ) | ピクセル単位で示されるディスプレイの幅。 |
例
すべてのサイトは他のサイトとは少し異なりますので、各サイトのコンテンツをページに埋め込むために必要な情報をまとめました。
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
アルバム (旧称: セット) とタグを埋め込むことができます。個々の写真やユーザーのフォトストリームを埋め込むことはできません。
ウィジェット コネクタ マクロをページに追加してから、リンクを URL フィールドに貼り付ける必要があります。ブラウザのアドレス バーの URL を使用します。
ウィジェット コネクタは Flash を使用してこのコンテンツを表示します。セキュリティ上の理由から、モダンなブラウザのほとんどで Flash は無効になっています。
1 つのツイートを埋め込むには、ツイートの [ツイートへのリンクをコピーする] をクリックします。URL は次のようになります: https://twitter.com/atlassian/status/346976521250037760
Twitter でウィジェットの動作が変更されたため、現在、ツイートのリストを埋め込むことはできません。
ツイートのリストを表示するための回避策として、HTML Macro を有効化してから、https://publish.twitter.com/ を使用して埋め込みコードを生成します。
Google カレンダー
Google カレンダーの自動変換は行われないため、ページにウィジェット コネクタ マクロを追加してから、カレンダーのアドレスを URL フィールドに貼り付ける必要があります。
パブリックカレンダーのみを埋め込むことができます。カレンダーの 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 は時折変更されます。これによりウィジェット コネクタ マクロがコンテンツのレンダリングを停止する場合があります。
問題が発生した場合、課題を起票してお知らせください。
ホワイトリストに追加する必要があるサイトについて
次のサイトについては、マクロでコンテンツを表示する前に、Confluence のホワイトリストに追加する必要があります。これは、製品からサイトへの接続方法によるものです。
- Scribd
- Flickr
- Slideshare
- Viddler
一部のコンテンツには Flash が必要
ウィジェット コネクタでは、Flickr、Slideshare、および Viddler に Flash が必要です。これセキュリティ上の理由から、モダンなブラウザのほとんどでブロックされています。ブラウザで Flash プラグインを有効にすることはおすすめしません。
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: widget
マクロ本文: なし。
{widget:height=400|width=400|url=http://youtube.com/watch?v=23pLByj_q5U}