PHPackages                             marcel-mathias-nolte/contao-filesmanager-fileusage - 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 & Helpers](/categories/utility)
4. /
5. marcel-mathias-nolte/contao-filesmanager-fileusage

ActiveContao-bundle[Utility & Helpers](/categories/utility)

marcel-mathias-nolte/contao-filesmanager-fileusage
==================================================

This bundles displays an icon, which shows whether an file is used anywhere or not and shows details on where it is used if you click on it.

1.0.12(2y ago)31.6k3[5 issues](https://github.com/marcel-mathias-nolte/contao-filesmanager-fileusage/issues)1LGPL-3.0-or-laterPHPPHP ^7.2 || 8.\*

Since Oct 27Pushed 1y ago2 watchersCompare

[ Source](https://github.com/marcel-mathias-nolte/contao-filesmanager-fileusage)[ Packagist](https://packagist.org/packages/marcel-mathias-nolte/contao-filesmanager-fileusage)[ Docs](https://github.com/marcel-mathias-nolte)[ RSS](/packages/marcel-mathias-nolte-contao-filesmanager-fileusage/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (15)Used By (1)

Contao Filemanager File Usage Bundle
====================================

[](#contao-filemanager-file-usage-bundle)

[![Screenshot Dateliste / screenshot file list](/images/screen2.jpg)](/images/screen2.jpg)

[![Screenshot Details / screenshot details](/images/screen1.jpg)](/images/screen1.jpg)

Deutsche Version
----------------

[](#deutsche-version)

Dieses Bundle zeigt in der Dateiverwaltung ein Icon, welches anzeigt, ob die Datei irgendwo verknüpft ist und zeigt nach einem Klick darauf die konkreten Verwendungsstellen.

Die folgenden Verknüpfungsmöglichkeiten werden geprüft:

- fileTree-Felder in Tabellen, prüft auch die Verknüpfung übergeordneter Ordner
- textarea-Felder in Tabellen,
    prüft die Nennung es Pfadnamens und image- und picture-Inserttags
- text-Felder in Tabellen, wenn der rgxp auf url gesetzt ist
    prüft die Nennung es Pfadnamens und image- und picture-Inserttags
- alle css- und scss-Dateien in /files (bezogen aus der Tabelle tl\_files),
    prüft die Nennung es Pfadnamens und image- und picture-Inserttags
- alle Template-Dateien in /templates (bezogen via rekursiver Verzeichnissuche),
    prüft die Nennung es Pfadnamens und image- und picture-Inserttags

Sie können die Tabellendefinition mit folgendem EIntrag in Ihrer Resources/contao/config/config.php erweitern:

```
$GLOBALS['FILE_USAGE']['TABELLENNAME'] = [
    // optional: Spalte(n) zur Benennung des Eintrags,
    // wenn eine Spalte keinen Inhalt hat wird die jeweils nächste genutzt
    'labelColumn' => ['title'],
    // optionale Referenz, falls die Spalte 'type' vorhanden ist
    'ref' => &$GLOBALS['TL_LANG']['REFERENZTABELLE'],
    // Name der Elterntabelle
    'parent' => 'ELTERNTABELLE',
    // oder false, wenn es keine Elterntabelle gibt
    'parent' => false,
    // , oder 'dynamic', falls die Elterntabelle anhand der Spalte ptable gewählt werden soll
    'parent' => 'dynamic',
    // optional: Bearbeitungslink
    // %id% und %pid% werden ersetzt
    'href' => '/contao?do=MODULNAME&table=TABELLENNAME&id=%id%&act=edit',
    // für von der Spalte 'ptable' abhängige Links muss ein Array genutzt werden:
    'href' => [
        'ELTERNTABELLE' => '/contao?do=MODULNAME&table=TABELLENNAME&id=%id%&act=edit'
    ]
];
```

Die Beispiel-Deklaration für tl\_content lautet ...

```
$GLOBALS['FILE_USAGE']['tl_content'] = [
    'ref' => &$GLOBALS['TL_LANG']['CTE'],
    'parent' => 'dynamic',
    'href' => [
        'tl_article' => '/contao?do=article&table=tl_content&id=%id%&act=edit',
        'tl_news' => '/contao?do=news&table=tl_content&id=%id%&act=edit',
        'tl_calendar_events' => '/contao?do=calendar&table=tl_content&id=%id%&act=edit',
        'tl_newsletter' => '/contao?do=newsletter&table=tl_content&id=%id%&act=edit'
    ]
];
```

... und die Beispiel-Deklaration für tl\_user lautet ...

```
$GLOBALS['FILE_USAGE']['tl_user'] = [
    'labelColumn' => ['username'],
    'parent' => false,
    'href' => '/contao?do=user&act=edit&id=%id%'
];
```

Zusätzlich sollte der Name der Tabelle in Ihrer Resources/contao/languages/SPRACHE/default.php gesetzt werden:

```
$GLOBALS['TL_LANG']['FILE_USAGE']['TABELLENNAME'] = 'TABELLENBEZEICHNUNG';
```

z. B.

```
$GLOBALS['TL_LANG']['FILE_USAGE']['tl_user'] = 'Backend-Nutzer';
```

English version
---------------

[](#english-version)

This bundles displays an icon, which shows whether an file is used anywhere or not and shows details on where it is used if you click on it.

The following possible usage is checked:

- fileTree fields in tables, also checks if parent folders are used
- textarea fields in tables,
    looking for usage of the file path and for image and picture insert tags
- text fields in tables, if rgxp is set to url,
    looking for usage of the file path and for image and picture insert tags
- all css and scss files inside /files (derived from tl\_files),
    looking for usage of the file path and for image and picture insert tags
- all template files inside /templates (derived via directory traversal),
    looking for usage of the file path and for image and picture insert tags

You can expand the table definitions using the following array in your Resources/contao/config/config.php:

```
$GLOBALS['FILE_USAGE']['TABLENAME'] = [
    // optional column(s) to use for labelling the item,
    // if one given column is empty, the next one will be used
    'labelColumn' => ['title'],
    // optional reference, if a type field is present
    'ref' => &$GLOBALS['TL_LANG']['REFERENCE TABLE NAME'],
    // parent tables name
    'parent' => 'PARENTTABLE',
    // or false if there is no parent table
    'parent' => false,
    // or 'dynamic' if the parent tables name should be derived from the ptable field
    'parent' => 'dynamic',
    // optional provide an edit link
    // %id% will
    'href' => '/contao?do=MODULENAME&table=TABLENAME&id=%id%&act=edit',
    // for hrefs based on the ptable use an array:
    'href' => [
        'PARENTTABLE' => '/contao?do=MODULENAME&table=TABLENAME&id=%id%&act=edit'
    ]
];
```

The example definition for tl\_content would be ...

```
$GLOBALS['FILE_USAGE']['tl_content'] = [
    'ref' => &$GLOBALS['TL_LANG']['CTE'],
    'parent' => 'dynamic',
    'href' => [
        'tl_article' => '/contao?do=article&table=tl_content&id=%id%&act=edit',
        'tl_news' => '/contao?do=news&table=tl_content&id=%id%&act=edit',
        'tl_calendar_events' => '/contao?do=calendar&table=tl_content&id=%id%&act=edit',
        'tl_newsletter' => '/contao?do=newsletter&table=tl_content&id=%id%&act=edit'
    ]
];
```

... and the example definition for tl\_user would be ...

```
$GLOBALS['FILE_USAGE']['tl_user'] = [
    'labelColumn' => ['username'],
    'parent' => false,
    'href' => '/contao?do=user&act=edit&id=%id%'
];
```

Additionally, you would like to name the table in your Resources/contao/languages/LANGUAGE/default.php:

```
$GLOBALS['TL_LANG']['FILE_USAGE']['TABLENAME'] = 'ITEMNAME';
```

e.g.

```
$GLOBALS['TL_LANG']['FILE_USAGE']['tl_user'] = 'Backend-User';
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance8

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% 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 ~94 days

Recently: every ~303 days

Total

14

Last Release

797d ago

Major Versions

0.0.1 → 1.0.02020-10-28

PHP version history (3 changes)0.0.1PHP ^5.6 || ^7.0

1.0.6PHP ^7.2

1.0.11PHP ^7.2 || 8.\*

### Community

Maintainers

![](https://www.gravatar.com/avatar/fe1614023eb8f4e11d483390fcecb78f9edf2c344f34590e8db4288e2c09ad22?d=identicon)[marcel-mathias-nolte](/maintainers/marcel-mathias-nolte)

---

Top Contributors

[![marcel-mathias-nolte](https://avatars.githubusercontent.com/u/2349435?v=4)](https://github.com/marcel-mathias-nolte "marcel-mathias-nolte (3 commits)")[![Lixus](https://avatars.githubusercontent.com/u/2529169?v=4)](https://github.com/Lixus "Lixus (2 commits)")[![lukasbableck](https://avatars.githubusercontent.com/u/42083846?v=4)](https://github.com/lukasbableck "lukasbableck (1 commits)")

### Embed Badge

![Health badge](/badges/marcel-mathias-nolte-contao-filesmanager-fileusage/health.svg)

```
[![Health](https://phpackages.com/badges/marcel-mathias-nolte-contao-filesmanager-fileusage/health.svg)](https://phpackages.com/packages/marcel-mathias-nolte-contao-filesmanager-fileusage)
```

###  Alternatives

[tastaturberuf/anystores

Location management and geographic search

121.7k](/packages/tastaturberuf-anystores)

PHPackages © 2026

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