silverstripe-framework/widgets/WidgetArea.php

<?php
/**
 * Represents a set of widgets shown on a page.
 * @package sapphire
 * @subpackage widgets
 */
class WidgetArea extends DataObject {
	
	static $db = array();
	
	static $has_one = array();
	
	static $has_many = array(
		"Widgets" => "Widget"
	);
	
	static $many_many = array();
	
	static $belongs_many_many = array();
	
	public $template = __CLASS__;
	
	/**
	 * Used in template instead of {@link Widgets()}
	 * to wrap each widget in its controller, making
	 * it easier to access and process form logic
	 * and actions stored in {@link Widget_Controller}.
	 * 
	 * @return DataObjectSet Collection of {@link Widget_Controller}
	 */
	function WidgetControllers() {
		$controllers = new DataObjectSet();

		foreach($this->ItemsToRender() as $widget) {
			// find controller
			$controllerClass = '';
			foreach(array_reverse(ClassInfo::ancestry($widget->class)) as $widgetClass) {
				$controllerClass = "{$widgetClass}_Controller";
				if(class_exists($controllerClass)) break;
			}
			$controller = new $controllerClass($widget);
			$controller->init();
			$controllers->push($controller);
		}

		//assign sort field based on sort in static array in DashboardView
		foreach($controllers as $c)	{
			$sortOrder = DashboardView::getSortOrder($c->MetricName, $c->ClassName);
			$c->Sort = $sortOrder;
		}
		$controllers->sort('Sort'); //sort ascending by 'sort' field

		return $controllers;
	}
	
	function Items() {
		return $this->getComponents('Widgets');
	}
	
	function ItemsToRender() {
		return $this->getComponents('Widgets', "\"Widget\".\"Enabled\" = 1");
	}
	
	function forTemplate() {
		return $this->renderWith($this->template); 
	}
	
	function setTemplate($template) {
		$this->template = $template;
	}
	
	function onBeforeDelete() {
		parent::onBeforeDelete();
		foreach($this->Widgets() as $widget) {
			$widget->delete();
		}
	}
}

?>