テンプレート(旧Ranklet互換)
INFO
これは旧Rankletからの移行用テンプレートエンジンです。新規テンプレートには機能豊富なテンプレートの記述方法(Handlebars)の使用を推奨します。
旧 Ranklet で設定したテンプレートとの互換性のため、テンプレートエンジン Mustache も選択できます。
ただしこちらはあくまで旧 Ranklet からの移行用であり、新規のテンプレートはHandlebars
を使用することをお勧めします。
最上位で使える記述
ランキングのループ
{{#context.pages}} ~ {{/context.pages}}
ランキングを 1 位から最後までループします。
ランキングのループ内で使える記述
ページのサムネイルの有無の判定
{{#image}} ~ {{/image}}
ページのサムネイルがある場合に内容を出力します。
説明の有無の判定
{{#description}} ~ {{/description}}
ページの説明文がある場合に内容を出力します。
Ranklet メタデータの判定
{{#ranklet.メタデータ名}} ~ {{/ranklet.メタデータ名}}
ページに指定の Ranklet メタデータがある場合に内容を出力します。
順位の判定
{{#rank1}} ~ {{/rank1}}
ループ中の順位が 1 位の場合に内容を出力します。rank1
からrank10
まで利用できます。
ページの順位
{{rank}}
ループ中の順位を出力します。
ページのリンク URL
{{url}}
ループ中のページのリンク URL を出力します。なお、旧 Ranklet ではリダイレクト URL でしたが、Ranklet4 ではリダイレクト方式ではなくなったため、リンク URL は元 URL と同じになります。
ページの元 URL
{{raw_url}}
ループ中の元 URL を出力します。なお、Ranklet4 ではリンク URL と元 URL は同じになります。
ページのサムネイル URL
{{image}}
ループ中のサムネイル URL を出力します。なお、旧 Ranklet では OGP 画像または Ranklet メタ画像でしたが、Ranklet4 では Ranklet メタ画像がある場合は Ranklet メタ画像、OGP 画像の場合はそのサムネイル画像 URL になります。
ページの代表画像 URL
{{raw_image}}
ループ中のページの代表画像 URL を出力します。Ranklet メタ画像がある場合は Ranklet メタ画像、OGP 画像の場合はその画像 URL になります。OGP 画像は通常、サムネイルに向かない高解像度画像が用いられるため、可能な限り{{image}}
を利用することを推奨します。
ページのタイトル
{{title}}
ループ中のタイトルを出力します。
ページの説明文
{{description}}
ループ中の説明文を出力します。
ページのページビュー
{{metric}}
ループ中のページビューを出力します。
Ranklet メタデータ
{{ranklet.メタデータ名}}
ループ中のページの Ranklet メタデータを出力します。
任意の場所で使える記述
ランキング ID
{{context.id}}
ランキング ID を出力します。
ランキングの最大順位
{{context.topn}}
ランキングを最大順位を出力します。
集計期間
{{context.days}}
ランキングを集計した期間の日数を出力します。
集計期間の開始日
{{context.date_from}}
ランキングを集計した期間の開始日を出力します。
集計期間の終了日
{{context.date_to}}
ランキングを集計した期間の終了日を出力します。
ランキングの更新日時
{{context.updated_time}}
ランキングの更新日時を出力します。