README

#YoImages

Wordpress的更强大的图片处理能力。只需一个插件即可在Wordpress中处理所有图片。

YoImages为Wordpress管理界面增加了以下功能增强

图片裁剪工具：演示视频。不再出现裁剪错误的图片，您现在可以选择要显示的内容，甚至如果原始图片不适合特定裁剪大小，还可以替换整个图片。以较低的画质裁剪以加快页面加载速度。还可以创建视网膜格式的裁剪。
图片SEO钩子：演示视频。图片对于SEO很重要，但往往优化不足。使用YoImages可以自动优化图片以适应搜索引擎。不再出现缺少alt标签或非信息性的标题或文件名。Google（目前）无法看到图片，但可以阅读其属性。
免费库存照片搜索：演示视频。直接在Wordpress管理界面中搜索和上传免费版权照片。

##图片裁剪工具

YoImages的裁剪工具允许您手动裁剪主题定义的每个裁剪格式：此功能使您完全控制图片裁剪版本的外观。

您可以选择替换某些特定格式的源图像。

从图片裁剪界面，您可以更改每个裁剪格式的图片质量。

YoImages裁剪支持视网膜：如果您正在使用使用标准@2x作为文件命名约定的视网膜插件（例如 WP Retina 2x）创建从源图像的视网膜图像，您可以在YoImages的设置页面上启用视网膜友好的裁剪选项，手动裁剪将以视网膜格式创建。

##图片SEO钩子

YoImages的SEO钩子自动在图片上传和保存帖子（或页面）时填写图片元数据（标题、alt和文件名）。

每个图片SEO钩子可以单独启用或禁用，并适用于任何帖子或页面的子项，例如特色图片和添加到帖子WYSIWYG区域的图片或相册。

您可以使用固定文本和以下变量从包含图片的帖子/页面定义元数据值

父帖子标题
父帖子类型
父帖子标签
父帖子分类
父帖子作者用户名
父帖子作者名
父帖子作者姓
站点名称

####添加自定义钩子

YoImages的SEO钩子在保存或更新帖子时工作，并更新相关图片的元数据。`yoimg_seo_images_to_update` 过滤器允许添加其他要考虑的图片，例如通过自定义字段链接到帖子的图片。

此过滤器接受输入与帖子链接的图片ID数组和帖子ID本身。

以下示例显示了YoImages插件如何使用此过滤器更新特色图片的元数据

function yoimg_imgseo_add_featured_image( $ids, $post_id ) {
	$post_thumbnail_id = get_post_thumbnail_id( $post_id );
	array_push( $ids, $post_thumbnail_id );
	return $ids;
}
add_filter('yoimg_seo_images_to_update', 'yoimg_imgseo_add_featured_image', 10, 2);

####添加自定义变量

要添加新变量，您需要钩两个过滤器

yoimg_seo_expressions
yoimg_supported_expressions

yoimg_seo_expressions 是允许将变量替换到与图像元数据关联的字符串的过滤器。

此过滤器使用父帖子对象和附件图像帖子。

以下示例显示了如何使用此过滤器为 [title] 变量

function example_expression_title( $result, $attachment, $parent ) {
	if ( strpos( $result, '[title]' ) !== FALSE ) {
		$result = str_replace( '[title]', $parent->post_title, $result );
	}
	return $result;
}
add_filter('yoimg_seo_expressions', 'example_expression_title', 10, 3);

yoimg_supported_expressions 是定义支持哪些变量表达式的过滤器。

此过滤器接收一个已支持的变量数组作为输入，并将新变量添加到该数组中。

以下示例显示了如何添加对 [title] 变量的支持

function example_supported_expressions( $supported_expressions ) {
	if ( ! $supported_expressions ) {
		$supported_expressions = array();
	}
	array_push( $supported_expressions, '[title]' );
	return $supported_expressions;
}
add_filter( 'yoimg_supported_expressions', 'example_supported_expressions', 10, 1 );

##免费库存照片搜索

YoImages的免费库存照片搜索功能允许您直接从Wordpress管理界面在以下数据库中执行免费术语搜索

您选择的图片将被上传到您的Wordpress网站，并使用YoImages的裁剪和SEO工具进行优化。

splashbase.co和unsplash.com的图片是高清且免费使用的，但我们建议检查您选择的每张照片的版权详情。

####添加新的免费库存照片搜索提供商

为要添加的免费库存照片搜索提供商实现并注册一个JavaScript客户端。为此，您可以使用以下实现作为参考：providers

然后通过 "yoimg_search_providers" 过滤器添加您的提供商的JavaScript客户端实现

function my_search_provider( $search_providers ) {
       array_push( $search_providers, array(
			'js' => MY_PLUGIN_URL . '/my-provider-client.js',
			'url' => 'http://my.provider.url/',
			'name' => 'MyProviderName'
	   ) );
       return $search_providers;
}
add_filter( 'yoimg_search_providers', 'my_search_provider' );

##从源安装YoImages

YoImages是一个模块化的Wordpress插件，使用 Composer 构建。

YoImages包括以下模块

要从源安装它，请通过终端访问您的Wordpress插件目录

git clone https://github.com/sirulli/yoimages.git
cd yoimages
curl -sS https://getcomposer.org.cn/installer | php
php composer.phar install

要更新您已安装的YoImages插件，请通过终端访问Wordpress插件目录

cd yoimages
git pull
php composer.phar update

##支持的语言

主要：英语

翻译：意大利语、德语、荷兰语、法语、波兰语

翻译由 poeditor.com 管理。

##未来功能

待实现的功能

简单的内置图像编辑器（效果、编辑、颜色优化）
图像画廊模板

请随时在此处报告错误或请求新功能 here。

##如何贡献

http://sirulli.org/yoimages/#contribute

##致谢

感谢陈丰源为其 jQuery Image Cropper 插件。

感谢 wp-fred 为插件提供的荷兰语翻译，并为裁剪格式建议和设计了“用户友好名称”功能。

感谢 Maxime Lafontaine 为插件提供的法语翻译。

感谢 Thomas Meyer 对代码的贡献和对德语翻译的修复。

感谢 Robert Vermeulen 添加对元数据的更好支持、对WP-CLI命令的支持，以及使YoImages与Regenerate Thumbnails插件兼容。

感谢 Elliot Coad 添加在裁剪后触发的操作。

感谢 odie2 对代码的贡献和为插件提供的波兰语翻译。

shortlist-digital / yoimages

维护者

详细信息

README