https://github.com/modxcms/mediascanner
MODX Revolution media source auditing tool
https://github.com/modxcms/mediascanner
Last synced: 29 days ago
JSON representation
MODX Revolution media source auditing tool
- Host: GitHub
- URL: https://github.com/modxcms/mediascanner
- Owner: modxcms
- License: gpl-2.0
- Created: 2023-05-09T12:36:01.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-04-16T22:27:25.000Z (2 months ago)
- Last Synced: 2026-04-17T00:31:28.451Z (2 months ago)
- Language: PHP
- Homepage:
- Size: 114 KB
- Stars: 0
- Watchers: 5
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Media Scanner
Media Scanner is a tool that attempts to scan your site for linked assets. This tool
is primarily intended as a reference for what assets are in use. It does a best guess
effort to find all linked assets and provides a media browser to review them.
Media Scanner is limited in that it can not detect the original URL of a masked asset,
like those using pThumb or similar to generate a scaled image. It also can not parse
through subsections of dynamically generated pages, like those built with getPage.
With that in mind, it can be very helpful with identifying possible unused assets.
## Installation
Install via package management. To generate the initial link stats, go to the Media
Scanner manager page found under the "Media" drop down and click on the "Scan Media"
button. This will take a while, depending on the size of your site. If this fails,
you may need to manually run the included scanning script via CLI or cron.
## Manual Asset Scanning
If the automatic scanning fails, you can run the included scanning script manually.
This is useful if you have a large site, or if you want to run the scanning script
via cron.
To run the scanning script, you need to SSH into your server and run the following
command:
php /path/to/your/modx/core/components/mediascanner/cron/generate.2x.php
Or for MODX 3.x Versions:
php /path/to/your/modx/core/components/mediascanner/cron/generate.3x.php
Once completed, this will output the number of resources indexed. You can then
go to the Media Scanner manager page and verify it is showing the newly
discovered links.
## Automatic Scanning
In general, the automatic scanning should work fine. It renders a page on save,
and scans it for links. However, the links can change if you make adjustments
to a template or chunk in your site that would affect the frontend links. If
this happens, you can run the scanning script manually to update the links,
or go to the manager page and click "Regenerate Links".
## Disable Automatic Scanning
Due to the way automatic scanning works, it may slow down the save event on
your site depending on how your site is set up. If you want to disable automatic
scanning, you can do so by setting the `mediascanner.allow_regenerate_onsave`
system setting to `No`. It is recommended you then run the scanning script
manually via cron.
If you are just having issues with scanning a specific page, Media Scanner will
first attempt to automatically resolve it by skipping the resource. If that fails
you can manually add the Resource ID to the `mediascanner.skip_skan` system
setting. This is a comma-separated list of resources to skip when scanning for
new assets.
## Disable "Regenerate Links" Button
In the event you have a large site that consistently fails to generate links
with the provided button. You can disable it in system settings. This will
prevent the button from showing up in the manager page. It is recommended you
then run the scanning script manually via cron.
To disable the button, set the system setting
`mediascanner.allow_regenerate_button` to `No`.