「関数リファレンス/BcBaser blogPosts」の版間の差分
提供: baserCMS公式ガイド
(ページの作成:「## 説明 説明文サンプルテキスト。 ## 使い方 ```php <code><?php echo $testtest ?></code> ``` ## 引数 あり・なし ## 用例 - なにをなに...」) |
|||
(5人の利用者による、間の9版が非表示) | |||
行1: | 行1: | ||
− | ## 説明 | + | ## 説明 |
− | + | ブログ記事一覧出力 | |
− | + | ||
## 使い方 | ## 使い方 | ||
− | + | <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:関数リファレンス]] | |
− | + | ||
− | + |
2016年7月11日 (月) 21:57時点における最新版
目次
説明
ブログ記事一覧出力
使い方
$this->BcBaser->blogPosts( $contentsName, [$num] , [$options] );
パラメータ
- (文字列)$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)
戻り値
なし
用例
基本
コード
<?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>
コード
ブログの詳細記事表示中に、同じカテゴリの記事を関連記事として表示させたい場合
<?php $this->BcBaser->blogPosts('news', 3, array('category'=>$post['BlogCategory']['name'])); ?>
コード:全てのブログから最新記事を取得する
<?php //全ブログから10件記事を取得 $this->BcBaser->blogPosts(null, 10, array( 'contentsTemplate' => 'news' //どのブログ(post.php)を使うか )); ?>