株式
株式ウィジェットでは、掲載されている銘柄の取引価格情報を表示します。
インストール
株式ウィジェットは、株式市場のデータを取得するためにAlpha Vantage Stock APIを利用しています。Alpha Vantageが返す株価は、以下の標準に従っています。 株式市場の標準に従って、分割や配当金支払いなどの企業イベントを反映した価格を返します。
インストールする前に、APIキーが必要です。Alpha Vantageでアカウントを作成し、キーを取得してください。
株式モジュールは、メニューの管理セクションにあるモジュールページよりインストールします。モジュールをインストールボタンをクリックし、インストールするモジュールを選択します。
インストール後、グリッドからモジュールを選択し、行メニューから編集を行います。
フォームのフィールドに入力し、APIキーとキャッシュ期間の設定を入力します。
ウィジェットを追加
ウィジェットツールバーの株式をクリックし、追加またはドラッグ＆ドロップしてください。
追加すると、設定オプションがプロパティパネルに表示されます。
- 識別しやすいように 名前 を記入してください。
- 必要であれば、デフォルトの期間を上書きすることを選択します。
- 項目ごとの継続時間かどうかを選択し、チェックを外すとページ/項目数ごとの継続時間となります。
設定
- 結果を返すために、カンマで区切られた株式シンボル（ティッカー）のリストを入力してください。
もし、特定の取引所でのみ取引されている銘柄記号が必要な場合は、
SYMBOL:EXCHANGEというフォーマットを使って結果を返すことができます。
株式記号は、Yahooファイナンスなどの各種検索サイトで確認することができます!
外観
- オプションで、カラーピッカーを使用して背景色を選択します。
- 返された結果に適用する PHP の 日付形式 を指定します(日付形式については、ページの下部を参照してください)。
- 項目間の遷移に使用するエフェクトと速度をオプションで選択します
このウィジェットの水平方向と垂直方向のアライメントオプションを設定します。
テンプレート
利用可能なテンプレートから選択します。
- プリセット - ドロップダウンでプリセットテンプレートの1つを選択します。
必要であれば、選択したテンプレートを上書きするをクリックします。 詳しくは、後述の「プリセットテンプレートの編集」の項をご覧ください。
- レコードなしメッセージ 返されたレコードがないときに表示するメッセージを指定します。
プリセットテンプレートを編集
テンプレートは、ドロップダウンでテンプレートを選択し、テンプレートを上書きのチェックボックスをクリックすることで編集することができます。
テンプレートは自動的に拡大縮小されるため、意図した出力解像度に合わせた設計が必要です。テンプレートを編集する際には、以下のガイドラインを考慮する必要があります。
- テンプレートは固定サイズで設計する必要があります
- フォント、マージン、幅、高さなど、すべての要素で絶対サイズ（px）を使用する必要があります。
- 位置指定がある場合は、top,left で指定する必要があります。
- テンプレートはブートストラップを使用することができます
- 縦横比はSigmeで固定され、リージョンに合わせたサイズになります。
- テンプレートは静止画像と同じように扱われます。
上書きを選択した後、テンプレートタブをクリックして編集するテンプレートを選択します。
!!
メインテンプレート - ビジュアルエディタをオンにすると、インラインエディタにアクセスしてテキストや書式を入力したり、提供されたボックスにテキスト/HTMLを入力したりすることができます。
項目テンプレート - 各項目に適用するテンプレートを入力します。ビジュアルエディタを使用するか、テキスト/HTMLをボックス内に入力します。
オプションのスタイルシート - 上記のテンプレートに適用するCSSです。
このオプションのテンプレートは、CMSが生成する出力を「調整」する上級ユーザー向けのものです!
キャッシュ
更新間隔は、できるだけ長く、適切な時間を分単位で設定します。
結果
いつでも結果を取得し、どのようなデータが返されるかを確認することができます。どのフィールドも、角括弧 [] の間にフィールド名を入力するだけで、テンプレートで使用する代用品として利用できます。
アクション
このウィジェットにはアクションを付けることができます。詳しくは、対話型アクションのページを参照してください。
補足情報
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 (一年の中の42週目) |
| 月 | ||
| F | 月のテキスト表現, January や March | January から December |
| m | ゼロで始まる月の数字表現 | 01 から 12 |
| M | 月の短いテキスト表現、３文字 | Jan から Dec |
| n | 月の数字表現、先頭にゼロはつかない | 1 から 12 |
| t | 月の日数 | 28 から 31 |
| 年 | ||
| L | うるう年かどうか | 1 うるう年, 0 それ以外. |
| o | ISO-8601できていされた年. これはYと同じ値です。ただし、ISOの週番号（W）が前後の年に属している場合は、その年が代わりに使用されます。(PHP 5.1.0で追加) | 1999 または 2003 |
| Y | 年の４桁数字表現 | 1999 または 2003 |
| y | 年の２桁数字表現 | 99 or 0 |