「ver4/関数リファレンス/Blog eyeCatch」の版間の差分
提供: baserCMS公式ガイド
Goichi Maniwa (トーク | 投稿記録) (ページの作成:「<metadesc>baserCMSの関数、bcbaser blog eyeCatch の解説です。この関数はブログ記事に設定されたアイキャッチ画像を表示します。</metad...」) |
Katokaisya (トーク | 投稿記録) |
||
(3人の利用者による、間の5版が非表示) | |||
行5: | 行5: | ||
##使い方 | ##使い方 | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
− | <?php $this->Blog->eyeCatch($post, $options) ?> | + | <?php $this->Blog->eyeCatch( $post , [$options] ) ?> |
</syntaxhighlight> | </syntaxhighlight> | ||
##パラメーター | ##パラメーター | ||
行18: | 行18: | ||
<dd> | <dd> | ||
(array)img要素の属性等を任意で連想配列で指定 | (array)img要素の属性等を任意で連想配列で指定 | ||
− | + | : 初期値 : array() | |
− | * | + | : * - `imgsize` : 画像サイズ[thumb|small|medium|large](初期値 : thumb) |
− | * | + | : * - `link` : 大きいサイズの画像へのリンク有無(初期値 : true) |
− | * | + | : * - `escape` : タイトルについてエスケープする場合に true を指定(初期値 : false) |
− | * | + | : * - `mobile` : モバイルの画像を表示する場合に true を指定(初期値 : false) |
− | *' | + | : * - `alt` : alt属性(初期値 : '') |
− | *' | + | : * - `width` : 横幅(初期値 : '') |
− | *' | + | : * - `height` : 高さ(初期値 : '') |
− | * | + | : * - `noimage` : 画像が存在しない場合に表示する画像(初期値 : '') |
− | * | + | : * - `tmp` : 一時保存データの場合に true を指定(初期値 : false) |
− | * | + | : * - `class` : タグの class を指定(初期値 : img-eye-catch) |
− | + | : * - `force` : 画像が存在しない場合でも強制的に出力する場合に true を指定する(初期値 : false) | |
− | + | : ※ その他のオプションについては、リンクをつける場合、HtmlHelper::link() を参照、つけない場合、Html::image() を参照 | |
</dl> | </dl> | ||
##戻り値 | ##戻り値 | ||
<dl> | <dl> | ||
− | <dt>( | + | <dt>(void)</dt> |
− | <dd> | + | <dd></dd> |
</dl> | </dl> | ||
行65: | 行65: | ||
http://forum.basercms.net/modules/newbb/viewtopic.php?topic_id=1043&forum=8 | http://forum.basercms.net/modules/newbb/viewtopic.php?topic_id=1043&forum=8 | ||
##擬似の関数 | ##擬似の関数 | ||
− | [$this->Blog->getEyeCatch()](http://wiki.basercms.net/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/ | + | [$this->Blog->getEyeCatch()](http://wiki.basercms.net/ver4/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/Blog_getEyeCatch) |
− | [[Category: | + | [[Category:関数リファレンスver4]] |
2016年11月4日 (金) 20:34時点における最新版
目次
説明
ブログテンプレート内に記述することで、アイキャッチ画像を表示します。
アイキャッチ画像は、ブログ記事編集画面からアイキャッチ画像欄にて登録することができます。
使い方
<?php $this->Blog->eyeCatch( $post , [$options] ) ?>
パラメーター
- $post
- (array)ブログ記事の連想配列 必須
- $options
-
(array)img要素の属性等を任意で連想配列で指定
- 初期値 : array()
- * - `imgsize` : 画像サイズ[thumb|small|medium|large](初期値 : thumb)
- * - `link` : 大きいサイズの画像へのリンク有無(初期値 : true)
- * - `escape` : タイトルについてエスケープする場合に true を指定(初期値 : false)
- * - `mobile` : モバイルの画像を表示する場合に true を指定(初期値 : false)
- * - `alt` : alt属性(初期値 : )
- * - `width` : 横幅(初期値 : )
- * - `height` : 高さ(初期値 : )
- * - `noimage` : 画像が存在しない場合に表示する画像(初期値 : )
- * - `tmp` : 一時保存データの場合に true を指定(初期値 : false)
- * - `class` : タグの class を指定(初期値 : img-eye-catch)
- * - `force` : 画像が存在しない場合でも強制的に出力する場合に true を指定する(初期値 : false)
- ※ その他のオプションについては、リンクをつける場合、HtmlHelper::link() を参照、つけない場合、Html::image() を参照
戻り値
- (void)
用例
基本
コード
<?php $this-Blog->eyeCatch($post) ?>
出力
<img src="/files/blog/news/blog_posts/2014/10/00000002_eye_catch__thumb.jpg?1990889830" alt="" style="opacity: 1;">
応用
コード
<?php $this->Blog->eyeCatch($post, array('class'=>'example', 'alt'=>'example', 'width'=>'150px', 'height'=>'200px', 'noimage'=>'common/noimage.png')); ?>
出力
<img src="/files/blog/news/blog_posts/2014/10/00000002_eye_catch__thumb.jpg?2033206307" alt="example" width="150px" height="200px" style="opacity: 1;">
注
変更履歴
ソースファイル
関連資料
http://forum.basercms.net/modules/newbb/viewtopic.php?topic_id=1043&forum=8