「関数リファレンス/BcBaser blogPosts」の版間の差分
提供: baserCMS公式ガイド
行8: | 行8: | ||
## パラメータ | ## パラメータ | ||
− | $contentsName | + | (文字列)$contentsName |
− | : | + | : 管理システムで指定したコンテンツ名 |
: 初期値 なし | : 初期値 なし | ||
− | $num | + | (数値)$num |
− | + | ||
: 記事件数 | : 記事件数 | ||
− | : | + | : 初期値:5 |
− | $options | + | (array)$options |
− | : | + | : オプション |
- 初期値:array() | - 初期値:array() | ||
− | - 'category' | + | - 'category':カテゴリで絞り込む場合にアルファベットのカテゴリ名指定(初期値 : null) |
− | - 'tag' | + | - 'tag':タグで絞り込む場合にタグ名を指定(初期値 : null) |
− | - 'year' | + | - 'year':年で絞り込む場合に年を指定(初期値 : null) |
− | - 'month' | + | - 'month':月で絞り込む場合に月を指定(初期値 : null) |
− | - 'day' | + | - 'day':日で絞り込む場合に日を指定(初期値 : null) |
− | - 'id' | + | - 'id':id で絞り込む場合に id を指定(初期値 : null) |
− | - 'keyword' | + | - 'keyword':キーワードで絞り込む場合にキーワードを指定(初期値 : null) |
− | - 'template' | + | - 'template':読み込むテンプレート名を指定する場合にテンプレート名を指定(初期値 : null) |
+ | - `direction` : 並び順の方向を指定 [昇順:ASC or 降順:DESC](初期値 : null) | ||
+ | - `sort` : 並び替えの基準となるフィールドを指定(初期値 : null) | ||
+ | - `page` : ページ数を指定(初期値 : null) | ||
## 戻り値 | ## 戻り値 | ||
− | + | なし | |
− | + | ||
## 用例 | ## 用例 |
2015年5月7日 (木) 02:57時点における版
目次
説明
ブログの最新記事を表示することができます。場所を問わずどこにでも記述できます。ページ編集画面でも利用する事ができます。
使い方
$this->BcBaser->blogPosts( $contentsName, [$num] , [$options] );
パラメータ
- (文字列)$contentsName
- 管理システムで指定したコンテンツ名
- 初期値 なし
- (数値)$num
- 記事件数
- 初期値:5
- (array)$options
-
オプション
- 初期値:array()
- 'category':カテゴリで絞り込む場合にアルファベットのカテゴリ名指定(初期値 : null)
- 'tag':タグで絞り込む場合にタグ名を指定(初期値 : null)
- 'year':年で絞り込む場合に年を指定(初期値 : null)
- 'month':月で絞り込む場合に月を指定(初期値 : null)
- 'day':日で絞り込む場合に日を指定(初期値 : null)
- 'id':id で絞り込む場合に id を指定(初期値 : null)
- 'keyword':キーワードで絞り込む場合にキーワードを指定(初期値 : null)
- 'template':読み込むテンプレート名を指定する場合にテンプレート名を指定(初期値 : null)
direction
: 並び順の方向を指定 [昇順:ASC or 降順:DESC](初期値 : null)sort
: 並び替えの基準となるフィールドを指定(初期値 : null)page
: ページ数を指定(初期値 : null)
戻り値
なし
用例
基本
コード
<?php $this->BcBaser->blogPosts('news', 5); ?>
出力
<ul> <li><span class="date">2014.11.2</span><span class="title"><a href="/news/archives/5">ホームページをオープンしました。</a></span></li> <li><span class="date">2014.11.2</span><span class="title"><a href="/news/archives/4">新商品を販売を開始しました。</a></span></li> <li><span class="date">2014.11.2</span><span class="title"><a href="/news/archives/3">ホームページをオープンしました。</a></span></li> <li><span class="date">2014.11.2</span><span class="title"><a href="/news/archives/2">新商品を販売を開始しました。</a></span></li> <li><span class="date">2014.11.2</span><span class="title"><a href="/news/archives/1">ホームページをオープンしました。</a></span></li> </ul>
応用
コード
<?php $this->BcBaser->blogPosts('news', 3, array('category'=>'release', 'year'=>'2014', 'template'=>'posts')); ?>
出力
<li><span class="date">2014.11.2</span><span class="title"><a href="/news/archives/3">ホームページをオープンしました。</a></span></li> <li><span class="date">2014.11.2</span><span class="title"><a href="/news/archives/2">新商品を販売を開始しました。</a></span></li> <li><span class="date">2014.11.2</span><span class="title"><a href="/news/archives/1">ホームページをオープンしました。</a></span></li>