通貨

通貨ウィジェットでは、多くの通貨ペアの為替レートが表示できます。

インストール

通貨ウィジェットは、為替レートを取得するためにAlpha Vantage API利用しています。 インストールする前に、APIキーが必要です。Alpha Vantageでアカウントを作成し、キーを取得してください。

通貨モジュールは、メニューの管理セクションにある「モジュール」ページからインストールします。モジュールをインストールボタンをクリックし、インストールするモジュールを選択します。

インストール後、グリッドからモジュールを選択し、行メニューから 編集 を選択します。

フォームに必要事項を入力し、APIキーとキャッシュの設定をしてください。

Add Widget

ウィジェットツールバーの通貨をクリックし、追加またはドラッグ＆ドロップします。Currencies Widget

追加すると、設定オプションがプロパティパネルに表示されます。

  • 識別しやすいように 名前 を記入してください。
  • 必要であれば、デフォルトの期間をオーバーライドするよう選択します。
  • アイテムごとに継続時間を設定するか、フィードごとに継続時間を設定する場合はチェックを入れないままにしておきます。

設定

Currencies Configuration

  • 通貨の定義には、その頭字語/略語を使用します（記号や文字列は認識されません）。
  • 基本通貨を入力してください。
  • 基準通貨を比較対象として使用する場合は、逆変換を選択してください。

外観

  • オプションで背景色**を追加することができます。
  • 返された結果に適用する PHP の 日付形式 を指定します(日付形式については、ページの下部を参照してください)。
  • 項目間の遷移に使用するエフェクトと速度をオプションで選択します。
  • このウィジェットの水平方向と垂直方向の配置オプションを設定します。

テンプレート

利用可能なテンプレートから選択します。

  • プリセット - ドロップダウンで、プリセットテンプレートの1つを選択します。

    Preset Templates

    必要であれば、選択したテンプレートを上書きするをクリックします。 詳しくは、後述のプリセットテンプレートの編集の項をご覧ください。

  • レコードなし時のメッセージ 返されたレコードがないときに表示するメッセージを指定します。

プリセットテンプレートの編集

テンプレートは、ドロップダウンでテンプレートを選択し、テンプレートを上書きのチェックボックスをクリックすることで編集することができます。

テンプレートは自動的に拡大縮小されるため、意図した出力解像度に合わせた設計が必要です。テンプレートを編集する際には、以下のガイドラインを考慮する必要があります。

  • テンプレートは一定の大きさでデザインすること
  • フォント、マージン、幅、高さなど、すべての要素でpx単位の絶対サイズ指定が必要です。
  • 位置決めを行う場合は、上、左から順に行う。
  • テンプレートはbootstrapを使用することができます
  • アスペクト比はSigmeで固定され、リージョンに合わせたサイズに調整されます。
  • テンプレートは静止画と同じ扱いになります

上書きを選択したら、テンプレートタブに戻り、編集するテンプレートを選択します。

Currencies Override the Template

メイン - テキストとフォーマットを入力するインラインエディタにアクセスするためにビジュアルエディタをトグル オン または提供されたボックスでテキスト/ HTMLを入力します。

項目 - 各項目に適用されるテンプレートを入力し、ビジュアルエディタを使用するか、または提供されたボックス内のテキスト/ HTMLを入力します。

オプションのスタイルシート - これは、テンプレート構造に適用するCSSです。

このオプションのテンプレートは、CMSが生成する出力を「調整」する上級ユーザー向けのものです!

キャッシュ

更新間隔は、できるだけ長く、適切な時間を分単位で設定します。

結果

いつでも結果を取得し、どのようなデータが返されるかを確認することができます。どのフィールドも、角括弧 [] の間にフィールド名を入力するだけで、テンプレートでの変数として利用できます

アクション

このWidgetにはアクションを付けることができます。詳しくは[ 対話型アクション ]（layouts_interactive_actions.html）のページを参照してください。

補足情報

Sigmeは、正しいPHPの日付形式であるすべての日付形式を受け入れる必要があります。次の文字が認識され、使用できます。

フォーマット文字 説明 返される文字の例
日
d ゼロから始まる２桁の日付 01 から 31
D 日を表すテキスト, ３文字 Mon から Sun
j ゼロをつけない日付 1 から 31
l (小文字‘L’) 日を表す完全な文字列 Sunday から Saturday
N ISO-8601で定義された曜日を表す数字(PHP 5.1.0で追加された) 1 (月曜日) から 7 (日曜日)
S 日にちに対する英語の序数サフィックス、2文字 st, nd, rd または thとともに使われる
w 曜日の数字表現 0 (Sunday) から 6 (Saturday)
z 年初からの日（0から始まる) 0 から 365
週
W ISO-8601で規定する週の数字, 週は月曜日から始まる(PHP 4.1.0で追加) 42 (一年の中の４２週目)
月
F 月のテキスト表現, January や March January から December
m ゼロで始まる月の数字表現 01 から 12
M 月の短いテキスト表現、３文字 Jan から Dec
n 月の数字表現、先頭にゼロはつかない 1 から 12
t 月の日数 28 から 31
年
L うるう年かどうか year 1 うるう年, 0 それ以外.
o ISO-8601できていされた年. これはYと同じ値です。ただし、ISOの週番号（W）が前後の年に属している場合は、その年が代わりに使用されます。(PHP 5.1.0で追加) 1999 または 2003
Y 年の４桁数字表現 1999 または 2003
y 年の２桁数字表現 99 or 0
時間
a 小文字アンティメリディアムとポストメリディアム am または pm
A 大文字アンティメリディアムとポストメリディアム AM または PM
B スウォッチインターネット時間 000 から 999
g 先行ゼロなしの時間の12時間形式 1 から 12
G 先行ゼロなしの時間の24時間形式 0 から 23
h 先行ゼロありの時間の12時間形式 01 から 12
H 先行ゼロありの時間の２４時間形式 00 から 23
i 先行ゼロ付き分 00 から 59
s 先行ゼロ付き秒 00 から 59
u マイクロ秒（PHP 5.2.2で追加） DateTimeがマイクロ秒で作成された場合、DateTime :: format（）はマイクロ秒をサポートする>のに対して、date（）は常に000000を生成します。 654321
タイムゾーン
e タイムゾーン識別子（PHP 5.1.0で追加） UTC, GMT, Atlantic/Azores
I （大文字のi）日付が夏時間であるかどうか 夏時間の場合は1、それ以外の場合は0です。
O グリニッジ時間（GMT）との時差 +0200
P グリニッジ標準時（GMT）と時間と分の間の差（PHP 5.1.3で追加） +02:00
T タイムゾーンの略語 EST, MDT …
Z 秒単位のタイムゾーンオフセット。 UTCより西のタイムゾーンのオフセットは常に負で、UTCより東のタイムゾーンのオフセットは常に正です。 -43200 through 50400
フル日付/時刻
c ISO 8601 日付（PHP 5で追加） 2004-02-12T15:19:21+00:00
r » RFC 2822 フォーマット日付 Thu, 21 Dec 2000 16:01:07 +0200