wwwision/neos-assetsource-pimcore

Neos CMS 的 Pimcore 资产源

1.3.0 2023-04-18 08:22 UTC

This package is auto-updated.

Last update: 2024-09-18 11:18:37 UTC


README

Pimcore 为 Neos CMS 提供资产源

设置

通过 composer 安装包

composer require wwwision/neos-assetsource-pimcore

配置 Pimcore 资产源

在全局(或站点特定)Settings.yaml

Neos:
  Media:
    assetSources:
      'pimcore':
        assetSource: 'Wwwision\Neos\AssetSource\Pimcore\AssetSource\PimcoreAssetSource'
        assetSourceOptions:
          label: 'Pimcore'
          description: 'Pimcore Asset Source'

          api:
            baseUrl: '<https://pimcore-base.url>'
            endpoint: '<datahub configuration name>'
            apiKey: '<datahub api key>'

注意:可以通过 additionalConfiguration 定义 HTTP 客户端的附加选项。例如,为了禁用 SSL 检查

Neos:
  Media:
    assetSources:
      'pimcore':
          # ...
          api:
            # ...
            additionalConfiguration:
              verify: false

(可选)禁用 Neos 资产源

如果应仅使用 Pimcore 资产源,则可以通过 Settings.yaml 在全局范围内禁用内置的 "neos" 资产源

Neos:
  Media:
    assetSources:
      'neos': ~

Pimcore

为了使 Pimcore API 与此包一起工作,需要以下步骤

激活 GraphQL 配置

需要 Datahub GraphQL 配置,至少具有对 AsssetAsset FolderAsset Listing 类型的 Read 访问权限

图像缩略图配置

应创建两个图像缩略图配置,以便在 Neos 后端提供良好的用户体验

  • thumbnail,包含 250x250 px 的 Contain 转换
  • preview,包含 1200x1200 px 的 Cover 转换

或者,可以指定 thumbnailConfigurationName 和/或 previewThumbnailConfigurationName 选项来使用不同的缩略图配置

Neos:
  Media:
    assetSources:
      'pimcore':
          # ...
          api:
            # ...
            thumbnailConfigurationName: 'gallery-thumbnail'
            previewThumbnailConfigurationName: 'gallery-full-width'

鸣谢

此包的开发得到了 Marktplatz GmbH - Agentur für Web & App 的慷慨赞助。感谢您对开源发展的支持!

贡献

以问题或拉取请求的形式的贡献非常受欢迎

许可证

LICENSE