redfinch / redfinch-image-resize
为WordPress上传的图像提供简单的辅助函数进行缩放
Requires
- php: >=7.1
This package is auto-updated.
Last update: 2024-09-10 19:47:01 UTC
README
使用图像时,WordPress可能很难使用。特别是当您想为模板提供多个图像大小时,结果可能要么将缩放责任推给最终用户,要么拥有一个极其庞大的上传目录。
此插件旨在简单解决此问题,无需任何额外的库。它将自动将您自定义的大小添加到附件元数据中,这意味着在删除时,所有任意大小也将被删除。
安装
如果您正在使用roots/bedrock或此变体,安装只需运行composer require redfinch/redfinch-image-resize。
手动安装,请转到版本页面并下载最新版本。将文件解压到您的WordPress插件目录中。
使用插件
该插件针对开发者,因此没有管理界面。该插件公开了四个主要函数
redfinch_resize_image
此函数将图像按比例缩放以适应X和Y值。
<img src="<?php echo redfinch_resize_image($attachment_id, 320, 120); ?>" />
redfinch_resize_post_thumbnail
这是一个辅助函数,用于缩放当前帖子的特色图像。您可以选择传递一个WP_Post或帖子ID作为最后一个参数,以显示特定帖子或页面上的图像。
<img src="<?php echo redfinch_resize_post_thumbnail(320, 120); ?>" />
redfinch_crop_image
这与resize()函数非常相似,但它将裁剪图像以适应,确保图像始终具有给定的尺寸。
<img src="<?php echo redfinch_crop_image($attachment_id, 450, 450); ?>" />
redfinch_crop_post_thumbnail
与resize()相同,但确保特色图像始终具有给定的尺寸。您可以选择传递一个WP_Post或帖子ID作为最后一个参数,以显示特定帖子或页面上的图像。
<img src="<?php echo redfinch_resize_post_thumbnail(320, 120); ?>" />
钩子
过滤器
redfinch_image_resize_get_path
返回缩放图像生成的路径。传递的值是字符串,它期望返回一个字符串。
redfinch_image_resize_get_url
返回缩放图像生成的URL。传递的值是字符串,它期望返回一个字符串。
操作
redfinch_image_resize_pre_generate_image
此操作在调用WP_Image_Editor对象的resize()方法之前触发。单个参数是图像编辑实例。
redfinch_image_resize_post_generate_image
此操作在调用WP_Image_Editor对象的resize()方法之后触发。单个参数是图像编辑实例。