SilverStripe\Widgets\Model\Widget

Complexity

Total Complexity

30

Size/Duplication

Total Lines	286
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	8

Importance

Changes

0

15 Methods

Rating	Name	Duplication	Size	Complexity
A	populateDefaults()	0	5	1
A	WidgetHolder()	0	4	1
A	forTemplate()	0	8	2
A	Content()	0	4	1
A	getTitle()	0	5	2
A	getCMSTitle()	0	4	1
A	getDescription()	0	4	1
A	DescriptionSegment()	0	4	1
A	EditableSegment()	0	4	1
A	getCMSFields()	0	10	1
B	CMSEditor()	0	28	4
A	ClassName()	0	4	1
A	Name()	0	4	1
B	getController()	0	21	5
C	populateFromPostData()	0	28	7

<?php

namespace SilverStripe\Widgets\Model;

use Exception;
use SilverStripe\Core\ClassInfo;
use SilverStripe\Core\Injector\Injector;
use SilverStripe\Forms\CheckboxField;
use SilverStripe\Forms\FieldList;
use SilverStripe\Forms\HiddenField;
use SilverStripe\Forms\TextField;
use SilverStripe\ORM\DataObject;
use SilverStripe\Widgets\Model\WidgetArea;

/**
 * Widgets let CMS authors drag and drop small pieces of functionality into
 * defined areas of their websites.
 *
 * You can use forms in widgets by implementing a {@link WidgetController}.
 *
 * See {@link WidgetController} for more information.
 *
 * @package widgets
 */
class Widget extends DataObject
{
    /**
     * @var array
     */
    private static $db = array(

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

Consider using a different property name as you override a private property of the parent class.

        "Title" => "Varchar(255)",
        "Sort" => "Int",
        "Enabled" => "Boolean",
    );

    /**
     * @var array
     */
    private static $defaults = array(

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

Consider using a different property name as you override a private property of the parent class.

        'Enabled' => true,
    );

    /**
     * @var array
     */
    private static $casting = array(

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

Consider using a different property name as you override a private property of the parent class.

        'CMSTitle' => 'Text',
        'Description' => 'Text',
    );

    private static $only_available_in = array();

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

    /**
     * @var array
     */
    private static $has_one = array(

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

Consider using a different property name as you override a private property of the parent class.

        "Parent" => WidgetArea::class,
    );

    /**
     * @var string
     */
    private static $default_sort = "\"Sort\"";

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

Consider using a different property name as you override a private property of the parent class.

    /**
     * @var string
     */
    private static $title = "Widget Title";

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

    /**
     * @var string
     */
    private static $cmsTitle = "Name of this widget";

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

    /**
     * @var string
     */
    private static $description = "Description of what this widget does.";

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

    /**
     * @var array
     */
    private static $summary_fields = array(

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

Consider using a different property name as you override a private property of the parent class.

        'CMSTitle' => 'Title'
    );

    /**
     * @var string
     */
    private static $table_name = 'Widget';

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

Consider using a different property name as you override a private property of the parent class.

    /**
     * @var WidgetController
     */
    protected $controller;

    public function populateDefaults()
    {
        parent::populateDefaults();
        $this->setField('Title', $this->getTitle());
    }

    /**
     * Note: Overloaded in {@link WidgetController}.
     *
     * @return string HTML
     */
    public function WidgetHolder()
    {
        return $this->renderWith("WidgetHolder");
    }

    /**
     * Default way to render widget in templates.
     * @return string HTML
     */
    public function forTemplate($holder = true)
    {
        if ($holder) {
            return $this->WidgetHolder();
        }

        return $this->Content();
    }

    /**
     * Renders the widget content in a custom template with the same name as the
     * current class. This should be the main point of output customization.
     *
     * Invoked from within WidgetHolder.ss, which contains the "framing" around
     * the custom content, like a title.
     *
     * Note: Overloaded in {@link WidgetController}.
     *
     * @return string HTML
     */
    public function Content()
    {
        return $this->renderWith(array_reverse(ClassInfo::ancestry($this->class)));
    }

    /**
     * Get the frontend title for this widget
     *
     * @return string
     */
    public function getTitle()
    {
        return $this->getField('Title')
            ?: _t($this->class . '.TITLE', $this->config()->title);
    }

