silverstripe-folderperpage

, _(*1)

Extension that creates a folder per page or dataobject, _(*2)

Requirements

for SS3 compatible versions see SS3 branch, _(*3)

Installation

Download and install manually or use composer., _(*4)

Make sure you add the extension to the classes you want to decorate. Add this to your config.yml to add it to all Pages:, _(*5)

Page:
  extensions:
    - NetWerkstatt\FolderPerPage\Extensions\RootFolder

Configuration

You can exclude several page types. Just use the RootFolder.ignored_classes config value. The module's config.yml has some default values to get you started:, _(*6)

NetWerkstatt\FolderPerPage\Extensions\RootFolder:
  ignored_classes:
    - SilverStripe\CMS\Model\VirtualPage
    - SilverStripe\ErrorPage\ErrorPage
  create_folder_for_translations: false
  folder_root: 'Articles'

Of course every decorated class can have a seperate folder root, e.g. "Articles" for all pages and "News" for a news data object. Just add the folder_root config to your object., _(*7)

Update your forms

You can use $this->getRootFoldername() to set the upload folder., _(*8)

Given you have a has_one relation "Avatar" => "Image" you can add the folder to the UploadField:, _(*9)

function getCMSFields() {
    /*...*/
    $pic = UploadField::create('Avatar', 'Your Avatar');
    $fields->addFieldToTab('Root.Main', $pic);

    $pic->setFolderName($this->getRootFolderName());
    /*...*/
}

TODO

~~make it work for other dataobjects~~
~~unit tests~~
add function that automatically updates all UploadFields and BulkUploads to use this folder in a form
add support for subsites module, e.g. a master root per subsite
task for updating / checking all existing pages
~~check if page is moved~~
- should it move the rootfolder automatically or by switch? May be a timeout problem with very large trees