SOY CMSマニュアル
よく使う項目
- 記事(エントリー)ブロック [entry]
- コメント一覧[comment_list]
- トラックバック一覧 [trackback_list]
- コメントフォーム [comment_form]
- トラックバックURLを出力 [trackback_link]
- トップページリンク [top_link]
- 前の記事(エントリー) [prev_entry]
- 次の記事(エントリー) [next_entry]
- カテゴリー一覧 [category]
- 月別アーカイブ一覧 [archive]
- 新着記事リストブロック[recent_entry_list]
- 新着コメント一覧 [recent_comment_list]
- 新着トラックバック一覧 [recent_trackback_list]
- 年別アーカイブ一覧 [archive_by_year]
- ブログの説明 [blog]
- atomリンク [atom_link]
- RSSリンク [rss_link]
- フィード出力 [meta_feed_link]
記事(エントリー)ブロック [entry]
このブロックは、記事毎(エントリー)ページでご利用いただけます。
記事毎(エントリー)ページの該当記事(エントリー)の内容を出力する際に用いることができます。
cms:id | タグ | 説明 |
---|---|---|
entry_id | 全て | 対象記事(エントリー)のIDを出力します。 |
title | 全て | 対象記事(エントリー)のタイトルを記事毎(エントリー)ページへのリンク付きで出力します。 |
title_plain | 全て | 対象記事(エントリー)のタイトルのみを出力します。(1.1.1以降) |
content | 全て | 対象記事(エントリー)の本文を出力します。 |
more | 全て | 対象記事(エントリー)の追記部分を出力します。(冒頭に<a id="more"></a>が挿入されます。) |
more_only | 全て | 対象記事(エントリー)の追記部分を出力します。(冒頭に<a id="more"></a>が挿入されません。1.8.13以降) |
has_more | 全て | 対象記事(エントリー)の追記が入力されている場合に出力する箇所を指定します。(1.8.13以降) |
create_date | 全て | 対象記事(エントリー)の作成日付を出力します。cms:formatで書式を指定できます。 |
create_time | 全て | 対象記事(エントリー)の作成時刻を出力します。cms:formatで書式を指定できます。 |
entry_link | A | 対象記事(エントリー)の記事毎(エントリー)ページへのリンクを生成します。 |
more_link | A | 対象記事(エントリー)の追記の表示された記事毎(エントリー)ページへのリンクを生成します。自動的に#moreが付きます。 |
more_link_no_anchor | A | 対象記事(エントリー)の追記の表示された記事毎(エントリー)ページへのリンクを生成します。自動的に#moreは付きません。 |
trackback_link | A | 対象記事(エントリー)のトラックバックをトップとする記事毎(エントリー)ページへのリンクを生成します。 |
trackback_count | 全て | 対象記事(エントリー)のトラックバック個数を出力します。 |
comment_link | A | 対象記事(エントリー)のコメントをトップとする記事毎(エントリー)ページへのリンクを生成します。 |
comment_count | 全て | 対象記事(エントリー)のコメント数を出力します。 |
category_list | 全て | 対象記事(エントリー)につけられているカテゴリーのブロックを出力します。 後述のcategory_link,category_nameを使用して設定を行ってください。 |
category_link | A | 対象記事(エントリー)につけられているカテゴリーのアーカイブページへのリンクを生成します。 前述のcategory_list内で使用することが可能です。 |
category_name | 全て | 対象記事(エントリー)につけられているカテゴリーの名前を出力します。 前述のcategory_list内で使用することが可能です。 |
例
<!-- b_block:id="entry" -->
<div>
<h2 cms:id="title">ここにはタイトルが入ります。</h2>
<span cms:id="create_date" cms:format="Y/m/d">2008/03/17</span>
<p cms:id="content">ここには本文が入ります</p cms:id="content">
<p cms:id="more">ここには追記が入ります。</p cms:id="more">
<span cms:id="create_time" cms:format="H:i">17:00</span>
<a cms:id="comment_link">コメント(<!-- cms:id="comment_count"--><!-- /cms:id="comment_count"-->)</a>
<a cms:id="trackback_link">トラックバック(<!-- cms:id="trackback_count"--><!-- /cms:id="trackback_count"-->)</a>
<p>
<!-- cms:id="category_list" -->
<a cms:id="category_link"><!-- cms:id="category_name" --><!-- /cms:id="category_name" --></a>
<!-- /cms:id="category_list" -->
</p>
</div>
<!-- /b_block:id="entry" -->
コメント一覧[comment_list]
このブロックは、記事毎(エントリー)ページでご利用になれます。
このブロックで、記事(エントリー)に対して、投稿されたコメントの一覧を出力させることができます。
管理ページより、拒否に設定されているコメントは表示されません。
cms:id | タグ | 説明 |
---|---|---|
title | 全て | 投稿コメントのタイトルを出力します。 |
author | 全て | 投稿コメントの投稿者名を出力します。 |
body | 全て | 投稿コメントの本文部分を出力します。 |
submit_date | 全て | 投稿コメントの投稿日付を出力します。cms:formatで書式を指定できます。 |
submit_time | 全て | 投稿コメントの投稿時刻を出力します。cms:formatで書式を指定できます。 |
url | A | 投稿コメントのURLを生成します。 |
mail_address | A | 投稿コメントのメールアドレスを生成します。 |
例
<!-- b_block:id="comment_list" -->
<div>
<h5 cms:id="title" cms:alt="無題">タイトル</h5>
<a cms:id="mail_address"><!-- cms:id="author" cms:alt="名無しさん" -->名前<!-- /cms:id="author" --></a>
|<!-- cms:id="submit_date" cms:format="Y-m-d"-->2008-03-17<!-- /cms:id="submit_date"-->
|<a cms:id="url">URL</a>
<div cms:id="body" cms:alt="本文無し">本文</div>
<span cms:id="submit_time" cms:format="H:i">17:52</span>
</div>
<!--/b_block:id="comment_list" -->
トラックバック一覧 [trackback_list]
このブロックは、記事毎(エントリー)ページでご利用になれます。
このブロックで、記事(エントリー)に対して、投稿されたトラックバックの一覧を出力させることができます。
管理ページより、拒否に設定されているトラックバックは表示されません。
投稿されたトラックバックは初期状態は拒否になっているため、許可に設定しなければ表示されないことにご注意ください。
cms:id | タグ | 説明 |
---|---|---|
title | 全て | 投稿されたトラックバックのタイトルを出力します。 |
url | A | 投稿されたトラックバックのURLを生成します。 |
blog_name | 全て | 投稿されたトラックバック元のブログ名を出力します。 |
excerpt | 全て | 投稿されたトラックバック元のブログ記事の要約を出力します。 |
submit_date | 全て | トラックバックの投稿された日付を出力します。cms:formatで書式を指定できます。 |
submit_time | 全て | トラックバックの投稿された時刻を出力します。cms:formatで書式を指定できます。 |
例
<ul>
<!-- b_block:id="trackback_list" -->
<li>
<h5 cms:id="title">タイトル</h5>
<a cms:id="url"><!-- cms:id="blog_name"-->ブログ名<!-- /cms:id="blog_name"--></a>
<p cms:id="excerpt">要約</p>
<span cms:id="submit_date" cms:format="Y/m/d H:i">2008/03/15 12:35</span>
</li>
<!--/b_block:id="trackback_list" -->
</ul>
コメントフォーム [comment_form]
このブロックは、記事毎(エントリー)ページでご利用になれます。
このブロックで、記事(エントリー)に対して、閲覧者がコメントを投稿できるようにフォームを設置することができます。
ここで投稿されたコメント、管理ページより確認することができます。
このブロックは必ずFORMタグに使用してください。
cms:id | タグ | 説明 |
---|---|---|
title | input | 投稿コメントのタイトルとして入力するinputに設定してください。 |
author | input | 投稿コメントの投稿者として入力するinputに設定してください。 |
body | textarea | 投稿コメントの本文として入力するtextareaに設定してください。 |
mail_address | input | 投稿コメントのメールアドレスとして入力するinputに設定してください。 |
url | input | 投稿コメントのURLとして入力するinputに設定してください。 |
例
<form b_block:id="comment_form">
<p>タイトル:<input cms:id="title" /></p>
<p>お名前:<input cms:id="author" /></p>
<p>mail:<input cms:id="mail_address" /></p>
<p>URL:<input cms:id="url" /></p>
<p><textarea cms:id="body"></textarea></p>
<input type="submit" value="投稿">
</form b_block:id="comment_form">
トラックバックURLを出力 [trackback_link]
このブロックは、記事毎(エントリー)ページでご利用になれます。
このブロックで、この記事(エントリー)にトラックバックを投稿するためのURLを出力します。
このブロックは必ずINPUTタグにご使用ください。
cms:id | タグ | 説明 |
---|---|---|
このブロックでご利用になれるcms:idはありません。 |
例
<input b_block:id="trackback_link">
トップページリンク [top_link]
このブロックは全てのブログページでご利用になれます。
このブロックは、該当ブログのトップページへのリンクを出力します。
このブロックは必ずAタグに使用してください。
cms:id | タグ | 説明 |
---|---|---|
このブロックでご利用になれるcms:idはありません。 |
以下の書式でブログ名とブログのトップページへのURLを出力することも可能です。
文字列 | 内容 | 使用可能バージョン |
---|---|---|
@@blog_name; | ブログのタイトル | |
@@blog_url; | ブログのトップページのURL | 1.2.3以降 |
例
<a b_block:id="top_link">ブログのトップへ</a b_block:id="top_link">
前の記事(エントリー) [prev_entry]
このブロックは、記事毎(エントリーページ)でご利用になれます。
このブロックで、現在表示されている記事(エントリー)の前の記事(エントリー)のタイトルおよび記事毎(エントリー)ページへのリンクが表示されます。
cms:id | タグ | 説明 |
---|---|---|
title | 全て | 前の記事(エントリー)のタイトルを出力します。 |
entry_link | a | 前の記事(エントリー)ページへのリンクを出力します。 |
「前の記事(エントリー)」とは管理画面のブログの記事一覧で下側の記事(エントリー)のことです。
例
<div b_block:id="next_entry">
<a cms:id="entry_link"><!-- cms:id="title" --><!-- /cms:id="title" --></a>
</div b_block:id="next_entry">
<div b_block:id="prev_entry">
<a cms:id="entry_link"><!-- cms:id="title" --><!-- /cms:id="title" --></a>
</div b_block:id="prev_entry">
次の記事(エントリー) [next_entry]
このブロックは、記事毎(エントリー)ページでご利用になれます。
このブロックで、現在表示されている記事(エントリー)の次の記事(エントリー)のタイトルおよび記事毎(エントリー)ページへのリンクが表示されます。
cms:id | タグ | 説明 |
---|---|---|
title | 全て | 次の記事(エントリー)のタイトルを出力します。 |
entry_link | a | 次の記事毎(エントリー)ページへのリンクを出力します。 |
「次の記事(エントリー)」とは管理画面のブログの記事一覧で上側の記事(エントリー)のことです。
例
<div b_block:id="next_entry">
<a cms:id="entry_link"><!-- cms:id="title" --><!-- /cms:id="title" --></a>
</div b_block:id="next_entry">
<div b_block:id="prev_entry">
<a cms:id="entry_link"><!-- cms:id="title" --><!-- /cms:id="title" --></a>
</div b_block:id="prev_entry">
カテゴリー一覧 [category]
このブロックは、全てのブログページでご利用になれます。
ブログに設定されている、カテゴリ分けに使用するラベルの情報を出力します。
このブロックは、繰り返しブロックであり、該当するカテゴリーの個数だけブロックの内容が繰り返し出力されます。
cms:id | タグ | 説明 |
---|---|---|
category_link | A | 対象カテゴリーのアーカイブページへのリンクを生成します。 |
category_name | 全て | 対象カテゴリーの名前を出力します。 |
entry_count | 全て | 対象カテゴリーに属している記事(エントリー)の個数を出力します。 |
例
<ul>
<!-- b_block:id="category" -->
<li><a cms:id="category_link">
<!-- cms:id="category_name" --><!-- /cms:id="category_name" -->(<!-- cms:id="entry_count" -->0<!-- /cms:id="entry_count" -->)
</a>
</li>
<!-- /b_block:id="category" -->
</ul>
月別アーカイブ一覧 [archive]
このブロックは、全てのブログページでご利用になれます。
投稿されている記事(エントリー)を、月別に集計し出力します。
このブロックは、繰り返しブロックであり、該当する月の個数だけブロックの内容が繰り返し出力されます。
cms:id | タグ | 説明 |
---|---|---|
archive_link | A | 対象の月の月別アーカイブページへのリンクを生成します。 |
archive_month | 全て | 対象の月を出力します。cms:formatで書式を指定できます。 |
entry_count | 全て | 対象の月に投稿された記事(エントリー)数を出力します。 |
例
<ul>
<!-- b_block:id="archive" -->
<li><a cms:id="archive_link">
<!-- cms:id="archive_month" cms:format="Y年m月" --><!-- /cms:id="archive_month" -->
(<!-- cms:id="entry_count" -->0<!-- /cms:id="entry_count" -->)
</a>
</li>
<!-- /b_block:id="archive" -->
</ul>
新着記事リストブロック[recent_entry_list]
このブロックは、全てのブログページでご利用になれます。
最近投稿された記事一覧を出力します。
このブロックは、繰り返しブロックであり、該当する記事の個数だけブロックの内容が繰り返し出力されます。
ここで表示される件数は、設定ページより設定できるRSSページの表示件数と同一です。
cms:id | タグ | 説明 |
---|---|---|
entry_id | 全て | 対象記事(エントリー)のIDを出力します。 |
title | 全て | 対象記事(エントリー)のタイトルを出力します。 |
create_date | 全て | 対象記事(エントリー)の作成日付を出力します。cms:formatで書式を指定できます。 |
create_time | 全て | 対象記事(エントリー)の作成時刻を出力します。cms:formatで書式を指定できます。 |
entry_link | A | 対象記事(エントリー)の記事毎(エントリー)ページへのリンクを生成します。 |
例
<ul>
<!-- b_block:id="recent_entry_list" -->
<li>
<a cms:id="entry_link">
<!-- cms:id="title" -->ここにタイトルが入ります<!-- /cms:id="title" -->(<!-- cms:id="create_date" cms:format="m/i"-->03/17<!-- /cms:id="create_date" -->)
</a>
</li>
<!--/b_block:id="recent_entry_list" -->
</ul>
新着コメント一覧 [recent_comment_list]
このブロックは、全てのブログページでご利用になれます。
最近投稿されたコメントを出力します。
このブロックは、繰り返しブロックであり、該当するコメントの個数だけブロックの内容が繰り返し出力されます。
ここで表示される件数は、現在は10件で固定となっております。
cms:id | タグ | 説明 |
---|---|---|
entry_title | 全て | コメントを投稿された記事(エントリー)のタイトルを出力します。 |
title | 全て | 投稿されたコメントのタイトルを出力します。 |
author | 全て | 投稿されたコメントの名前を出力します。 |
submit_date | 全て | 投稿されたコメントの投稿日付を出力します。cms:formatで書式を指定できます。 |
submit_time | 全て | 投稿されたコメントの投稿時刻を出力します。cms:formatで書式を指定できます。 |
entry_link | A | コメントを投稿された記事(エントリー)の生地毎(エントリー)ページへのリンクを出力します。 |
body | 全て | 投稿されたコメント本文を出力します。 (1.2.8以降) |
url | A | 投稿されたコメントのURLを出力します。 (1.2.8以降) |
mail_address | A | 投稿されたコメントのメールアドレスをmailto:を付けて出力します。 (1.2.8以降) |
例
<ul>
<!-- b_block:id="recent_comment_list" -->
<li>
<a cms:id="entry_link">
<!-- cms:id="title" -->コメントのタイトル<!-- /cms:id="title" -->
<br />=>
<!-- cms:id="entry_title" -->記事のタイトル<!-- /cms:id="entry_title" -->
[<!-- cms:id="submit_date" cms:format="m/d" -->03/17<!-- /cms:id="submit_date" -->]
</a>
</li>
<!--/b_block:id="recent_comment_list" -->
</ul>
新着トラックバック一覧 [recent_trackback_list]
このブロックは、全てのブログページでご利用になれます。
最近投稿されたトラックバック一覧を出力します。
このブロックは、繰り返しブロックであり、該当するトラックバックの個数だけブロックの内容が繰り返し出力されます。
ここで表示される件数は、現在は10件で固定となっております。
cms:id | タグ | 説明 |
---|---|---|
title | 全て | 投稿されたトラックバックのタイトルを出力します。 |
url | A | 投稿されたトラックバック元のブログのURLを生成します。 |
blog_name | 全て | 投稿されたトラックバック元のブログの名前を生成します。 |
excerpt | 全て | 投稿されたトラックバック元のブログの記事の要約を出力します。 |
submit_date | 全て | トラックバックの投稿日付を出力します。 |
submit_time | 全て | トラックバックの投稿時刻を出力します。 |
entry_link | A | トラックバックが投稿された記事(エントリー)の記事毎(エントリー)ページへのリンクを生成します。 |
entry_title | 全て | トラックバックが投稿された記事(エントリー)のタイトルを出力します。 |
例
<ul>
<!-- b_block:id="recent_trackback_list" -->
<li>
<a cms:id="entry_link">
<!-- cms:id="title" -->タイトル<!-- /cms:id="title" -->
<br />=><!-- cms:id="entry_title" -->記事(エントリー)のタイトル<!-- /cms:id="entry_title" -->
[<!-- cms:id="submit_date" cms:format="m/d" -->03/17<!-- /cms:id="submit_date" -->]
</a>
</li>
<!--/b_block:id="recent_trackback_list" -->
</ul>
年別アーカイブ一覧 [archive_by_year]
このブロックは、全てのブログページでご利用になれます。(SOY CMS 1.5.0〜)
投稿されている記事(エントリー)を、年別に集計し出力します。
このブロックは、繰り返しブロックであり、該当する年の個数だけブロックの内容が繰り返し出力されます。
cms:id | タグ | 説明 |
---|---|---|
archive_link | A | 対象の年の年別アーカイブページへのリンクを生成します。 |
archive_year | 全て | 対象の年を出力します。cms:formatで書式を指定できます。 |
entry_count | 全て | 対象の年に投稿された記事(エントリー)数を出力します。 |
例
<ul>
<!-- b_block:id="archive_by_year" -->
<li><a cms:id="archive_link">
<!-- cms:id="archive_year" cms:format="Y年" --><!-- /cms:id="archive_year" -->
(<!-- cms:id="entry_count" -->0<!-- /cms:id="entry_count" -->)
</a>
</li>
<!-- /b_block:id="archive_by_year" -->
</ul>
ブログの説明 [blog]
このブロックは、ブログのすべてのページでご利用になれます。
このブロックは、ブログの説明を表示します。。
cms:id | タグ | 説明 |
---|---|---|
このブロックでご利用になれるcms:idはありません。 |
例
<p b_block:id="blog_description">ブログの説明がここに記述されます。</p b_block:id="blog_description">
atomリンク [atom_link]
このブロックは全てのブログページでご利用になれます。
このブロックは、atomのリンクを出力します。
このブロックはAタグに使用してください。
cms:id | タグ | 説明 |
---|---|---|
このブロックでご利用になれるcms:idはありません。 |
例
<a b_block:id="atom_link">[XML]</a>
RSSリンク [rss_link]
このブロックは全てのブログページでご利用になれます。
このブロックは、RSSのリンクを出力します。
このブロックはAタグに使用してください。
cms:id | タグ | 説明 |
---|---|---|
このブロックでご利用になれるcms:idはありません。 |
例
<a b_block:id="rss_link">[RSS]</a>
フィード出力 [meta_feed_link]
このブロックは全てのブログページでご利用になれます。
このブロックは、フィードのURLを出力します。
このブロックは必ずヘッダ内にコメントで使用してください。
cms:id | タグ | 説明 |
---|---|---|
このブロックでご利用になれるcms:idはありません。 |
例
<!-- b_block:id="meta_feed_link" -->
<!-- フィードへのメタ情報が表示されます。 -->
<!-- /b_block:id="meta_feed_link" -->