    /**
     * @return string
     */
    public function getCMSTitle()
    {
        return _t($this->class . '.CMSTITLE', $this->config()->cmsTitle);
    }

    /**
     * @return string
     */
    public function getDescription()
    {
        return _t($this->class . '.DESCRIPTION', $this->config()->description);
    }

    /**
     * @return string - HTML
     */
    public function DescriptionSegment()
    {
        return $this->renderWith('WidgetDescription');
    }

    /**
     * @see WidgetController::editablesegment()
     *
     * @return string - HTML
     */
    public function EditableSegment()
    {
        return $this->renderWith('WidgetEditor');
    }

    /**
     * @return FieldList
     */
    public function getCMSFields()
    {
        $fields = new FieldList(
            new TextField('Title', $this->fieldLabel('Title'), null, 255),
            new CheckboxField('Enabled', $this->fieldLabel('Enabled'))
        );
        $this->extend('updateCMSFields', $fields);

        return $fields;
    }

    /**
     * @return FieldList
     */
    public function CMSEditor()
    {
        $fields = $this->getCMSFields();
        $outputFields = new FieldList();

        $this->FormID = $this->ID ?: uniqid();

The property FormID does not exist on object<SilverStripe\Widgets\Model\Widget>. Since you implemented __set, maybe consider adding a @property annotation.

        $outputFields->push(
            HiddenField::create(
                'Widget[' . $this->FormID . '][FormID]',

The property FormID does not exist on object<SilverStripe\Widgets\Model\Widget>. Since you implemented __get, maybe consider adding a @property annotation.

                'FormID',
                $this->FormID

The property FormID does not exist on object<SilverStripe\Widgets\Model\Widget>. Since you implemented __get, maybe consider adding a @property annotation.

            )->addExtraClass('formid')
        );

        foreach ($fields as $field) {
            $name = $field->getName();
            $value = $this->getField($name);
            if ($value) {
                $field->setValue($value);
            }
            $namefiltered = preg_replace("/([A-Za-z0-9\-_]+)/", "Widget[" . $this->FormID . "][\\1]", $name);

The property FormID does not exist on object<SilverStripe\Widgets\Model\Widget>. Since you implemented __get, maybe consider adding a @property annotation.

            $field->setName($namefiltered);
            $outputFields->push($field);
        }

        return $outputFields;
    }

    /**
     * A fully qualified class name is returned with underscores instead of backslashes so it is HTML safe. Dashes
     * can't be used as they're handled in the Javascript for other purposes.
     *
     * @return string
     */
    public function ClassName()
    {
        return str_replace('\\', '_', $this->class);
    }

    /**
     * @return string
     */
    public function Name()
    {
        return "Widget[" . $this->ID . "]";
    }

    /**
     * @throws Exception
     *
     * @return WidgetController
     */
    public function getController()
    {
        if ($this->controller) {
            return $this->controller;
        }

        foreach (array_reverse(ClassInfo::ancestry($this->class)) as $widgetClass) {
            $controllerClass = "{$widgetClass}Controller";
            if (class_exists($controllerClass)) {
                break;
            }
        }

        if (!class_exists($controllerClass)) {

The variable $controllerClass does not seem to be defined for all execution paths leading up to this point.

            throw new Exception("Could not find controller class for $this->classname");

The property classname does not seem to exist. Did you mean ClassName?

        }

        $this->controller = Injector::inst()->create($controllerClass, $this);

        return $this->controller;
    }

    /**
     * @param array $data
     */
    public function populateFromPostData($data)
    {
        $fields = $this->getCMSFields();
        foreach ($data as $name => $value) {
            if ($name != "Type") {
                if ($field = $fields->dataFieldByName($name)) {
                    $field->setValue($value);
                    $field->saveInto($this);
                } else {
                    $this->setField($name, $value);
                }
            }
        }

        //Look for checkbox fields not present in the data
        foreach ($fields as $field) {
            if ($field instanceof CheckboxField && !array_key_exists($field->getName(), $data)) {
                $field->setValue(false);
                $field->saveInto($this);
            }
        }

        $this->write();

        // The field must be written to ensure a unique ID.
        $this->Name = $this->class . $this->ID;

The property Name does not exist on object<SilverStripe\Widgets\Model\Widget>. Since you implemented __set, maybe consider adding a @property annotation.

        $this->write();
    }
}