PHPackages                             oxid-esales/media-library-module - 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. oxid-esales/media-library-module

ActiveOxideshop-module

oxid-esales/media-library-module
================================

Media library for OXID eShop

v4.1.0(6mo ago)1664.1k↑41.1%3[2 PRs](https://github.com/OXID-eSales/media-library-module/pulls)2proprietaryPHPPHP &gt;=8.2CI passing

Since Dec 18Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/OXID-eSales/media-library-module)[ Packagist](https://packagist.org/packages/oxid-esales/media-library-module)[ Docs](https://www.oxid-esales.com/)[ RSS](/packages/oxid-esales-media-library-module/feed)WikiDiscussions b-7.5.x Synced 1mo ago

READMEChangelogDependencies (15)Versions (26)Used By (2)

Media Library Module for OXID eShop
===================================

[](#media-library-module-for-oxid-eshop)

[![Development](https://github.com/OXID-eSales/media-library-module/actions/workflows/trigger.yaml/badge.svg?branch=b-7.5.x)](https://github.com/OXID-eSales/media-library-module/actions/workflows/trigger.yaml)[![Latest Version](https://camo.githubusercontent.com/ed971c191d8676ed71da9fe4b6cd1b4e0b52ea38fc515ff5b797fa67552034b8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4f5849442d6553616c65732f6d656469612d6c6962726172792d6d6f64756c653f6c6f676f3d636f6d706f736572266c6162656c3d6c617465737426696e636c7564655f70726572656c656173657326636f6c6f723d6f72616e6765)](https://packagist.org/packages/oxid-esales/media-library-module)[![PHP Version](https://camo.githubusercontent.com/1bd39eded51765a6a54c0d6743af0d886b3220559990eb70d0bc380253df286e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6f7869642d6573616c65732f6d656469612d6c6962726172792d6d6f64756c65)](https://github.com/oxid-esales/media-library-module)

[![Quality Gate Status](https://camo.githubusercontent.com/8f3a0d989053685fb372b4553707c85c34eb8fb3c0c058317c4e91f14037f097/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d4f5849442d6553616c65735f6d656469612d6c6962726172792d6d6f64756c65266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/dashboard?id=OXID-eSales_media-library-module)[![Coverage](https://camo.githubusercontent.com/c93b1b38f28a248d211443d7532d20b4cc26d1b7821e220248e5bf8d6b65241e/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d4f5849442d6553616c65735f6d656469612d6c6962726172792d6d6f64756c65266d65747269633d636f766572616765)](https://sonarcloud.io/dashboard?id=OXID-eSales_media-library-module)[![Technical Debt](https://camo.githubusercontent.com/989d2c6de69c8be9b07420a62b891d6e84c0c6e08b9a6abc7eb04d93e72d7057/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d4f5849442d6553616c65735f6d656469612d6c6962726172792d6d6f64756c65266d65747269633d7371616c655f696e646578)](https://sonarcloud.io/dashboard?id=OXID-eSales_media-library-module)

Module provides basic media files management.

Compatibility
-------------

[](#compatibility)

### Versions

[](#versions)

- v5.x is compatible with eShop compilation 7.5.x and higher
- v4.x is compatible with eShop compilation 7.4.x and higher
- v3.0.x is compatible with eShop compilation 7.3.x and higher
- v2.1.x is compatible with eShop compilation 7.2.x and higher
- v2.0.x is compatible with eShop compilation 7.1.x and higher
- v1.0.x is compatible with eShop compilation 7.1.x and higher

### Branches

[](#branches)

- b-7.5.x is compatible with shop b-7.5.x branches
- b-7.4.x is compatible with shop b-7.4.x branches
- b-7.3.x is compatible with shop b-7.3.x branches
- b-7.2.x is compatible with shop b-7.2.x branches
- b-7.1.x is compatible with shop b-7.1.x branches

### Module installation via composer

[](#module-installation-via-composer)

In order to install the module via composer run one of the following commands in commandline in your shop base directory (where the shop's composer.json file resides).

- `composer require oxid-esales/media-library-module:^5.0.0`to install the released version compatible with OXID eShop v7.5.x
- `composer require oxid-esales/media-library-module:dev-b-7.5.x`to install the specific unreleased branch

Development installation on OXID eShop SDK
==========================================

[](#development-installation-on-oxid-eshop-sdk)

The installation instructions below are shown for the current [SDK](https://github.com/OXID-eSales/docker-eshop-sdk)for shop 7.5. Make sure your system meets the requirements of the SDK.

1. Ensure all docker containers are down to avoid port conflicts
2. Clone the SDK for the new project

```
echo MyProject && git clone https://github.com/OXID-eSales/docker-eshop-sdk.git $_ && cd $_
```

2. Clone the repository to the source directory

```
git clone --recurse-submodules https://github.com/OXID-eSales/media-library-module.git --branch=b-7.5.x ./source
```

3. Run the recipe to setup the development environment

```
./source/recipes/setup-development.sh
```

You should be able to access the shop via

- Frontend
- Admin Panel:
    - (credentials:  / admin)

### Running the tests and quality tools

[](#running-the-tests-and-quality-tools)

Check the "scripts" section in the `composer.json` file for the available commands. Those commands can be executed by connecting to the php container and running the command from there, example:

```
make php
composer tests-coverage
```

Commands can be also triggered directly on the container with docker compose, example:

```
docker compose exec -T php composer tests-coverage
```

Rebuilding the assets
---------------------

[](#rebuilding-the-assets)

To rebuild the assets, latest node docker container can be used. The one is pulled automatically if you are using the installation method from the previous section. What is left - connect to the container, install the npm dependencies and run the assets building process

```
make node
npm install
npm run build
```

Alternatively, if you're actively developing and want changes to be applied automatically, you can enable watch mode:

```
npm run watch
```

Migration
---------

[](#migration)

After updating the Media Library module, ensure you run the database migrations:

```
vendor/bin/oe-eshop-doctrine_migration migrations:migrate ddoemedialibrary
```

License
-------

[](#license)

OXID Module and Component License, see [LICENSE file](LICENSE).

Bugs and Issues
---------------

[](#bugs-and-issues)

If you experience any bugs or issues, please report them in the section **module Media Library** of .

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance80

Actively maintained with recent releases

Popularity40

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 74% 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 ~86 days

Recently: every ~95 days

Total

8

Last Release

189d ago

Major Versions

v1.0.0 → v2.0.02024-10-10

v2.1.1 → v3.0.02025-04-10

v3.0.0 → v4.0.02025-10-16

PHP version history (2 changes)v1.0.0PHP ^8.1

v2.1.0PHP &gt;=8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1374817?v=4)[oxid](/maintainers/oxid)[@OxID](https://github.com/OxID)

---

Top Contributors

[![Sieg](https://avatars.githubusercontent.com/u/98882?v=4)](https://github.com/Sieg "Sieg (308 commits)")[![RahatHameed](https://avatars.githubusercontent.com/u/11661532?v=4)](https://github.com/RahatHameed "RahatHameed (63 commits)")[![TitaKoleva](https://avatars.githubusercontent.com/u/22682166?v=4)](https://github.com/TitaKoleva "TitaKoleva (13 commits)")[![kenariosz](https://avatars.githubusercontent.com/u/2828175?v=4)](https://github.com/kenariosz "kenariosz (8 commits)")[![hkreuter](https://avatars.githubusercontent.com/u/3692295?v=4)](https://github.com/hkreuter "hkreuter (7 commits)")[![MarcelOxid](https://avatars.githubusercontent.com/u/98812941?v=4)](https://github.com/MarcelOxid "MarcelOxid (4 commits)")[![NikolaIvanovski](https://avatars.githubusercontent.com/u/8055347?v=4)](https://github.com/NikolaIvanovski "NikolaIvanovski (4 commits)")[![tkcreateit](https://avatars.githubusercontent.com/u/42207462?v=4)](https://github.com/tkcreateit "tkcreateit (4 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![oxFilla](https://avatars.githubusercontent.com/u/21125165?v=4)](https://github.com/oxFilla "oxFilla (2 commits)")

---

Tags

OXIDmodulesmedia library

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/oxid-esales-media-library-module/health.svg)

```
[![Health](https://phpackages.com/badges/oxid-esales-media-library-module/health.svg)](https://phpackages.com/packages/oxid-esales-media-library-module)
```

###  Alternatives

[oxid-esales/oxideshop-ce

This package contains OXID eShop CE source code.

2381.1M191](/packages/oxid-esales-oxideshop-ce)[ddoe/wysiwyg-editor-module

Summernote WYSIWYG Editor for OXID eShop.

19981.7k2](/packages/ddoe-wysiwyg-editor-module)[oxid-esales/gdpr-optin-module

This is the GDPR opt-in module for the OXID eShop.

20459.1k2](/packages/oxid-esales-gdpr-optin-module)[oxid-esales/paypal-module

This is the PayPal module for the OXID eShop.

36513.5k2](/packages/oxid-esales-paypal-module)[oxid-esales/testing-library

OXID eShop testing library

13374.0k10](/packages/oxid-esales-testing-library)[oxid-esales/graphql-base

OXID eSales GraphQL base module

24101.0k10](/packages/oxid-esales-graphql-base)

PHPackages © 2026

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