ウィジェット コネクタ マクロを挿入する

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

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

  • YouTube

  • Vimeo

  • Flickr

  • Twitter

  • Slide Rocket

Google Drive ファイルをページに埋め込む場合は、Google Drive マクロのいずれかを代用します。

ウィジェット コネクタを使用する

ウィジェット コネクタ マクロを追加するには、次の手順に従います。

  1. 編集時には、ツールバーから を選択します。

  2. 挿入するアイテムを探して選択します

  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。

ウィジェット コネクタ マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。

  2. 編集を選択します。右側のパネルが開きます。

  3. パラメータを修正します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します ()。

パラメーター

説明

Web Site's Widget URL
(url

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

Pixel Height (Value Only)
(height

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

Pixel Width (Value Only)
(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

1 つの写真、セット、またはユーザーのフォトストリームや特定のタグが付いた写真のコレクションを埋め込むことができます。

Vimeoe ビデオを埋め込む最も速い方法は、エディターに URL を貼り付けることです。この操作は、セットやタグで機能します。他の URL については、ウィジェット コネクタ マクロをまずページに追加してから、リンクを URL フィールドに貼り付ける必要があります。 

ブラウザのアドレス バーで URL を使用します。

ウィジェット コネクター マクロが Flickr URL をプレビューする方法を確認する

Twitter

単一のツイートを埋め込むには、ツイートの「詳細」リンクをクリックして、そのツイート固有の URL を取得する必要があります。URL は「https://twitter.com/atlassian/status/346976521250037760」のようになります。

ウィジェット コネクター マクロが Twitter URL を表示する方法を確認する

 

ツイートの動的なリストを埋め込むには、最初に Twitter でウィジェットを作成する必要があります。

  1. Twitter のプロファイル画像をクリックし、設定 > ウィジェットへ移動します

  2. 埋め込みたいツイートを表示するための「検索」ウィジェットを作成します (例えば、ハッシュタグまたはハンドルで検索)。

  3. ウィジェットを保存して [編集] をクリックし、ページ URL を (アドレス バーから) コピーします。
    URL の例: https://twitter.com/settings/widgets/354381809263472640/edit
    Twitter がサイトの HMTL にコピー&ペーストするように指示するコードをコピーしないでください、これはウィジェット コネクターでは動作しません。

  4. Confluence で、ウィジェット コネクターに URL を貼り付けて、URL の最後の /edit を削除します。

ウィジェット コネクター マクロによって、埋め込みツイートのリストがどのように表示されるかを確認する

 

SlideRocket

SlideRocket プレゼンテーションは自動変換されないため、ページにウィジェット コネクタ マクロを追加してから、ビデオの URL を URL フィールドに貼り付ける必要があります。 

SlideRocket プレーヤーの [共有] ボタンから URL を取得できます。

トラブルシューティング

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

ウィジェット コネクターに問題がある場合は、サポート チケットをオープンしてお知らせください。

Wiki マークアップの例

Wiki マークアップは従来のエディタでのみサポートされます。

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

Macro name: widget

マクロ本文: なし。

1 2 3 4 {widget:height=400|width=400|url=http://youtube.com/watch?v=23pLByj_q5U}

その他のヘルプ