Twitterモジュールは、Twitter検索APIへのアクセスを提供します。Twitterウィジェットをレイアウトに追加することで、Twitterのフィードを表示することができます。
許可されたアクセスは、データの読み取りのみです。
インストール
Twitter APIへのアクセスは保護されているため、ユーザーはAPIキーを登録し、それをSigme内のTwitterモジュールに入力する必要があります。CMSに入力します。
Twitterへの接続
- TwitterからAPIキーとAPIシークレットを取得し、Twitterアカウントにログインしてください。
注意まだ承認されていない場合は、上記のTwitterのリンクからTwitter開発者アカウントを申請する必要があります。
- 必要事項を入力し、利用規約に同意してください。
- CAPTCHAを解き、フォームを送信してください。
- 生成されたコンシューマーキー（APIキー）、コンシューマーシークレット（APIシークレット）をメモしておきます。
Twitterモジュールをインストール
- 管理セクションのモジュールページを選択し、Twitterモジュールをインストールします。
- インストール後、Twitterモジュールの行メニューをクリックし、編集をクリックしてください。
- 生成されたAPIキーとAPIシークレットを入力してください。
- オプションでキャッシュ期間を調整し、各Twitter検索の結果セットをキャッシュする期間を決定します。
低い値を設定すると、リクエストが多すぎるため、Twitter APIへのアクセスが無効になることがあります。
ウィジェットを追加
ウィジェットツールバーからTwitterをクリックし、追加またはドラッグ＆ドロップします。
追加すると、設定オプションがプロパティパネルに表示されます。
- 識別しやすいように 名前 を記入してください。
- 必要であれば、デフォルトの期間をオーバーライドするよう選択します。
- アイテムごとに継続時間を設定するか、フィードごとに継続時間を設定する場合はチェックを入れないままにしておきます。
設定
- 検索条件を指定すると、該当するツイートが表示されます。
twitter.comの検索ボックスで入力する前に、検索語が有効かどうか確認してください。
アカウントの@ハンドル名を含むすべてのツイートではなく、特定のアカウントからのツイートを返すには、検索語フィールドのアカウント名の前に
from:を使用します。
- 使用する言語を選択する
- ドロップダウンで、人気順、最新順、混合など、返されるツイートの種類を選択します。
- ツイートが返送されるまでの 距離 をマイル単位で選択してください。0は制限なし。
- 返信されたツイートからメンション（@someone）を削除する場合は、このチェックボックスを使用します。
- ハッシュタグ**（#something）をTweetテキストから削除する場合は、このチェックボックスを使用します。
- チェックボックスを使用して、返されるTweetテキストからURLを削除します。
ほとんどのURLはデジタルサイネージを褒めるものではありません。
外観
- オプションで背景色**を追加することができます。
- ツイート数を指定します。空白の場合はデフォルトの15件が返されます。
- 1ページに表示するツイート数を選択します。空白の場合は、デフォルトの5ツイートが表示されます。
- 返された結果に使用する日付形式**を適用する（ページ下部の「補足情報」を参照）。
- ツイート間の遷移に使用するエフェクトと速度を任意で選択します。
- ウィジェットの水平方向と垂直方向のアライメントオプションを設定します
テンプレート
利用可能なテンプレートから選択します。
プリセット - をクリックし、プリセットテンプレートの中から1つを選択します。
-
必要であれば、選択したテンプレートを上書きするをクリックします。 詳しくは、下記の「プリセットテンプレートの編集」の項をご覧ください。
- ツイートなしメッセージは、検索クエリに基づいて返すツイートがないときに表示するメッセージを指定します。
プリセットテンプレートを編集
テンプレートは、ドロップダウンでテンプレートを選択し、テンプレートを上書きのチェックボックスをクリックすることで編集することができます。
テンプレートは自動的に拡大縮小されるため、意図した出力解像度に合わせた設計が必要です。テンプレートを編集する際には、以下のガイドラインを考慮する必要があります。
- テンプレートは一定の大きさでデザインされていること
- フォント、マージン、幅、高さなど、すべての要素でpx単位の絶対サイズ指定が必要です。
- 位置決めを行う場合は、上、左から順に行う。
- テンプレートはbootstrapを使用することができます
- アスペクト比はSigmeで固定され、リージョンに合わせたサイズに調整されます。
- テンプレートは静止画と同じ扱いになります
オーバーライドを選択したら、テンプレートタブに戻り、編集するテンプレートを選択します。
メイン - テキストとフォーマットを入力するインラインエディタにアクセスするためにビジュアルエディタをトグル オン または提供されたボックスでテキスト/ HTMLを提供しています。
-
スニペットメニューを使用して、マージテキストフィールドを含めることができます。
Tthe following substitutions are available for use: [Tweet] [User] [ScreenName] [Date] [ProfileImage] [Photo]
オプションのスタイルシート - これは、上記のテンプレートに適用する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 (一年の中の４２週目) |
| 月 | ||
| 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 |