2012-04-18 23:15:45 +02:00
|
|
|
<?php
|
2013-05-07 10:56:38 +02:00
|
|
|
|
2012-04-18 23:15:45 +02:00
|
|
|
/**
|
2016-07-14 01:24:26 +02:00
|
|
|
* Widgets let CMS authors drag and drop small pieces of functionality into
|
2012-04-18 23:15:45 +02:00
|
|
|
* defined areas of their websites.
|
2016-07-14 01:24:26 +02:00
|
|
|
*
|
2013-05-07 10:56:38 +02:00
|
|
|
* You can use forms in widgets by implementing a {@link WidgetController}.
|
2016-07-14 01:24:26 +02:00
|
|
|
*
|
2012-04-18 23:15:45 +02:00
|
|
|
* See {@link Widget_Controller} for more information.
|
2016-07-14 01:24:26 +02:00
|
|
|
*
|
2013-05-07 10:56:38 +02:00
|
|
|
* @package widgets
|
2012-04-18 23:15:45 +02:00
|
|
|
*/
|
2015-11-18 05:08:21 +01:00
|
|
|
class Widget extends DataObject
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
private static $db = array(
|
|
|
|
"Title" => "Varchar(255)",
|
|
|
|
"Sort" => "Int",
|
|
|
|
"Enabled" => "Boolean",
|
|
|
|
);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
private static $defaults = array(
|
|
|
|
'Enabled' => true,
|
|
|
|
);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
private static $casting = array(
|
|
|
|
'CMSTitle' => 'Text',
|
|
|
|
'Description' => 'Text',
|
|
|
|
);
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
private static $only_available_in = array();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
private static $has_one = array(
|
|
|
|
"Parent" => "WidgetArea",
|
|
|
|
);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var string
|
|
|
|
*/
|
|
|
|
private static $default_sort = "\"Sort\"";
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var string
|
|
|
|
*/
|
|
|
|
private static $title = "Widget Title";
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var string
|
|
|
|
*/
|
|
|
|
private static $cmsTitle = "Name of this widget";
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var string
|
|
|
|
*/
|
|
|
|
private static $description = "Description of what this widget does.";
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
private static $summary_fields = array(
|
|
|
|
'CMSTitle' => 'Title'
|
|
|
|
);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var WidgetController
|
|
|
|
*/
|
|
|
|
protected $controller;
|
|
|
|
|
|
|
|
public function populateDefaults()
|
|
|
|
{
|
|
|
|
parent::populateDefaults();
|
|
|
|
$this->setField('Title', $this->getTitle());
|
|
|
|
}
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
/**
|
|
|
|
* Note: Overloaded in {@link WidgetController}.
|
2016-07-14 01:24:26 +02:00
|
|
|
*
|
2015-11-18 05:08:21 +01:00
|
|
|
* @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();
|
|
|
|
}
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
return $this->Content();
|
|
|
|
}
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
/**
|
2016-07-14 01:24:26 +02:00
|
|
|
* Renders the widget content in a custom template with the same name as the
|
2015-11-18 05:08:21 +01:00
|
|
|
* current class. This should be the main point of output customization.
|
2016-07-14 01:24:26 +02:00
|
|
|
*
|
|
|
|
* Invoked from within WidgetHolder.ss, which contains the "framing" around
|
2015-11-18 05:08:21 +01:00
|
|
|
* the custom content, like a title.
|
2016-07-14 01:24:26 +02:00
|
|
|
*
|
2015-11-18 05:08:21 +01:00
|
|
|
* Note: Overloaded in {@link WidgetController}.
|
2016-07-14 01:24:26 +02:00
|
|
|
*
|
2015-11-18 05:08:21 +01:00
|
|
|
* @return string HTML
|
|
|
|
*/
|
|
|
|
public function Content()
|
|
|
|
{
|
|
|
|
return $this->renderWith(array_reverse(ClassInfo::ancestry($this->class)));
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
* @deprecated
|
|
|
|
*/
|
|
|
|
public function Title()
|
|
|
|
{
|
|
|
|
return $this->getTitle();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the frontend title for this widget
|
|
|
|
*
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function getTitle()
|
|
|
|
{
|
|
|
|
return $this->getField('Title')
|
2016-07-14 01:24:26 +02:00
|
|
|
?: _t($this->class . '.TITLE', $this->config()->title);
|
2015-11-18 05:08:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
* @deprecated
|
|
|
|
*/
|
|
|
|
public function CMSTitle()
|
|
|
|
{
|
|
|
|
return $this->getCMSTitle();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function getCMSTitle()
|
|
|
|
{
|
2016-07-14 01:24:26 +02:00
|
|
|
return _t($this->class . '.CMSTITLE', $this->config()->cmsTitle);
|
2015-11-18 05:08:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
* @deprecated
|
|
|
|
*/
|
|
|
|
public function Description()
|
|
|
|
{
|
|
|
|
return $this->getDescription();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function getDescription()
|
|
|
|
{
|
2016-07-14 01:24:26 +02:00
|
|
|
return _t($this->class . '.DESCRIPTION', $this->config()->description);
|
2015-11-18 05:08:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string - HTML
|
|
|
|
*/
|
|
|
|
public function DescriptionSegment()
|
|
|
|
{
|
|
|
|
return $this->renderWith('WidgetDescription');
|
|
|
|
}
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
/**
|
|
|
|
* @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);
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
return $fields;
|
|
|
|
}
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
/**
|
|
|
|
* @return FieldList
|
|
|
|
*/
|
|
|
|
public function CMSEditor()
|
|
|
|
{
|
|
|
|
$fields = $this->getCMSFields();
|
|
|
|
$outputFields = new FieldList();
|
|
|
|
|
2016-07-18 01:12:46 +02:00
|
|
|
$this->FormID = $this->ID ?: uniqid();
|
2016-07-14 01:24:26 +02:00
|
|
|
$outputFields->push(HiddenField::create('Widget[' . $this->FormID . '][FormID]', 'FormID',
|
|
|
|
$this->FormID)->addExtraClass('formid'));
|
2016-06-21 01:22:38 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
foreach ($fields as $field) {
|
|
|
|
$name = $field->getName();
|
|
|
|
$value = $this->getField($name);
|
|
|
|
if ($value) {
|
|
|
|
$field->setValue($value);
|
|
|
|
}
|
2016-06-21 01:22:38 +02:00
|
|
|
$namefiltered = preg_replace("/([A-Za-z0-9\-_]+)/", "Widget[" . $this->FormID . "][\\1]", $name);
|
|
|
|
|
|
|
|
$field->setName($namefiltered);
|
2015-11-18 05:08:21 +01:00
|
|
|
$outputFields->push($field);
|
|
|
|
}
|
|
|
|
|
|
|
|
return $outputFields;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function ClassName()
|
|
|
|
{
|
|
|
|
return $this->class;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function Name()
|
|
|
|
{
|
2016-07-14 01:24:26 +02:00
|
|
|
return "Widget[" . $this->ID . "]";
|
2015-11-18 05:08:21 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @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";
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
if (class_exists($controllerClass)) {
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
$controllerClass = "{$widgetClass}Controller";
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
if (class_exists($controllerClass)) {
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!class_exists($controllerClass)) {
|
|
|
|
throw new Exception("Could not find controller class for $this->classname");
|
|
|
|
}
|
|
|
|
|
|
|
|
$this->controller = Injector::inst()->create($controllerClass, $this);
|
|
|
|
|
|
|
|
return $this->controller;
|
|
|
|
}
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
/**
|
|
|
|
* @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);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
//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);
|
|
|
|
}
|
|
|
|
}
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
$this->write();
|
2016-07-14 01:24:26 +02:00
|
|
|
|
2015-11-18 05:08:21 +01:00
|
|
|
// The field must be written to ensure a unique ID.
|
2016-07-14 01:24:26 +02:00
|
|
|
$this->Name = $this->class . $this->ID;
|
2015-11-18 05:08:21 +01:00
|
|
|
$this->write();
|
|
|
|
}
|
2012-04-18 23:15:45 +02:00
|
|
|
}
|