symbiote/silverstripe-contextawareupload

Automatic organization of uploaded files based on the site tree structure.

2.0.0 2018-09-10 05:55 UTC

Requires

• silverstripe/framework: ^4.1

Requires (Dev)

• phpunit/phpunit: ^5.7
• squizlabs/php_codesniffer: ^3.0

Replaces

• silbinarywolf/silverstripe-contextawareupload: 2.0.0

BSD-3-Clause

• Symbiote
• Jake Bentvelzen

• Context
• upload
• silverstripe
• aware
• symbiote

README

This module will make the default upload folder match the URL structure of the page you're uploading in, rather than just uploading to the Uploads folder or the default-site folder if you're using Multisites.

ie. If you upload a file to a page that can be visited at http://www.mysite.com/information/about-us, then that file will be available at http://www.mysite.com/assets/information/about-us/filename.jpg by default, rather than http://www.mysite.com/assets/Uploads.

Composer Install

composer require symbiote/silverstripe-contextawareupload:~2.0

Requirements

• SilverStripe 4.1+
• (Optional) Multisites

Documentation

• Quick Start
• License
• Contributing

Known limitations

Uploading files via a WYSIWYG field's "Insert Media" button or anything else using the AssetAdmin view will not be affected by this module. I'm hoping this issue will be fixed in the future, and it's been logged here: silverstripe/silverstripe-assets#159

In the meantime however, you can optionally apply an extension so that any files uploaded to the root folder of assets, gets moved into the desired folder. ie. if File::ParentID == 0, move to default folder.

SilverStripe\Assets\File:
  extensions:
    - Symbiote\ContextAwareUpload\ForceRootToDefaultExtension

Credits

• Jake Bentvelzen for the initial build.