dl/assetsource-mediawiki

Neos CMS 的 MediaWiki 资源源

1.3.3 2022-04-06 20:26 UTC

This package is auto-updated.

Last update: 2024-08-29 10:54:51 UTC


README

Latest Stable Version Total Downloads License

MediaWiki 资源源

此资源源使用 MediaWiki 安装(如 维基百科MediaWiki Commons其他任何 Media Wiki 实例)的公共 API,以便在 Neos 安装中搜索使用的资源。

安装

使用 composer 安装此软件包

composer require dl/assetsource-mediawiki

配置

您可以为不同的 wikimedia 实例添加任意数量的此资源源以查询 - 例如,英文和德文实例。为此,只需在自定义标识符下添加另一个配置块并指定特定设置。

访问德文维基百科的示例

Neos:
  Media:
    assetSources:
      wikipedia_de:
        assetSource: 'DL\AssetSource\MediaWiki\AssetSource\MediaWikiAssetSource'
        assetSourceOptions:
          domain: de.wikipedia.org
          label: Wikipedia (DE)
          searchStrategy: DL\AssetSource\MediaWiki\Api\SearchStrategies\ArticleSearchStrategy
          searchStrategyOptions:
            articleLimit: 10
          useQueryResultCache: true
          excludedIdentifierPatterns:
              - '*.svg'

搜索策略

在维基百科中搜索图片有些复杂。首先,不仅有维基百科的一个实例,每个可用语言都有一个实例。其次,图片可以存储在特定语言的维基百科中或存储在维基媒体共享中并从那里包含。

此软件包提供了两种不同的搜索策略,各有优缺点。

直接图片搜索策略

searchStrategy: DL\AssetSource\MediaWiki\Api\SearchStrategies\DirectImageSearchStrategy

此搜索策略使用文件名和可用的元数据(如资源的描述)进行搜索。这意味着如果您将 commons.wikimedia.org 配置为域名,该软件包将搜索所有语言中可用的约 5000 万个资源。但出于历史原因,一些图片直接存储在特定语言的维基百科实例中,因此该设置不可用。

文章搜索策略(默认)

searchStrategy: DL\AssetSource\MediaWiki\Api\SearchStrategies\ArticleSearchStrategy

此搜索策略更适合维基百科用例。它不直接搜索图片,而是使用更强大的文章搜索来获取一系列维基文章,然后查询显示在这些文章上的图片。好处是,如果您将域名配置为 en.wikipedia.org,您将获得直接上传到此实例的资源以及上传到维基媒体共享的所有匹配资源。

在您的项目中使用图片

请在前端正确处理已使用照片的归属

已知问题

查看已知问题和缺少的功能列表。