<?php/** * Piwik - Open source web analytics * * @link http://piwik.org * @license http://www.gnu.org/licenses/gpl-3.0.html Gpl v3 or later * @version $Id: API.php 668 2008-11-03 16:21:10Z matt $ * * @package Piwik_Referers */require_once "Referers/functions.php";/** * * @package Piwik_Referers */class Piwik_Referers_API extends Piwik_Apiable{	static private $instance = null;	static public function getInstance()	{		if (self::$instance == null)		{			$c = __CLASS__;			self::$instance = new $c();		}		return self::$instance;	}	/**	 * @return Piwik_DataTable	 */	private function getDataTable($name, $idSite, $period, $date, $expanded, $idSubtable = null)	{		Piwik::checkUserHasViewAccess( $idSite );		$archive = Piwik_Archive::build($idSite, $period, $date );		if($expanded)		{			$dataTable = $archive->getDataTableExpanded($name, $idSubtable);			$dataTable->enableRecursiveSort();		}		else		{			$dataTable = $archive->getDataTable($name, $idSubtable);		}		$dataTable->queueFilter('Piwik_DataTable_Filter_ReplaceColumnNames');		$dataTable->queueFilter('Piwik_DataTable_Filter_ReplaceSummaryRowLabel');		return $dataTable;	}		function getRefererType($idSite, $period, $date)	{		$dataTable = $this->getDataTable('Referers_type',$idSite, $period, $date, $expanded = false);		$dataTable->queueFilter('Piwik_DataTable_Filter_ColumnCallbackReplace', array('label', 'Piwik_getRefererTypeLabel'));		return $dataTable;	}	function getKeywords($idSite, $period, $date, $expanded = false)	{		$dataTable = $this->getDataTable('Referers_searchEngineByKeyword',$idSite, $period, $date, $expanded);		return $dataTable;	}	function getSearchEnginesFromKeywordId($idSite, $period, $date, $idSubtable)	{		$dataTable = $this->getDataTable('Referers_searchEngineByKeyword',$idSite, $period, $date, $expanded = false, $idSubtable);		$dataTable->queueFilter('Piwik_DataTable_Filter_ColumnCallbackAddMetadata', array( 'label', 'url', 'Piwik_getSearchEngineUrlFromName') );		$dataTable->queueFilter('Piwik_DataTable_Filter_MetadataCallbackAddMetadata', array( 'url', 'logo', 'Piwik_getSearchEngineLogoFromName') );		return $dataTable;	}	function getSearchEngines($idSite, $period, $date, $expanded = false)	{		$dataTable = $this->getDataTable('Referers_keywordBySearchEngine',$idSite, $period, $date, $expanded);		$dataTable->queueFilter('Piwik_DataTable_Filter_ColumnCallbackAddMetadata', array( 'label', 'url', 'Piwik_getSearchEngineUrlFromName') );		$dataTable->queueFilter('Piwik_DataTable_Filter_MetadataCallbackAddMetadata', array( 'url', 'logo', 'Piwik_getSearchEngineLogoFromName') );		return $dataTable;	}	function getKeywordsFromSearchEngineId($idSite, $period, $date, $idSubtable)	{		$dataTable = $this->getDataTable('Referers_keywordBySearchEngine',$idSite, $period, $date, $expanded = false, $idSubtable);		return $dataTable;	}	function getCampaigns($idSite, $period, $date, $expanded = false)	{		$dataTable = $this->getDataTable('Referers_keywordByCampaign',$idSite, $period, $date, $expanded);		return $dataTable;	}	function getKeywordsFromCampaignId($idSite, $period, $date, $idSubtable)	{		$dataTable = $this->getDataTable('Referers_keywordByCampaign',$idSite, $period, $date, $expanded = false, $idSubtable);		return $dataTable;	}	function getWebsites($idSite, $period, $date, $expanded = false)	{		$dataTable = $this->getDataTable('Referers_urlByWebsite',$idSite, $period, $date, $expanded);		return $dataTable;	}	function getUrlsFromWebsiteId($idSite, $period, $date, $idSubtable)	{		$dataTable = $this->getDataTable('Referers_urlByWebsite',$idSite, $period, $date, $expanded = false, $idSubtable);		$dataTable->queueFilter('Piwik_DataTable_Filter_ColumnCallbackAddMetadata', array( 'label', 'url', create_function('$label', 'return $label;')) );		$dataTable->queueFilter('Piwik_DataTable_Filter_ColumnCallbackReplace', array('label', 'Piwik_getPathFromUrl'));		$dataTable->queueFilter('Piwik_DataTable_Filter_ColumnCallbackReplace', array('label', 'Piwik_truncatePath'));		return $dataTable;	}	function getPartners($idSite, $period, $date, $expanded = false)	{		$dataTable = $this->getDataTable('Referers_urlByPartner',$idSite, $period, $date, $expanded);		return $dataTable;	}	function getUrlsFromPartnerId($idSite, $period, $date, $idSubtable)	{		$dataTable = $this->getDataTable('Referers_urlByPartner',$idSite, $period, $date, $expanded = false, $idSubtable);		$dataTable->queueFilter('Piwik_DataTable_Filter_ColumnCallbackAddMetadata', array( 'label', 'url', create_function('$label', 'return $label;')) );		$dataTable->queueFilter('Piwik_DataTable_Filter_ColumnCallbackReplace', array('label', 'Piwik_getPathFromUrl'));		return $dataTable;	}	function getNumberOfDistinctSearchEngines($idSite, $period, $date)	{		return $this->getNumeric('Referers_distinctSearchEngines', $idSite, $period, $date);	}	function getNumberOfDistinctKeywords($idSite, $period, $date)	{		return $this->getNumeric('Referers_distinctKeywords', $idSite, $period, $date);	}	function getNumberOfDistinctCampaigns($idSite, $period, $date)	{		return $this->getNumeric('Referers_distinctCampaigns', $idSite, $period, $date);	}	function getNumberOfDistinctWebsites($idSite, $period, $date)	{		return $this->getNumeric('Referers_distinctWebsites', $idSite, $period, $date);	}	function getNumberOfDistinctWebsitesUrls($idSite, $period, $date)	{		return $this->getNumeric('Referers_distinctWebsitesUrls', $idSite, $period, $date);	}	function getNumberOfDistinctPartners($idSite, $period, $date)	{		return $this->getNumeric('Referers_distinctPartners', $idSite, $period, $date);	}	function getNumberOfDistinctPartnersUrls($idSite, $period, $date)	{		return $this->getNumeric('Referers_distinctPartnersUrls', $idSite, $period, $date);	}	private function getNumeric($name, $idSite, $period, $date)	{		Piwik::checkUserHasViewAccess( $idSite );		$archive = Piwik_Archive::build($idSite, $period, $date );		return $archive->getDataTableFromNumeric($name);	}}