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

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

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

  • YouTube

  • Vimeo

  • Flickr

  • Twitter

  • Slide Rocket

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

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

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

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

  2. マクロを名前で検索して選択します。

  3. 必要に応じて設定します。

このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

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

  1. マクロのプレースホルダーを選択します。

  2. [編集] アイコン を選択して、設定パネルを開きます。

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

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

中央揃え アイコン、幅 アイコン、全幅 アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱 アイコンを選択します。

パラメーター

パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。 

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

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

マクロ名: widget

マクロ本文: なし。

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

その他のヘルプ