README

轻松从附件库或文章、页面或自定义文章类型ID生成随机图片。

描述

使用这个小工具，您可以轻松快速地访问从库或使用文章ID的随机图片组，您可以通过大小访问这些图片的ID或每个图片的 src。

要求。

• WordPress
• PHP 5.3 >=

安装

您可以通过composer将此库添加到您的主题或插件中，只需将此库作为依赖项添加，只需运行

composer require mitogh/random-image

之后，请确保您使用composer的autoload文件包含库

include './vendor/autoload.php';

或直接使用文件。

include 'vendor/mitogh/random-image/src/RandomImage.php';

用法

为了访问公共函数，您需要创建一个 RandomImage 类的实例，如下所示

$randomImage = new mitogh\RandomImage();

可选地，您可以将参数数组传递给更新在检索随机图片之前的一些参数，参数如下

• count: 您可以指定要搜索的图片数量，默认为1。
• parent_ID: 如果您不想在整个附件库中搜索，您可以指定页面、文章或文章类型的ID，默认为null，搜索整个库。

例如，如果您想从ID为2的页面中获取3张随机图片。

$args = array(
  'count' => 3,
  'parent_ID' => 2,
);
$randomImage = new mitogh\RandomImage( $args );

过滤器

此外，您可以使用过滤器 mitogh_rand_image_mime_type 更新默认的搜索文件mime类型，默认的mime类型是

image/jpeg
image/gif
image/png
image/bmp
image/tiff

您可以使用过滤器返回一个类型数组来更新此内容，例如，仅搜索gif图片

add_filter( 'mitogh_rand_image_mime_type', function( $default_types ) ) {
    return array(
		'image/gif',
    );
});

公共方法

您可以通过 RandomImage 实例访问2个方法，方法如下

get_ids

使用此方法，您可以访问每个图片的ID，然后通过拥有图片的ID，您可以使用其他功能来操作每个图片，如下所示

$randomImage = new mitogh\RandomImage();
$images_id = $randomImage->get_ids();
// Now images_id has an array with the id of each image, and you can use 
// each id to operate over each image.

get_srcs

此方法将返回一个包含每个图片src属性的数组，因此您可以在 <img> 标签中使用每个值。此外，您可以在返回之前指定图片的大小（所有图片）。

$randomImage = new mitogh\RandomImage();
$images_src = $randomImage->get_srcs( 'full' );
// Now images_src has an array with the src value of the images with the
// full size.