silverstripe-cms/code/ReportAdmin.php

<?php
/**
 * Reports section of the CMS.
 * 
 * @TODO If reports need to subclass Report in order
 * to show, then why don't we have an abstract Report
 * class around?'
 * 
 * @package cms
 * @subpackage reports
 */
class ReportAdmin extends LeftAndMain {
	
	static $template_path = null; // defaults to (project)/templates/email
	
	public function init() {
		parent::init();
		
		// @TODO determine what is not necessary to include here
		Requirements::javascript(MCE_ROOT . "tiny_mce_src.js");
		Requirements::javascript(THIRDPARTY_DIR . "/tiny_mce_improvements.js");
		
		Requirements::javascript(THIRDPARTY_DIR . "/hover.js");
		Requirements::javascript(THIRDPARTY_DIR . "/scriptaculous/controls.js");
		
		Requirements::javascript(CMS_DIR . "/javascript/SecurityAdmin.js");
        
		Requirements::javascript(CMS_DIR . "/javascript/LeftAndMain_left.js");
		Requirements::javascript(CMS_DIR . "/javascript/LeftAndMain_right.js");
		Requirements::javascript(CMS_DIR . "/javascript/CMSMain_left.js");
		
		Requirements::javascript(CMS_DIR . "/javascript/ReportAdmin_left.js");
		Requirements::javascript(CMS_DIR . "/javascript/ReportAdmin_right.js");
		
		Requirements::css(CMS_DIR . "/css/ReportAdmin.css");		
		
		// TODO Find a better solution to integrate optional Requirements in a specific order
		if(Director::fileExists("ecommerce/css/DataReportCMSMain.css")) {
			Requirements::css("ecommerce/css/DataReportCMSMain.css");		
		}
		if(Director::fileExists("ecommerce/css/DataReportCMSMain.css")) {
			Requirements::javascript("ecommerce/javascript/DataReport.js");		
		}
		if(Director::fileExists(project() . "/css/DataReportCMSMain.css")) {
			Requirements::css(project() . "/css/DataReportCMSMain.css");		
		}
		if(Director::fileExists(project() . "/css/DataReportCMSMain.css")) {
			Requirements::javascript(project() . "/javascript/DataReport.js");		
		}
		
		// We don't want this showing up in every ajax-response, it should always be present in a CMS-environment
		if(!Director::is_ajax()) {
			Requirements::javascriptTemplate("cms/javascript/tinymce.template.js", array(
				"ContentCSS" => project() . "/css/editor.css",
				"BaseURL" => Director::absoluteBaseURL(),
				"Lang" => i18n::get_tinymce_lang()
			));
		}
	}
	
	public function Link($action = null) {
		return "admin/reports/$action";
	}
	
	/**
	 * Return a DataObjectSet of Report subclasses
	 * that are available for use.
	 *
	 * @return DataObjectSet
	 */
	public function Reports() {
		$processedReports = array();
		$subClasses = ClassInfo::subclassesFor('Report');
		
		if($subClasses) {
			foreach($subClasses as $subClass) {
				if($subClass != 'Report') $processedReports[] = new $subClass();
			}
		}
		
		$reports = new DataObjectSet($processedReports);
		
		return $reports;
	}
	
	/**
	 * Show a report based on the URL query string.
	 *
	 * @param HTTPRequest $request The HTTP request object
	 */
	public function show($request) {
		$params = $request->allParams();
		
		return $this->showWithEditForm($params, $this->reportEditFormFor($params['ID']));	
	}

	/**
	 * @TODO What does this do?
	 *
	 * @param unknown_type $params
	 * @param unknown_type $editForm
	 * @return unknown
	 */
	protected function showWithEditForm($params, $editForm) {
		if(isset($params['ID'])) Session::set('currentPage', $params['ID']);
		if(isset($params['OtherID'])) Session::set('currentOtherID', $params['OtherID']);
		
		if(Director::is_ajax()) {
			SSViewer::setOption('rewriteHashlinks', false);
			
			$result = $this->customise(
				array(
					'EditForm' => $editForm
				)
			)->renderWith($this->getTemplatesWithSuffix('_right'));
			
			return $this->getLastFormIn($result);
		} else {
			return array();
		}
	}
	
	/**
	 * For the current report that the user is viewing,
	 * return a Form instance with the fields for that
	 * report.
	 *
	 * @return Form
	 */
	public function EditForm() {
		$ids = array();
		$id = isset($_REQUEST['ID']) ? $_REQUEST['ID'] : Session::get('currentPage');
		$subClasses = ClassInfo::subclassesFor('Report');
		
		if($subClasses) {
			foreach($subClasses as $subClass) {
				if($subClass != 'Report') {
					$obj = new $subClass();
					$ids[] = $obj->getOwnerID();
				}
			}
		}
		
		if($id && in_array($id, $ids)) return $this->reportEditFormFor($id);
		else return false;
	}
	
	/**
	 * Return a Form instance with fields for the
	 * particular report currently viewed.
	 * 
	 * @TODO Dealing with multiple data types for the
	 * $id parameter is confusing. Ideally, it should
	 * deal with only one.
	 *
	 * @param id|string $id The ID of the report, or class name
	 * @return Form
	 */
	public function reportEditFormFor($id) {
		$page = false;
		$fields = new FieldSet();
		$actions = new FieldSet();
		
		if(is_numeric($id)) $page = DataObject::get_by_id('SiteTree', $id);
		$reportClass = is_object($page) ? 'Report_' . $page->ClassName : $id;
		
		$obj = new $reportClass();
		if($obj) $fields = $obj->getCMSFields();
		
		$idField = new HiddenField('ID');
		$idField->setValue($id);
		$fields->push($idField);
		
		$form = new Form($this, 'EditForm', $fields, $actions);
		
		return $form;
	}
	
	/**
	 * Determine if we have reports and need
	 * to display the "Reports" main menu item
	 * in the CMS.
	 * 
	 * The test for an existance of a report
	 * is done by checking for a subclass of
	 * "Report" that exists.
	 *
	 * @return boolean
	 */
	public static function has_reports() {
		$subClasses = ClassInfo::subclassesFor('Report');
		
		if($subClasses) {
			foreach($subClasses as $subClass) {
				if($subClass != 'Report') {
					return true;
				}
			}
		}
		
		return false;
	}
}

?>