README

搜索并添加 Widen 数字资产到您的 WordPress 媒体库。

此 WordPress 插件允许用户在 Widen 中搜索图片并将它们添加到网站的媒体库中。此插件不会从 Widen 下载媒体，而是创建一个新的 WordPress 媒体附件，该附件引用 Widen 资产 URL。在“添加到媒体库”操作中捕获并保存一些额外的 Widen 元数据。此插件目前不支持 Widen 与 WordPress 之间的元数据同步。

安装

您可以通过 下载发布压缩包 并通过 WordPress 插件安装器或通过 composer 进行安装。

Composer

composer require masonitedoors/widen-media

配置

WordPress

此插件使用 Widen API 的 V2 版本。您需要在 wp-config.php 中定义您的 Widen API 访问令牌。

define( 'WIDEN_MEDIA_ACCESS_TOKEN', 'my-widen-api-token' );

Widen 元数据

在“添加到媒体库”操作中捕获并保存一些额外的 Widen 元数据到数据库中。此插件目前不支持 Widen 与 WordPress 之间的元数据同步。

集合

此插件将 Widen 集合保存为 wm_collection 类型文章，以便其他主题和插件可以访问这些数据，而无需直接与 Widen API 交互。

在“添加新”的主搜索页中，用户可以在搜索 Widen 时切换“集合”。这将只返回与该集合名称匹配的结果。

在搜索集合时，将显示一个“保存集合”按钮。此按钮将当前结果页的集合保存到 wp_collection 类型新文章的元数据中。注意，大于 100 个资产的集合将只保存当前结果页上的 100 个资产。

定义自定义图片大小

此插件附带一些默认图片大小，但如果您希望在另一个插件或主题中更改这些定义的大小，则包含了一个过滤器。

示例函数定义 2 个图片大小

function filter_defined_image_sizes( $default_image_sizes ) {
  $sizes = [
    'banner-sm' => [
      'label'  => __( 'Small Banner', 'textdomain' ),
      'width'  => 820,
      'height' => 312,
    ],
    'banner-lg' => [
      'label'  => __( 'Large Banner', 'textdomain' ),
      'width'  => 1500,
      'height' => 500,
    ],
  ];

  // Uncomment to append sizes to the plugin's already defined sizes.
  // $sizes = array_merge( $sizes, $default_image_sizes );

  return $sizes;
}
add_filter( 'wm_defined_image_sizes', 'filter_defined_image_sizes', 10, 1 );

插件 API

此插件提供了一些函数，允许其他插件轻松地与已导入 WordPress 的 Widen 数据以及 Widen API 交互。

wm_get_collections()

返回一个集合对象的数组。

wm_get_collection( int $collection_id )

返回集合对象。

wm_get_asset_fields( int $asset_id )

返回 WordPress 媒体库中存在的资产的所有字段。

wm_get_asset_field( int $asset_id, string $key, bool $single = false )

返回 WordPress 媒体库中存在的 Widen 资产的单个字段。