< 戻る

テンプレート内で使用する変数

2026-02-12 22:38:33

テンプレート内で使用できる変数について解説します。

- 末尾に「*」がついている項目は成形済みHTMLが出力される。
- [配列]は{PPP LOOP}の処理対象。

サイト情報群 [各テンプレート共通]


- site_url
- base_url
- site_description
- site_keywords
- site_author
- site_author_icon / サイト作者のアイコンのパス(通常150x150の画像パス。別のサイズも設定可能)
- site_title
- site_og_image
- site_image_color

- favicon / ファビコンが指定されている場合はURL,されていない場合は空
- mini_banner / ミニバナーが指定されている場合はURL, されていない場合は空

- top_banner / バナーが指定されている場合はURL,されていない場合は空
- top_banner_html / 整形済みトップバナーHTML
- top_banner_class / 設定に応じたバナークラス(p-title-banner-with-bg, title-banner-without-bg)
- top_bnner_title_class / 設定に応じたバナー用テキストのクラス(空, p-hide)

※site_authoer_icon, top_banner, mini_bannerは通常上記の想定サイズの画像を設定画面からアップロードする。
 アップロードされない場合もあるため、テーマ側では考慮が必要。
 上記サイズ以外の画像を要求する場合や、画像指定が必須な場合はテーマインフォにて注記するか、テーマインフォ内でファイル指定させること。


ページ情報群 [各ページテンプレート共通]

- page_description / {caption}または記事冒頭100文字が設定されます
- page_keywords / 隠し以外のタグが設定されます
- page_title / (記事名 - サイト名)の形をとります
- page_url
- page_og_image / 1枚目の画像が設定されます。画像なしやNSFW記事の場合は空。

固定ページメニュー

- home_menu [配列]
- title
- is_current / 現在のページがこのメニューのページの場合、true。
- is_first / true,false
- is_last / true, false
- url
- class / is_current,is_first,is_lastに合わせて home-menu-item-current,home-menu-item-first,home-menu-item-lastの組み合わせ

トップぺージ [index]

- contents / サイト案内文
- tag_links_html / タグクラウドHTML
- accounts [配列]
- url
- type / 0:Font 1:画像
- icon / type=0の場合CSS Class, type=1の場合画像ファイル名
- icon_html

- articles [配列] / 記事一覧
- url
- created_at
- title
- caption
- nsfw_type / 0:指定なし 1:NSFW指定
- nsfw_status / 0:NSFW同意なし 1:NSFW同意あり
- thumbnail_class / 状態に応じたCSSクラス用の値。以下の組み合わせ。 thumb_nsfw : NSFW指定 thumb_nsfw_consent : 同意済み thumb_text : 画像なしの記事
- thumbnail_path / サムネイル画像のパス。NSFW状態によって変化する。
- raw_thumbnail_path / サムネイル画像のパス。NSFW状態を考慮しない。
- thumbnail_title / 画像ありの記事の場合空。なしの記事の場合titleと同じテキスト。
- multi_image / 2枚以上の画像が設定されている場合true。

- pagination [配列] / 記事一覧ページナビ
- index
- is_current
- is_first
- is_last
- is_page_first
- is_page_last
- url
- class


コンテンツ情報群 [page, view_fix]

- id
- title
- created_at
- created_at_date
- updated_at
- updated_at_date
- contents *
- tag_links_html *
- tags
- primary_tag
- nsfw
- use_password
- type / page:固定ページ, simple:シンプルモード(自動画像表示あり), normal:詳細モード(自動画像表示なし)

- caption *

- media [配列] / 記事に添付のメディア。ソート順に格納される。
- file_name / オリジナルの画像URL
- width
- height
- thumb_l / サムネイル画像(大)URL
- thumb_l_width
- thumb_l_height
- thumb / サムネイル画像(小)URL
- thumb_width
- thumb_height
- comment
- type / (0:画像 1:ビデオ)
- thumbnail_html / 成形済みサムネイル表示用URL *

- likes / いいね数
- views / 表示回数
- likes_html / 整形済みいいね数
- views_html / 整形済み表示回数

- next_link_html *
- prev_link_html *
- next_url
- prev_url

- simple_mode / 0:詳細モード, 1:シンプルモード
- manga_mode / 0:標準 1:漫画モード
- style / 0~7

※ contents, captionは指定されたスタイルにより内容が変化する。
シンプルモード、漫画モードの場合captionに本文が入力され、contentsは空となる。
それ以外のスタイルでは{caption}で指定された内容がcaptionに入力され、本文はcontentsに入力される。

ArticleList群 [list_]

- articles[配列]
- url
- created_at
- title
- caption
- thumbnail_path / NSFW状態に応じたサムネイル画像のパス
- raw_thumbnail_path / サムネイル画像のパス。NSFW状態を考慮しない。
- thumbnail_class / 状態に応じたCSSクラス用の値。以下の組み合わせ。 thumb_nsfw : NSFW指定 thumb_nsfw_consent : 同意済み thumb_text : 画像なしの記事
- thumbnail_title / 画像ありの記事の場合空。なしの記事の場合titleと同じテキスト。
- nsfw_type / 0:指定なし 1:NSFW指定
- nsfw_status / 0:NSFW同意なし 1:NSFW同意あり

- pagination [配列]
- index
- is_current
- is_first
- is_last
- is_page_first
- is_page_last
- url

システム群

- admin_heaer *
- powered_info *
- copyright *
- login_url
- is_login
- is_index

代替記述

{PPP IF}や{PPP LOOP},{PPP THEME}のような、PPPの直後のスペースは_(アンダーバー)で記述することもできます。

created_at、 updated_atについて

通常は{ppp:created_at}のような表記で
2026-02-12 14:43:12
のような表記になりますが、記述により表示フォーマットを指定することができます。
{PPP:articles.created_at[Y年m月d日]}
上記のようにcreated_atまたはupdated_atの後ろに[]で囲んだフォーマット文字列を指定できます。
フォーマット文字内容
Y4桁の年
y2桁の年
m2桁の月
n月。前ゼロを付けない
d2桁の日
j日。前ゼロを付けない
D英字3文字の曜日。MonからSun
M英字3文字の月。Jan,Nov等
H時。24時間単位
h時。12時間単位
i
s
AAM/PM

例)
Y年m月d日 A h時i分s秒 → 2026年02月12日 PM 2時43分12秒
Y/m/d →2026/02/12