ブログに差をつける! WordPressでアップロードした画像を綺麗に見せる方法は、PHPのimageconvolution()で自動的にシャープを掛ける

2023年3月20日2024年1月24日

当ページのリンクには広告が含まれています。

WordPressの記事内に画像を挿入すると、ボヤケてハッキリしなくなります。画像をアップロードしたタイミングでシャープに加工する、という処理をfunctions.phpに追加すれば、問題は解決します。

ソースコード

functions.phpに書くソースコードは下記です。



function custom_image_upload_filter( $metadata, $attachment_id ) {
  
  // シャープの設定値
  $sharpen_matrix = array(
    array(-1, -1, -1),
    array(-1, 16, -1),
    array(-1, -1, -1),
  );
  $divisor = array_sum( array_map( 'array_sum', $sharpen_matrix ) );

  // シャープを掛けるファイルタイプ
  $allow_mime_type = array( 
  	'image/jpeg',
  );

  // アップロードファイルのフルパスを取得
  $attached_file_path = get_attached_file( $attachment_id );

  // 添付ファイルのアップロードディレクトリを取得
  // 投稿画面からだと投稿日のディクレトリにアップされるためwp_upload_dir()は使えない
  $attached_file_dir = dirname( $attached_file_path );


  // MIMEタイプを取得
  $finfo = new finfo();
  $attached_mimetype = $finfo->file( $attached_file_path, FILEINFO_MIME_TYPE );

  // ファイルタイプの判別  
  if( in_array( $attached_mimetype, $allow_mime_type ) ){

    // サイズのバリエーション全てが対象とする
    foreach(  $metadata['sizes'] as $key ){
  
        // 画像ファイルのフルパス
        $img_path = $attached_file_dir . '/' . $key['file'];
    
		// 画像のオブジェクト的なものを生成します。
		$im = @imagecreatefromjpeg( $img_path );
  
		// シャープの処理
		imageconvolution( $im, $sharpen_matrix, $divisor, 0 );
  
		// jpg画像として保存
		imagejpeg( $im, $img_path );

		// 画像のオブジェクト的なものを破棄します。
		imagedestroy( $im );
    }
  }
    return $metadata;
}
add_filter( 'wp_generate_attachment_metadata', 'custom_image_upload_filter', 10, 2 );

ソースコードの解説

自動的にシャープを掛ける為に、やっていることは下記です。

wp_generate_attachment_metadataフックで、ファイルアップロード時に動作させる。
wp_upload_dir()でアップロードディレクトリを取得する。
jpg画像のみ（image/jpeg）を対象とする。
各縮小サイズがある限り（$metadata[‘sizes’]）をforeachで回す。
imagecreatefromjpegでJPG画像にする。
imageconvolutionで画像をシャープに加工する。
imagejpegで、画像をディレクトリに保存する。
imagedestroyで画像を解放する。

最初に、wp_get_image_editor()を使うべきかと悩んだのですが、シャープにするメソッドが無いので却下しました。

シャープのソースを入れても、さらにボヤケてしまう場合

上記のソースを使うと、メディア設定の縮小画像に対して、シャープが掛かります。でも、これだけだと、シャープにならずに変わらずボヤケてしまう場合があります。正確には、シャープは掛かっているんだけれども、ブログで表示の仕方に問題がある場合です。

ボヤケてしまう理由は下記のいずれかです。

widthやheight属性値が実際の大きさと違う
CSSでimgタグにpaddingやmarginとともに、box-sizing: border-box;が指定されている
WordPressテーマ特有の仕組みが入っている

それぞれの解決方法を以下に書きます。３に関しては、このブログで使用している賢威８の方法のみになります。

１．widthやheight属性値が実際の大きさと違う

例えば、700サイズの画像を500で表示した比較です。

widthを700に設定

widthを500に設定

属性値のwidthやheightで縮小させないためには、属性値そのものを削除するか、画像の大きさとピッタリ同じ属性値を設定すると良いです。WordPressのテーマによって属性値の設定は変わることがあります。

私は、メディア設定の中サイズに対して、700を設定しています。属性値の削除はしておりません。もしwidthとheightを削除したい場合は、functions.phpに下記を書いてください。



add_filter( 'post_thumbnail_html', 'remove_width_attribute', 10 );
add_filter( 'image_send_to_editor', 'remove_width_attribute', 10 );
 
function remove_width_attribute( $html ) {
   $html = preg_replace( '/(width|height)="\d*"\s/', "", $html );
   return $html;
}

２．CSSでimgタグにpaddingやmarginとともに、box-sizing: border-box;が指定されている

画像へ額縁のように隙間を空けて枠線を引いている場合、box-sizing: border-box;が指定されていると、自動で縮小され画像がボヤケます。このブログでも枠線を引いています。

テーマの仕様としてbox-sizing: border-box;が指定されているので、box-sizing: content-box;でボヤケないように指定をしています。これで枠線を書いても大丈夫です。

３．WordPressテーマ特有の仕組みが入っている

私がこのブログで使用している賢威８に限定した解決方法になります。

賢威８は、画像のクラスに wp-image-xx が入っていると、srcsetが自動で挿入されて、画像がボヤケます。賢威８を使っている場合に限り、クラスからwp-image-xx を消す処理を入れると解決します。



add_filter('get_image_tag_class', 'custom_image_tag_class', 10, 4 );

function custom_image_tag_class( $class, $id, $align, $size ){
  
  // 初期値　'align' .  esc_attr( $align ) . ' size-' .  esc_attr( $size )  . ' wp-image-' . $id
  
    return 'align' .  esc_attr( $align ) . ' size-' .  esc_attr( $size );
}

クラス有り

クラス無し