Sam Martin User Guide

The default image dimensions provided by WordPress are standard image sizes, but themes may require images of different sizes depending on the layout requirements.

We added the below custom image sizes in the Sam Martin theme.

Image Size Name	Image Width	Image Height	Cropped
sam-martin-post-thumbnails	500	333	false
sam-martin-banner-image	1920	490	false
sam-martin-post-images	1170	370	false
sam-martin-portfolio-slider	900	900	true

Despite this, users sometimes require a different image size as per the requirement. You must add custom image size(s) if you have any such requirements. To add your custom image size(s), you’ll need to follow the two steps below:

• Step 1. Register Image Sizes
• Step 2. Regenerate Thumbnails

Register Image Sizes

Hook your custom function to the sam_martin_image_sizes filter to add a new image size. Here below is the sample code, which you can add to the child theme’s functions.php.

function sam_martin_child_image_sizes( $image_sizes ) {
	// Add your image sizes.
	$image_sizes['sam_martin_custom_200'] = array(
		'name'  => 'sam_martin_custom_200',
		'width' => 200,
		'height'=> 200,
		'crop'  => true,
		'label' => esc_html__( 'Sam Martin Custom 200', 'sam-martin-child' ),
	);
	return $image_sizes;
}
add_filter( 'sam_martin_image_sizes', 'sam_martin_child_image_sizes' );

Please refer to the below documents for detailed information about the image size and names and labels of the image sizes.

• https://developer.wordpress.org/reference/functions/add_image_size/
• https://developer.wordpress.org/reference/hooks/image_size_names_choose/

Regenerate Thumbnails

If you add new image sizes to your existing site, you must regenerate the thumbnails. This is necessary because WordPress will only resize images that have been uploaded after registering the new image size.

Therefore, any image (added/uploaded before registration of the new image size) will not have any new size. So, you need to regenerate the new image size for the old images.

To regenerate the image, you can use the below plugins. For details about settings and usage, please refer to the instructions provided on the plugins page.

1. Regenerate Thumbnails
2. AJAX Thumbnail Rebuild

The newly added image size and size names will appear in different sections of the site.