Title: Linkbox (リンクボックス) ウィジェット プラグイン

他の記事(タスク、予定、近況などを含む「投稿」のこと)へのリンクを、投稿日、最終更新日、アイキャッチ画像、本文の要約などと共に「カードのように」表示するウィジェットです。

TeamPage の標準のリンクは、例えば DocJp285: リンクを設定する のように、表示されるのは記事 ID とタイトルだけ。シンプルです。

シンプルなものにはシンプルなものなりの魅力がありますが、もし次のようなことを感じたことはありませんか?

このようなことを感じがことがあれば、このプラグインを試してみる価値があるでしょう。





サーバー管理者として TeamPage にログインし、サーバーセットアップ > プラグイン ページ下部の [新規プラグインのインストール] で .zip ファイルを選択してアップロードします。



アップロードされると、インストール済みプラグイン一覧に「@linkbox#plugin_display_name」と表示されます。これは、プラグインの中の日本語ファイルがまだ読み込まれていないために表示されているだけで、TeamPage を再起動して日本語ファイルを読み込むことで解消されます。

I18N エラー

[サーバーセットアップ] > [一般] > [サーバー管理] の [TeamPage の再起動] をクリックして TeamPage を再起動させます。TeamPage クラウド環境では再起動が 2 回必要ですので、1 回目の再起動が完了後にもう一度再起動を行ってください。

再起動が完了したら、サーバーセットアップ > プラグイン のインストール済みプラグイン一覧に [リンク カード ウィジェット] と表示されることを確認します。

インストール完了

以上でインストールは完了です。

使い方



シンプルな書式



半角スラッシュ+ウィジェット名(linkbox)に続いてリンク先記事の ID を記入します。

[[ /linkcard 記事ID ]]


オプション指定の書式



下記のオプションを指定することもできます。

[[ /linkcard entry="記事ID" size="[large]/small" width="[full]/small" desc="この記事は...です。" label="コレ読んで" image="[show]/hide" tag="show/[hide]" ]]


オプションの詳細



entry="TractionID"



記事 ID を指定します。複数の記事を選択するときは半角コンマ記号で区切ります。(例: entry="Hoge1122,Piyo3344,Foo5566"

size="[large]/small"



リンクボックスの「サイズ」を指定します。

Large: アイキャッチ画像が横幅いっぱい 100% で表示されます。記事タイトルはアイキャッチ画像の下に表示され、投稿日、最終更新日、本文の要約が続きます。

Small: 幅 180px のアイキャッチ画像が、記事タイトル、投稿日、最終更新日、本文の要約の左側に表示されます。ブラウザの幅が狭い場合は、「Large」と同じ配置に変化します。

width="[full]/half"



リンクボックスの「幅」を指定します。

Full: リンクボックスは横いっぱいに広がります。

Half: リンクボックスの幅は 50% になり、横に 2 つ並べられます。ブラウザの幅が狭い場合は、幅が 100% となり「Full」と同じ配置になります。

desc="文章ほげほげ..."



リンクボックスは、既定で、リンク先記事の本文の要約(リンク先記事の最初の 144 文字)を表示します。独自の文章に変更したい場合は、この desc= オプションを使って指定してください。

144 文字を超える部分は [続きを読む] リンクとして省略表示されます。サーバー管理者は、プラグイン設定でこの 144 文字のしきい値を変更できます。

label="ラベル文字 or 無し"



リンク先記事タイトルに「関連記事」という見出しラベルが表示されますが、このラベルの表記を変更できます。空白を指定 label="" すると、見出しラベルは非表示になります。

image="[show]/hide"



リンクボックスは、リンク先記事の最初の画像を「アイキャッチ画像」として表示します。表示させたくない場合は image="hide" を指定してください。

tag="show/[hide]"



リンク先記事のタグを表示したい場合は tag="show" を指定してください。(注意: タグが複数ある場合でも tags= ではなく tag= オプションを使います。)

動作例



以下、いくつかのデモを紹介します。

例 (1) サイズ: Large、幅: Full



[[ /linkbox Download1264 ]]




例 (2) サイズ: Large、幅: Half



[[ /linkbox entry="Download1621,Download1644" size="large" width="half" ]]




例 (3) サイズ: Small、幅: Half、見出しラベル「見て! (^_^)」、タグ表示



[[ /linkbox entry="Download1918,Download1925" size="small" width="half" label="見て! (^_^)" tag="show" ]]






Attachments:
install_i18n_error.png
plugin_installed.png
linkbox_image.png
関連記事
参照している (1)
Article: Download2307 (permalink)
Categories: :DocJp:プラグイン
Date: 2019/05/14; 16時53分56秒 JST

Author Name: TeamPage サポート
Author ID: jpbo