howto/install/highlevel/plugin_configuration/thumbnail_setting - mail2weblog（高機能メール投稿型モブログ） Wi...

高度なカスタマイズ方法

Outline

1. 写真のサムネイル作成指定(version 1.3.6 ～)
   1. 1. デコメールを利用した貼り付け画像のサムネイル作成指定
   2. 2. 添付ファイルと img 書式プラグインの組み合わせにより貼り付けた画像のサムネイル作成指定

写真のサムネイル作成指定(version 1.3.6 ～)

画像の貼り付けには大きく以下の２つの方法があります。

1. デコメールを利用したメール本文への直接貼り付け
2. 添付ファイルと img 書式プラグインの組み合わせによる画像の貼り付け

これらの設定は、個別に行う必要があります。

混同を少なくするため両方とも同じ設定にしておくことを推奨します。

---

1. デコメールを利用した貼り付け画像のサムネイル作成指定

デコメールでは大小様々な画像を貼り付けることになると思います。

「デコメ絵文字」も「写真」もデコメール上ではどちらも等しく画像であり、大きな違いはありません。

大きいなサイズの「写真」はサムネイル表示したいでしょうが、小さなデコメ絵文字のサムネイル表示をしても意味はありません。むしろブログの記事が読みづらくなります。

そのため一定サイズ以上の画像に対してのみサムネイルの作成／表示を行う機能を提供します。

標準では

• 画像の幅が 300 ピクセル以上の場合
• 一律、画像の幅を 400 ピクセルに統一してサムネイル表示を行う
• サムネイルの画像の縦横比はそのまま

となっています。具体例を以下に示します。

• 300 ピクセル未満の小さな画像（例えばデコメ絵文字等）はそのまま元画像のみを表示する
• 300 ピクセルの場合は 400 ピクセルに拡大したサムネイル表示を行う
• 400 ピクセル以上の場合は 400 ピクセルに縮小したサムネイル表示を行う

となります。

ブログの体裁として、画像のサイズを一定に揃えた方が統一感が得られるという判断から、このような設定になっています。

この設定を変更するには、conf/02_user/plugin.rb の以下の行を書き換えます。

# ウェブログプラグインの設定を行います。
M2W_WEBLOG_PLUGIN_CONF = {
  'COMMON' => {
    # デコメで貼り付けた画像のサムネイル表示をする場合に設定します。
    # 設定しなかった場合、画像のサムネイル表示は行われません。
    #'thumbnail_condition_width' => '300',
    #'thumbnail_width' => '400',
  }
}

設定できる値を以下にまとめます。

キー名	デフォルト値	役割	指定例
thumbnail_condition_width	300	ピクセル単位で指定する。指定した場合、画像の幅が指定した値より大きい場合にサムネイルを作成する。	'condition_width' => '400'
thumbnail_condition_height	なし	ピクセル単位で指定する。指定した場合、画像の高さが指定した値より大きい場合にサムネイルを作成する。	'condition_height' => '400'
thumbnail_scale	なし	添付ファイルの画像に対するサムネイルのサイズ比率をパーセントで指定する。100 が同一サイズを表し 50 が半分のサイズを表す。拡大指定も可能である。	'scale' => '50'
thumbnail_width	400	サムネイルの最終的な幅をピクセル単位で指定する。	'width' => '100'
thumbnail_height	なし	サムネイルの最終的な高さをピクセル単位で指定する。	'height' => '100'
thumbnail_keep	1	width もしくは height の片方のみの指定を行った場合、縦横比の維持を行う場合指定する。nil もしくは空文字を指定した場合、縦横比の維持は行わない。それ以外の場合、縦横比の維持を行う。	'keep' => nil
thumbnail_template_name	simple	サムネイル作成時に利用する HTML テンプレートの名前を指定する。	'template_name' => 'simple'

• thumbnail_condition_width と thumbnail_condition_height の両方を指定した場合、どちらかの条件を満たせばサムネイルを作成する。どちらの条件も満たさなかった場合、サムネイルは作成しない。
• thumbnail_scale を指定した場合、thumbnail_width と thumbnail_height よりも thumbnail_scale を優先する。
• thumbnail_width と thumbnail_height の両方を指定した場合、thumbnail_keep の指定は無視される。

以上の設定は、デコメールに貼りつけた全ての画像に対して一律であり、個別に設定することはできません。

個別に画像のサムネイル作成指定を行いたい場合は、次に説明する「添付ファイルと img 書式プラグインの組み合わせによる画像の貼り付け」を利用してください。

---

2. 添付ファイルと img 書式プラグインの組み合わせにより貼り付けた画像のサムネイル作成指定

詳細は、img 書式プラグインの説明を参照してください。

img 書式プラグインによる画像のサムネイル作成指定は、 書式プラグインのオプションで指定します。

オプションのデフォルト値は「1. デコメールを利用した貼り付け画像のサムネイル作成指定」と 同じ動作をするよう

• 画像の幅が 300 ピクセル以上の場合
• 一律、画像の幅を 400 ピクセルに統一してサムネイル表示を行う
• サムネイルの画像の縦横比はそのまま

となっています。

img 書式プラグインのデフォルト値を変更するには、conf/02_user/plugin.rb の以下の行を書き換えます。

M2W_FORMAT_PLUGIN_CONF = {
  # img 書式プラグインで画像を貼り付ける際、標準でサムネイル表示する場合に設定します。
  #'img' => {
  #    'thumbnail' => 'true',
  #    'thumbnail_condition_width' => '300',
  #    'width' => '400',
  #    'keep' => 'true',
  #},
}

デフォルトでのサムネイル作成を無効にする例を示します。

M2W_FORMAT_PLUGIN_CONF = {
  # img 書式プラグインで画像を貼り付ける際、標準でサムネイル表示する場合に設定します。
  'img' => {
    '!thumbnail' => '',
    '!thumbnail_condition_width' => '',
    '!width' => '',
    '!keep' => '',
  },
}

設定方法の詳細はimg 書式プラグインと合わせて書式プラグインのオプションの標準値設定も参照してください。

---