「ver4/関数リファレンス/BcBaser blogPosts」を編集中

[このコンテンツは内容調整中です]

## 説明
ブログ記事一覧出力

## 使い方
<syntaxhighlight lang="php">
$this->BcBaser->blogPosts( $contentsName, [$num] , [$options] );
</syntaxhighlight>

## パラメータ
（文字列）$contentsName
:  管理システムで指定したコンテンツ名
: 初期値 nul ：全てのブログが取得対象に

（数値）$num
: 記事件数
: 初期値：5

（array）$options
: オプション

    - 初期値：array()
    - 'category'：カテゴリで絞り込む場合にアルファベットのカテゴリ名指定（初期値 : null）
    - 'tag'：タグで絞り込む場合にタグ名を指定（初期値 : null）
    - 'year'：年で絞り込む場合に年を指定（初期値 : null）
    - 'month'：月で絞り込む場合に月を指定（初期値 : null）
    - 'day'：日で絞り込む場合に日を指定（初期値 : null）
    - 'id'：id で絞り込む場合に id を指定（初期値 : null）
    - 'keyword'：キーワードで絞り込む場合にキーワードを指定（初期値 : null）
    - 'template'：読み込むテンプレート名を指定する場合にテンプレート名を指定（初期値 : null）
    - 'contentsTemplate'：どのブログのテンプレート名を利用するか''ブログ名''(news等)を指定（初期値 : null）※3.0.10で実装。指定方法が変更する可能性アリ
    - `direction` : 並び順の方向を指定 [昇順:ASC or 降順:DESC]（初期値 : null）
    - `sort` : 並び替えの基準となるフィールドを指定（初期値 : null）
    - `page` : ページ数を指定（初期値 : null）

## 戻り値
なし

## 用例
### 基本
####コード
<syntaxhighlight lang="php">
<?php $this->BcBaser->blogPosts('news', 5); ?>
</syntaxhighlight>

####出力
<syntaxhighlight lang="html5">
<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>
</syntaxhighlight>

### 応用
####コード
<syntaxhighlight lang="php">
<?php $this->BcBaser->blogPosts('news', 3, array('category'=>'release', 'year'=>'2014', 'template'=>'posts')); ?>
</syntaxhighlight>

####出力
<syntaxhighlight lang="html5">
    <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>
</syntaxhighlight>

####コード
ブログの詳細記事表示中に、同じカテゴリの記事を関連記事として表示させたい場合
<syntaxhighlight lang="php">
<?php $this->BcBaser->blogPosts('news', 3, array('category'=>$post['BlogCategory']['name'])); ?>
</syntaxhighlight>


####コード：全てのブログから最新記事を取得する
<syntaxhighlight lang="php">
<?php
//全ブログから10件記事を取得
$this->BcBaser->blogPosts(null, 10, array(
  'contentsTemplate' => 'news' //どのブログ(post.php)を使うか
));
?>
</syntaxhighlight>



## 注

## 変更履歴

## ソースファイル

## 関連資料

##類似の関数

[[Category:関数リファレンスver4]]
@@ 行6: / 行6: @@
 ## 使い方
 <syntaxhighlight lang="php">
-$this->BcBaser->blogPosts( $contentsName , $num , [$options] );
+$this->BcBaser->blogPosts( $contentsName, [$num] , [$options] );
 </syntaxhighlight>
 ## パラメータ
-(string | array) $contentsName
+（文字列）$contentsName
 :  管理システムで指定したコンテンツ名
-: 初期値 nul
+: 初期値 nul ：全てのブログが取得対象に
-: ２階層目以降はURLで指定
-(int) $num
+（数値）$num
 : 記事件数
 : 初期値：5
-(array) $options
+（array）$options
 : オプション
-: 初期値：array()
-:    - `category`：カテゴリで絞り込む場合にアルファベットのカテゴリ名指定（初期値 : null）
+    - 初期値：array()
-:    - `tag`：タグで絞り込む場合にタグ名を指定（初期値 : null）
+    - 'category'：カテゴリで絞り込む場合にアルファベットのカテゴリ名指定（初期値 : null）
-:    - `year`：年で絞り込む場合に年を指定（初期値 : null）
+    - 'tag'：タグで絞り込む場合にタグ名を指定（初期値 : null）
-:    - `month`：月で絞り込む場合に月を指定（初期値 : null）
+    - 'year'：年で絞り込む場合に年を指定（初期値 : null）
-:    - `day`：日で絞り込む場合に日を指定（初期値 : null）
+    - 'month'：月で絞り込む場合に月を指定（初期値 : null）
-:    - `id`：id で絞り込む場合に id を指定（初期値 : null）
+    - 'day'：日で絞り込む場合に日を指定（初期値 : null）
-:    - `keyword`：キーワードで絞り込む場合にキーワードを指定（初期値 : null）
+    - 'id'：id で絞り込む場合に id を指定（初期値 : null）
-:    - `template`：読み込むテンプレート名を指定する場合にテンプレート名を指定（初期値 : null）
+    - 'keyword'：キーワードで絞り込む場合にキーワードを指定（初期値 : null）
-:    - `contentsTemplate`：どのブログのテンプレート名を利用するか''ブログ名''(news等)を指定（初期値 : null）※3.0.10で実装。指定方法が変更する可能性アリ
+    - 'template'：読み込むテンプレート名を指定する場合にテンプレート名を指定（初期値 : null）
-:    - `direction` : 並び順の方向を指定 [昇順:ASC or 降順:DESC]（初期値 : null）
+    - 'contentsTemplate'：どのブログのテンプレート名を利用するか''ブログ名''(news等)を指定（初期値 : null）※3.0.10で実装。指定方法が変更する可能性アリ
-:    - `sort` : 並び替えの基準となるフィールドを指定（初期値 : null）
+    - `direction` : 並び順の方向を指定 [昇順:ASC or 降順:DESC]（初期値 : null）
-:    - `page` : ページ数を指定（初期値 : null）
+    - `sort` : 並び替えの基準となるフィールドを指定（初期値 : null）
+    - `page` : ページ数を指定（初期値 : null）
 ## 戻り値