テンプレート内で使用する変数
2026-02-24 13:31:34
テンプレート内で使用できる変数について解説します。
- 末尾に「*」がついている項目は成形済み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の後ろに[]で囲んだフォーマット文字列を指定できます。
| フォーマット文字 | 内容 |
|---|---|
| Y | 4桁の年 |
| y | 2桁の年 |
| m | 2桁の月 |
| n | 月。前ゼロを付けない |
| d | 2桁の日 |
| j | 日。前ゼロを付けない |
| D | 英字3文字の曜日。MonからSun |
| M | 英字3文字の月。Jan,Nov等 |
| H | 時。24時間単位 |
| h | 時。12時間単位 |
| i | 分 |
| s | 秒 |
| A | AM/PM |
例)
Y年m月d日 A h時i分s秒 → 2026年02月12日 PM 2時43分12秒
Y/m/d →2026/02/12
|