PHPackages                             dl/assetsource-mediawiki - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. dl/assetsource-mediawiki

ActiveNeos-package[Utility &amp; Helpers](/categories/utility)

dl/assetsource-mediawiki
========================

MediaWiki Asset Source for Neos CMS

1.3.3(4y ago)43.7k2[2 issues](https://github.com/daniellienert/assetsource-mediawiki/issues)MITPHP

Since May 22Pushed 3y ago1 watchersCompare

[ Source](https://github.com/daniellienert/assetsource-mediawiki)[ Packagist](https://packagist.org/packages/dl/assetsource-mediawiki)[ RSS](/packages/dl-assetsource-mediawiki/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (9)Dependencies (2)Versions (10)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/81b18173fbdce5391343d92a8667fa6caff61cf623f5be9257f638528638d7bc/68747470733a2f2f706f7365722e707567782e6f72672f646c2f6173736574736f757263652d6d6564696177696b692f762f737461626c65)](https://packagist.org/packages/dl/assetsource-mediawiki) [![Total Downloads](https://camo.githubusercontent.com/dc1313562a058896e85d8e8954b86042307be70ac624576825cb3fa894455872/68747470733a2f2f706f7365722e707567782e6f72672f646c2f6173736574736f757263652d6d6564696177696b692f646f776e6c6f616473)](https://packagist.org/packages/dl/assetsource-mediawiki) [![License](https://camo.githubusercontent.com/644c1dacd6506af435d02661d668903a056644745a62681814ed041a297d6ac8/68747470733a2f2f706f7365722e707567782e6f72672f646c2f6173736574736f757263652d6d6564696177696b692f6c6963656e7365)](https://packagist.org/packages/dl/assetsource-mediawiki)

MediaWiki Asset Source
======================

[](#mediawiki-asset-source)

This asset source uses the public API of [MediaWiki](https://www.mediawiki.org/wiki/MediaWiki) installations like the [Wikipedia](https://en.wikipedia.org/w/api.php), [MediaWiki Commons](https://commons.mediaWiki.org) or [any other Media Wiki](https://wikistats.wmflabs.org/) instance to make the used assets searchable within a Neos installation.

Installation
------------

[](#installation)

Install the package via composer:

```
composer require dl/assetsource-mediawiki
```

Configuration
-------------

[](#configuration)

You can add arbitrary instances of this asset source, to query different wikimedia instances - e.g. the english and german instance. To do that, just add another configuration block with the specific settings under a custom identifier.

SettingDescriptiondomainThe domain on which the MediaWiki instance is available.labelThe label of the instance, shown in the backendsearchStrategyA class with implemented search strategy. See the section below for detailssearchStrategyOptionsSearch strategy specific optionsuseQueryResultCacheWhether or not to use the result cache for queries to the API. If used, speeds up the pagination a lot but may return outdated results. The caching lifetime defaults to 1 day.excludedIdentifierPatternsAsset identifiers which should be filtered out and not displayed. Used to filter out Wikipedias common icons.**Example for accessing the german Wikipedia:**

```
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'
```

Search Strategies
-----------------

[](#search-strategies)

Searching in the wikipedia for images is a bit tricky. First there is not only one wikipedia instance, but one for each available language. Second an image can be stored in the language specific wikipedia or in Wikimedia Commons and included from there.

The package brings two different search strategies with different pros and cons.

### Direct Image Search Strategy

[](#direct-image-search-strategy)

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

This search strategy uses the filename and available meta data like the description of an asset to search on. That means if you configure the `commons.wikimedia.org` as domain, the package will search through about ~50 Million asssets available in all languages. But for historical reasons, some images are stored directly in the language specific wikipedia instances and therefore not available with that setting.

### Article Search Strategy (Default)

[](#article-search-strategy-default)

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

This search strategy fits better to the Wikipedia use case. It doesn't search the images directly but uses the more powerfull article search to receive a number of wiki articles and then queries the images shown on that articles. The benefit is, if you configure the domain to `en.wikipedia.org` you will get assets, that are uploaded directly to this instance, as well as all fitting assets uploaded to Wikimedia Commons

SettingDescriptionarticleLimitHow many articles should be taken into account to query images from. Maximum are 50 articles. Higher values result in more returned articles, but the results may get inaccurateUsage of images in your project
-------------------------------

[](#usage-of-images-in-your-project)

Please take care of the [correct attribution](https://wiki.creativecommons.org/wiki/Best_practices_for_attribution) of used photos in the frontend.

Known Issues
------------

[](#known-issues)

See the issue list for [known issues](https://github.com/daniellienert/assetsource-mediawiki/issues) and missing features.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 96.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~176 days

Recently: every ~198 days

Total

9

Last Release

1547d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/642226?v=4)[Daniel Lienert](/maintainers/daniellienert)[@daniellienert](https://github.com/daniellienert)

---

Top Contributors

[![daniellienert](https://avatars.githubusercontent.com/u/642226?v=4)](https://github.com/daniellienert "daniellienert (28 commits)")[![jonnitto](https://avatars.githubusercontent.com/u/4510166?v=4)](https://github.com/jonnitto "jonnitto (1 commits)")

---

Tags

assetsourcemediawikineoscms

### Embed Badge

![Health badge](/badges/dl-assetsource-mediawiki/health.svg)

```
[![Health](https://phpackages.com/badges/dl-assetsource-mediawiki/health.svg)](https://phpackages.com/packages/dl-assetsource-mediawiki)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.5k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k37](/packages/neuron-core-neuron-ai)[google/cloud-core

Google Cloud PHP shared dependency, providing functionality useful to all components.

346132.9M111](/packages/google-cloud-core)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k39](/packages/civicrm-civicrm-core)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
