README

这是一个模块集合，允许在 Drupal 实例中将 DC-X 媒体资产管理服务用作媒体图像实体源，通过拖放界面导入它们。默认情况下，它旨在提供 Drupal 网站上图像的唯一来源，允许跟踪导入图像在文章节点上的使用情况，并负责根据在线发布权限配置的图像可见性。

DC-X 模块家族包括以下模块

• dcx_integration
• dcx_migration
• dcx_article_archive
• dcx_article_import
• dcx_dropzone_ui
• dcx_entity_browser
• dcx_notification
• dcx_collection
• dcx_media_image_clone

dcx_integration

• 通过使用定制的 DC-X API 客户端版本，提供与 DC-X 的所有通信。"dcx_integration.client" 服务中无其他模块直接与 DC-X 通信。
• 提供 DC-X 客户端凭证的设置表单。请参阅路由 "dcx_integration.json_client_settings"。
• 通过返回基于 Drupal\dcx_integration\Asset\BaseAsset 的 PHP 对象，而不是反序列化的 JSON 数组，提供 DC-X 文档的抽象层。请参阅 Drupal\dcx_integration\JsonClient::getObject()。
• 提供调试控制器以检查 DC-X 服务器与 Drupal 之间的通信。请参阅路由 "dcx_integration.dcx_debug_controller_debug"。

dcx_migration

• 提供导入服务，允许单个或批量导入 DC-X 图像。该服务与迁移模块无缝集成 - 一旦导入图像，它就可以通过迁移进行更新和回滚。请参阅服务 "dcx_migration.import"。
• 提供简单的表单，通过提供其 DC-X ID 作为字符串来导入媒体项。请参阅路由 "dcx_migration.form"。

dcx_article_archive

• 提供将节点：文章实体存档到 DC-X 的功能，包括节点上引用的图像。请参阅模块文件中的实体插入/更新钩子。

dcx_dropzone_ui

• 提供 "dcxdropzone" 渲染元素，允许通过拖放导入图像。请参阅 Drupal\dcx_dropzone_ui\Element\DcxDropzone。

dcx_entity_browser

• 将 DC-X Dropzone 元素集成到 EntityBrowser 中。请参阅 Drupal\dcx_entity_browser\Plugin\EntityBrowser\Widget\DcxDropzoneWidget。

dcx_notification

• 提供回调 URL，允许 DC-X 触发实体更新以反映数据更改。主要用途是通知 Drupal 媒体项，如果相应的图像文档已更改。请参阅路由 "dcx_notification.trigger"。

dcx_track_media_usage

• 提供图像的使用跟踪，即它通知 DC-X 图像文档，在 Drupal 中使用的事实。请参阅模块文件中的实体插入/更新钩子。
• 提供插件基服务以发现文章节点上引用的 media:image 实体。

dcx_article_import

• 提供第二个 Dropzone 以从 DC-X 导入文章。这些文章可以在导入期间拆分为段落。

dcx_collection

• 将收藏视图附加到 Dropzone 元素，以显示用户的自定义收藏夹，并使其更容易从这些收藏夹中导入图像。

dcx_media_image_clone

• 允许克隆媒体图像实体，并跟踪与 DC-X 相关的克隆