grayishスキン適用中

レーティングスター(評価スター)ショートコードの利用方法

ショートコード
この記事は約3分で読めます。

Cocoon1.3.9から評価用の星を表示できるショートコード機能を追加しました。

\お得なキャンペーン実施中!/
エックスサーバーキャンペーン

レーティングスターショートコード

レーティングスター(評価スター)ショートコードは、以下のような記述で星をつけることができます。

[star rate="4.5"]

表示はこんな感じ。

4.5

ショートコードオプション

スターショートコードで使えるオプションはこちら。

rate(評価値)

rateには、0.1刻みで評価数値を入力します。

入力例:rate=”2”

入力例:rate=”3.8”

入力例:rate=”4.2″

デフォルト値:5

異常値が入力された場合は、入力された文字列がそのまま表示されます。
一応様々な表現に使えるように、評価数値は5以上も入力できるようになっています。ただ、あまりに多いと負荷がかかるため100までとなっています。

入力例

3.5
[star rate="3.5"]
4.0
[star rate="4"]

max(評価の最大値)

maxには、評価数値の最大値を入力します。

入力例:max=”10”

入力例:max=”3″

デフォルト値:5

入力例

2.0
[star rate="2" max="3"]
1.5
[star rate="1.5" max="10"]

number(数値表示切り替え)

numberには、評価数値を表示するかどうかを1か0かで切り替えます。

入力例:number=0(非表示)

入力例:number=1(表示)

デフォルト値:1(表示)

入力例

[star rate="2.5" number=0]
5.0
[star rate="5" number=1]

color(文字色変更)

colorオプションでは、文字色を変更できます(インラインスタイルにて指定されます)。

色コード等で指定できます。

入力例:color="#eb6ea5"

入力例:color="navy"

デフォルト値:(なし)

入力例

4.0
[star rate="4" color="#eb6ea5"]
4.0
[star rate="4" color="navy"]

表示サンプル

以下のような表示も可能です。

0.0
0.5
1.0
1.5
2.0
2.5
3.0
3.5
4.0
4.5
5.0

小数点表記もできます(星は半分ずつしか増えません)。

4.0
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9
5.0

5より多い数値も入力できます。

9.5
12.5
7.5

上限は100まで。

100.0

これで、星評価は5までという固定観念にとらわれない表現も出来るかと思います。

レビュー記事などで、ご利用ください。

タイトルとURLをコピーしました