「関数リファレンス/BcBaser blogPosts」の版間の差分
提供: baserCMS公式ガイド
(ページの作成:「## 説明 説明文サンプルテキスト。 ## 使い方 ```php <code><?php echo $testtest ?></code> ``` ## 引数 あり・なし ## 用例 - なにをなに...」) |
|||
行1: | 行1: | ||
− | ## 説明 | + | ## 説明 |
− | + | ブログの最新記事を表示することができます。場所を問わずどこにでも記述できます。ページ編集画面でも利用する事ができます。 | |
− | + | ||
## 使い方 | ## 使い方 | ||
− | + | <syntaxhighlight lang="php"> | |
− | < | + | $this->BcBaser->blogPosts( $contentsName, [$num] , [$options] ); |
− | + | </syntaxhighlight> | |
+ | ## パラメータ | ||
+ | $contentsName | ||
+ | : (文字列) (必須)ブログコンテンツ名をアルファベットで指定します。 | ||
+ | : 初期値 なし | ||
− | + | $num | |
− | + | : (数値) | |
+ | : 記事件数 | ||
+ | : 初期値 5 | ||
+ | : category・・・カテゴリで絞り込み | ||
+ | : tag・・・タグで絞り込み | ||
+ | : year・・・年で絞り込み | ||
+ | : month・・・月で絞り込み | ||
+ | : day・・・日で絞り込み | ||
+ | : id・・・記事NO | ||
+ | : keyword・・・キーワード | ||
+ | : template・・・テンプレート名 | ||
+ | |||
+ | $options | ||
+ | : (文字列)PHPの連想配列で指定します。 | ||
+ | |||
+ | - 初期値:array() | ||
+ | - 'category':カテゴリで絞り込み | ||
+ | - 'tag':タグで絞り込み | ||
+ | - 'year':年で絞り込み | ||
+ | - 'month':月で絞り込み | ||
+ | - 'day':日で絞り込み | ||
+ | - 'id':記事NO | ||
+ | - 'keyword':キーワード | ||
+ | - 'template':テンプレート名 | ||
+ | |||
+ | ## 戻り値 | ||
+ | (文字列) | ||
+ | : ブログ内テンプレート(初期テンプレートはposts.php)に記述された出力形式で表示されます。 | ||
## 用例 | ## 用例 | ||
+ | ### 基本 | ||
+ | ####コード | ||
+ | <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> | ||
+ | |||
+ | ## 注 | ||
+ | |||
+ | ## 変更履歴 | ||
+ | |||
+ | ## ソースファイル | ||
− | + | ## 関連資料 | |
− | + | ||
− | ## | + | ##類似の関数 |
− | + | ||
− | + | [[Category:関数]] | |
− | + | ||
− | + |
2014年11月2日 (日) 11:11時点における版
目次
説明
ブログの最新記事を表示することができます。場所を問わずどこにでも記述できます。ページ編集画面でも利用する事ができます。
使い方
$this->BcBaser->blogPosts( $contentsName, [$num] , [$options] );
パラメータ
- $contentsName
- (文字列) (必須)ブログコンテンツ名をアルファベットで指定します。
- 初期値 なし
- $num
- (数値)
- 記事件数
- 初期値 5
- category・・・カテゴリで絞り込み
- tag・・・タグで絞り込み
- year・・・年で絞り込み
- month・・・月で絞り込み
- day・・・日で絞り込み
- id・・・記事NO
- keyword・・・キーワード
- template・・・テンプレート名
- $options
-
(文字列)PHPの連想配列で指定します。
- 初期値:array()
- 'category':カテゴリで絞り込み
- 'tag':タグで絞り込み
- 'year':年で絞り込み
- 'month':月で絞り込み
- 'day':日で絞り込み
- 'id':記事NO
- 'keyword':キーワード
- 'template':テンプレート名
戻り値
- (文字列)
- ブログ内テンプレート(初期テンプレートはposts.php)に記述された出力形式で表示されます。
用例
基本
コード
<?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>