WordPress函数`add_image_size`用于注册并定义新的图像尺寸。通过使用该函数,您可以为网站的不同部分或功能添加自定义的图像尺寸。

下面是`add_image_size`函数的用法说明:

1. 基本语法:

add_image_size( string $name, int $width, int $height, bool|array $crop = false )

2. 参数说明:

- `$name`:(必填)自定义图像尺寸的名称。这个名称将用于在代码中引用该尺寸。
- `$width`:(必填)自定义图像尺寸的宽度。
- `$height`:(必填)自定义图像尺寸的高度。
- `$crop`:(可选)是否裁剪图像以适应指定的尺寸。默认情况下,图像将被缩放以适应指定的尺寸。如果设置为`true`,图像将被裁剪以填充指定的尺寸。如果设置为一个数组,可以指定裁剪的位置,如`array( 'left', 'top' )`。

3. 示例代码:

// 添加一个尺寸为300x200像素的图像尺寸
add_image_size( 'custom-thumbnail', 300, 200, true );

上述代码会注册一个名为`custom-thumbnail`的图像尺寸,宽度为300像素,高度为200像素,并且会裁剪图像以填充指定的尺寸。

4. 在主题模板中使用自定义图像尺寸:

// 获取带有自定义图像尺寸的缩略图

以上代码将在页面模板中获取带有自定义图像尺寸`custom-thumbnail`的缩略图。

总结:`add_image_size`函数是WordPress中用于注册和定义自定义图像尺寸的函数。通过注册自定义图像尺寸,您可以在主题模板中使用这些尺寸来显示缩略图。