RootFolder

Complexity

Total Complexity

28

Size/Duplication

Total Lines	155
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	4

7 Methods

Rating	Name	Duplication	Size	Complexity
A	onAfterWrite()	0	6	2
A	onBeforeDuplicate()	0	6	2
C	checkFolder()	0	23	7
B	createRootFolder()	0	25	5
B	updateRootFolder()	0	17	7
A	getFolderRoot()	0	6	2
A	getRootFolderName()	0	11	3

<?php

/**
 * Adds a RootFolder to a Page for using it as default upload folder for all related stuff.
 *
 *
 * @package FolderPerPage
 * @author Werner Krauß
 */
class RootFolder extends DataExtension

PSR1 recommends that each class must be in a namespace of at least one level to avoid collisions.

{
    private static $has_one = array(

The property $has_one is not used and could be removed.

        'RootFolder' => 'Folder',
    );

    /**
     * @var array exclude this page types and class names
     */
    private static $ignored_classes = array('VirtualPage', 'ErrorPage');

The property $ignored_classes is not used and could be removed.

    /**
     * @var bool should folders be created for translated objects?
     */
    private static $create_folder_for_translations = false;

The property $create_folder_for_translations is not used and could be removed.

    /**
     * @var string default root for all folders; may be overwritten in config of decorated class
     */
    private static $folder_root = 'Articles';

The property $folder_root is not used and could be removed.

    public function onAfterWrite()
    {
        if ($this->owner->ID) {
            $this->checkFolder();
        }
    }

    /**
     * reset $RootFolderID on a duplicated page
     */
    public function onBeforeDuplicate($originalOrClone)

The parameter $originalOrClone is not used and could be removed.

    {
        if ($this->owner->ID == 0) {
            $this->owner->RootFolderID = 0;
        }
    }

    /**
     * Creates a folder for a page as a subfolder of the parent page
     * You can exclude page types by setting $ignored_classes in config
     *
     * Doesn't create folders for translated pages by default.
     *
     * @TODO doesn't check if page is moved to another parent
     */
    public function checkFolder()
    {
        $ignoredPageTypes = Config::inst()->get($this->class, 'ignored_classes');

        foreach ($ignoredPageTypes as $pagetype) {

The expression $ignoredPageTypes of type array|integer|double|string|boolean is not guaranteed to be traversable. How about adding an additional type check?

            if (is_a($this->owner, $pagetype)) {
                return;
            }
        }

        if (class_exists('Translatable')
            && $this->owner->Locale !== Translatable::default_locale()
            && !Config::inst()->get($this->class, 'create_folder_for_translations')
        ) {
            return;
        }

        if (!$this->owner->RootFolderID) {
            $this->createRootFolder();
        } else {
            $this->updateRootFolder();
        }
    }

    /**
     * Does the work of creating a new RootFolder, saves the relation in the extended DataObject
     */
    protected function createRootFolder()
    {
        //get path to parent folder
        $parent = $this->owner->hasExtension('Hierarchy')
            ? $this->owner->getParent()
            : null;
        if (is_a($parent, 'Page') && $parentFolder = $parent->RootFolder()) {
            $folderRoot = $parent->getRootFolderName();
        } else {
            //fallback to classes folder_root which is defined in your config.yml
            $folderRoot = $this->getFolderRoot() . '/';
        }

        if ($folderRoot == '/') {
            $folderRoot = getFolderRoot() . '/';
        }

        $folder = Folder::find_or_make($folderRoot . $this->owner->URLSegment);
        $folder->Title = $this->owner->Title;
        $folder->setName($this->owner->URLSegment);
        $folder->write();

        $this->owner->RootFolderID = $folder->ID;
        $this->owner->write();
    }

    /**
     * Does the work of updating the folder if the URLSegment or ParentID is changed.
     * if both it does two writes...
     *
     * @todo: rethink moving subfolders as it may timeout on real large trees
     */
    protected function updateRootFolder()
    {
        $rootFolder = $this->owner->RootFolder();
        if ($this->owner->isChanged('URLSegment') && $this->owner->URLSegment) {
            $rootFolder->setName($this->owner->URLSegment);
            $rootFolder->write();
        }

        if ($this->owner->isChanged('ParentID') && $this->owner->ParentID > 0) {
            $oldParentID = $rootFolder->ParentID;
            $newParentID = $this->owner->Parent()->RootFolderID;
            if ($oldParentID !== $newParentID && $newParentID !== $rootFolder->ID) {
                $rootFolder->setParentID($newParentID);
                $rootFolder->write();
            }
        }
    }

    /**
     * Returns the folder root for the current root folder, e.g. 'Articles',
     * if a config $folder_root is defined in the decorated class.
     *
     * Falls back to global config
     */
    public function getFolderRoot()
    {
        return ($this->owner->config()->get('folder_root'))
            ? $this->owner->config()->get('folder_root')
            : Config::inst()->get($this->class, 'folder_root');
    }


    /**
     * Helper function to return the name of the RootFolder for setting in @link UploadField or @link GridFieldBulkUpload
     * By default relative to /assets/
     *
     * @param bool $relativeToAssetsDir
     */
    public function getRootFolderName($relativeToAssetsDir = true)
    {
        if ($this->owner->RootFolderID) {
            return $relativeToAssetsDir
                ? str_replace(ASSETS_DIR . '/', '', $this->owner->RootFolder()->getRelativePath())
                : $this->owner->RootFolder()->getRelativePath();
        } else {
            //use folder root as fallback for now
            return $this->getFolderRoot();
        }
    }
}