mediaFal

A file abstraction layer media source for MODX 3. Each file is stored once on a fixed path, editors organise files in virtual folders, so renaming or moving never breaks links. Tracks where every file is used, protects used files from deletion, keeps alt/title per language and adds a media library, resource attachments, a multi-file TV with crop and migration with 301 redirects.

Requirements: MODX 3.0+, PHP 8.1+, GD or Imagick (Imagick recommended).

Installation

Install through Package Management. On the first install a form offers (all checked by default):

• create a FAL media source Images (assets/media/images/) and Files (assets/media/files/),
• make the Images source the default media source,
• hide assets/media/ in the core Filesystem source (recommended), so nobody uploads past mediaFal.

After installation

• Cron: add a nightly job for the full usage scan and trash clean-up: php core/components/mediafal/cli/scan.php. Without cron, run Extras > mediaFal: scan usage from time to time.
• Media sources: set the media source of your TVs, ContentBlocks fields and rich text editors to a FAL source.
• Existing files: Media > Migration to mediaFal moves them into a FAL source, rewrites the links in content and TVs and adds 301 redirects.
• Attachments: enable the tab per template (template tab Attachment groups).
• Output: [[falFiles]] lists the attachments of the current resource; [[falFiles? &filter=`images`]] shows images only.

Test on a copy of your site first and keep a backup of the database and the assets/ folder.

Full documentation: https://modx.tend.si/mediafal/

Initial release.