wagtail-image-import

将图像从Google Drive导入到Wagtail Admin，包括识别潜在的重复项。

安装

将以下内容添加到您的设置文件中的INSTALLED_APPS，位于wagtail.admin之上

设置

Wagtail Image Import依赖于Google API，您需要先为项目启用这些API

1. 导航到Google API库。选择您的Wagtail站点的项目，或者创建一个新的项目。

2. 查找并启用Google Docs和Google Drive API。

3. 查找并启用Google Picker API，并将其API密钥复制到设置WAGTAIL_IMAGE_IMPORT_GOOGLE_PICKER_API_KEY中。

4. 在API控制台中打开凭据页面。

5. 选择创建凭据，然后选择OAuth客户端ID

6. 如果您尚未配置同意屏幕，您现在需要配置此屏幕。

   1. 在Google API作用域下，单击添加作用域。

   2. 添加../auth/documents.readonly和../auth/drive.readonly作用域。

      注意：添加这些敏感作用域意味着您需要将项目提交给Google进行验证，以避免使用期间的用户限制和警告页面。

   3. 将您的域添加到授权域。

7. 对于应用程序类型，选择Web应用程序。

8. 在授权JavaScript源下，添加您的域。

9. 在凭据页面中，单击您的客户端ID旁边的下载项以下载客户端密钥的JSON文件。

10. 从该文件中复制文本，并使用它设置WAGTAILIMAGEIMPORT_GOOGLE_OAUTH_CLIENT_SECRET。

重复比较设置

Wagtail图像导入将尝试识别图像的最可能重复项，如果它之前已被导入。默认情况下，它将通过比较每个导入的唯一驱动ID以及标题来实现。如果您只需要这些，可以跳过本节，或者仅用它来调整默认体验。

如果您正在使用自定义图像模型，您还可以将wagtail_image_import.models.DuplicateFindingMixin添加到您的自定义模型中，以提供更好的重复识别，暴露EXIF日期时间和md5哈希。以下是如何将其添加到一个非常基本的自定义图像模型的示例

from wagtail.images.models import Image, AbstractImage, AbstractRendition

from wagtail_image_import.models import DuplicateFindingMixin


class CustomImage(DuplicateFindingMixin, AbstractImage):
    admin_form_fields = Image.admin_form_fields


class CustomRendition(AbstractRendition):
    image = models.ForeignKey(
        CustomImage, on_delete=models.CASCADE, related_name="renditions"
    )

    class Meta:
        unique_together = (("image", "filter_spec", "focal_point_key"),)

如果您选择添加混入，并且有现有图像数据，您需要调用所有现有实例的save()来填写新字段。这可以在Django shell中完成

from wagtail.images import get_image_model

for image in get_image_model().objects.all():
    image.save()

为了调整重复查找过程，您可以使用WAGTAILIMAGEIMPORT_FIELD_MAPPING和WAGTAILIMAGEIMPORT_FIELD_WEIGHTING设置。

WAGTAILIMAGEIMPORT_FIELD_MAPPING将Google Drive字段名称映射到数据库字段名称。默认情况下，它是

{
    "id": "driveidmapping__drive_id",
    "name": "title",
}

如果您添加了混入，使用

{
    "id": "driveidmapping__drive_id", 
    "name": "title",
    "imageMediaMetadata__time": "exif_datetime",
    "md5Checksum": "md5_hash"

}

来映射新字段。（如果您有额外的自定义字段，完整的驱动器字段列表是：'id', 'name', 'thumbnailLink', 'fileExtension', 'md5Checksum', 'size', 'imageMediaMetadata__width', 'imageMediaMetadata__height', 'imageMediaMetadata__rotation', 'imageMediaMetadata__time'，尽管并非所有字段都存在于每张图像中）

要调整字段权重 - 在查找最可能的重复项中的相对重要性 - 您可以设置WAGTAILIMAGEIMPORT_FIELD_WEIGHTING，它将数据库字段映射到权重。默认值是

{
    "driveidmapping__drive_id": 10, 
    "md5Checksum": 5, 
    "title": 2
}

所有未列出的字段都赋予权重1。

其他设置

WAGTAILIMAGEIMPORT_SET_DRIVE_PARENT_FUNCTION：如果您想选择Google拾取器的起始文件夹，并防止导航到文件夹之外（请注意，由于拾取器选项的限制，这不会将搜索结果限制为该文件夹的子文件夹），则可以将此设置设置为字符串路径到函数。此函数必须接受请求对象，并返回父文件夹的字符串驱动器ID。

用法

对于超级用户或具有“导入”权限的用户（可以在Wagtail管理员组部分将此权限添加到组中），图像索引的“添加图像”按钮现在将是一个下拉菜单，带有额外的“从驱动器导入”选项。选择此选项可进入导入屏幕。

您可以选择文件夹（其所有直接图像子项将被导入 - 目前，子文件夹的子项被忽略）或图像。

选择后，Wagtail图像导入将找到潜在的重复项，如果找到重复项，则将您带到审查屏幕，您可以选择替换现有图像、保留两者或取消上传新图像。

确认后，将开始上传。随着图像导入完成，您将能够编辑它们的元数据。