silverstripe-framework/widgets/Widget.php

<?php

/**
 * @package sapphire
 * @subpackage widgets
 */

/**
 * Base class for widgets.
 * Widgets let CMS authors drag and drop small pieces of functionality into defined areas of their websites.
 * @package sapphire
 * @subpackage widgets
 */
class Widget extends DataObject {
	static $db = array(
		"ParentID" => "Int",
		"Sort" => "Int"
	);
		
	static $default_sort = "Sort";
	
	static $title = "Widget Title";
	static $cmsTitle = "Name of this widget";
	static $description = "Description of what this widget does.";
	
	function getCMSFields() {
		return new FieldSet();
	}
	
	function WidgetHolder() {
		return $this->renderWith("WidgetHolder");
	}
	
	function Content() {
		return $this->renderWith($this->class);
	}
	
	function Title() {
		$instance = singleton($this->class);
		return $instance->uninherited('title', true);
	}
	
	function CMSTitle() {
		$instance = singleton($this->class);
		return $instance->uninherited('cmsTitle', true);
	}
	
	function Description() {
		$instance = singleton($this->class);
		return $instance->uninherited('description', true);
	}
	
	function DescriptionSegment() {
		return $this->renderWith('WidgetDescription'); 
	}
	
	function EditableSegment() {
		return $this->renderWith('WidgetEditor'); 
	}
	
	function CMSEditor() {
		$output = '';
		
		$fields = $this->getCMSFields();
		foreach($fields as $field) {
			$name = $field->Name();
			$field->setValue($this->getField($name));
			$renderedField = $field->FieldHolder();
			$renderedField = ereg_replace("name=\"([A-Za-z0-9\-_]+)\"", "name=\"Widget[" . $this->ID . "][\\1]\"", $renderedField);
			$renderedField = ereg_replace("id=\"([A-Za-z0-9\-_]+)\"", "id=\"Widget[" . $this->ID . "][\\1]\"", $renderedField);
			$output .= $renderedField;
		}
		return $output;
	}
	
	function ClassName() {
		return $this->class;
	}
	
	function Name() {
		return "Widget[".$this->ID."]";
	}

	function populateFromPostData($data) {
		foreach($data as $name => $value) {
			if($name != "Type") {
				$this->setField($name, $value);
			}
		}
		
		$this->write();
		
		// The field must be written to ensure a unique ID.
		$this->Name = $this->class.$this->ID;
		$this->write();
	}

}

?>