PHP Class Piwik\Plugins\Actions\API

For example, "getPageTitles" will return all your page titles along with standard Actions metrics for each row. It is also possible to request data for a specific Page Title with "getPageTitle" and setting the parameter pageName to the page title you wish to request. Similarly, you can request metrics for a given Page URL via "getPageUrl", a Download file via "getDownload" and an outlink via "getOutlink". Note: pageName, pageUrl, outlinkUrl, downloadUrl parameters must be URL encoded before you call the API.
Inheritance: extends Piwik\Plugin\API
Show file Open project: piwik/piwik Class Usage Examples

Public Methods

Method Description
get ( integer $idSite, string $period, string $date, boolean | string $segment = false, boolean | array $columns = false ) : DataTable Returns the list of metrics (pages, downloads, outlinks)
getDownload ( $downloadUrl, $idSite, $period, $date, $segment = false )
getDownloads ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false, $flat = false )
getEntryPageTitles ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false ) Returns a DataTable with analytics information for every unique entry page title for the given site, time period & segment.
getEntryPageUrls ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false ) Returns a DataTable with analytics information for every unique entry page URL, for the specified site, period & segment.
getExitPageTitles ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false ) Returns a DataTable with analytics information for every unique exit page title for the given site, time period & segment.
getExitPageUrls ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false ) Returns a DataTable with analytics information for every unique exit page URL, for the specified site, period & segment.
getOutlink ( $outlinkUrl, $idSite, $period, $date, $segment = false )
getOutlinks ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false, $flat = false )
getPageTitle ( $pageName, $idSite, $period, $date, $segment = false )
getPageTitles ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false, $flat = false )
getPageTitlesFollowingSiteSearch ( integer $idSite, string $period, Date $date, boolean $segment = false, boolean $expanded = false, boolean $idSubtable = false ) : DataTable | Piwik\DataTable\Map
getPageUrl ( $pageUrl, $idSite, $period, $date, $segment = false )
getPageUrls ( integer $idSite, string $period, Date $date, boolean $segment = false, boolean $expanded = false, boolean | integer $idSubtable = false, boolean | integer $depth = false, boolean | integer $flat = false ) : DataTable | Piwik\DataTable\Map
getPageUrlsFollowingSiteSearch ( integer $idSite, string $period, Date $date, boolean $segment = false, boolean $expanded = false, boolean $idSubtable = false ) : DataTable | Piwik\DataTable\Map
getSiteSearchCategories ( integer $idSite, string $period, Date $date, boolean $segment = false ) : DataTable | Piwik\DataTable\Map
getSiteSearchKeywords ( $idSite, $period, $date, $segment = false )
getSiteSearchNoResultKeywords ( $idSite, $period, $date, $segment = false )

Protected Methods

Method Description
addPagesPerSearchColumn ( DataTable | Piwik\DataTable\Simple | Piwik\DataTable\Map $dataTable, string $columnToRead = 'nb_hits' ) Visitors can search, and then click "next" to view more results. This is the average number of search results pages viewed for this keyword.
doFilterPageDatatableSearch ( $callBackParameters, $table, $searchTree ) This looks very similar to LabelFilter.php should it be refactored somehow? FIXME
getFilterPageDatatableSearch ( $callBackParameters, $search, $actionType, $table = false, $searchTree = false ) Will search in the DataTable for a Label matching the searched string and return only the matching row, or an empty datatable
getSiteSearchKeywordsRaw ( $idSite, $period, $date, $segment )
keepPagesFollowingSearch ( DataTable $dataTable )

Private Methods

Method Description
addPageProcessedMetrics ( Piwik\DataTable\DataTableInterface $dataTable )
filterActionsDataTable ( DataTable | Piwik\DataTable\Simple | Piwik\DataTable\Map $dataTable ) Common filters for all Actions API
filterNonEntryActions ( DataTable $dataTable ) Removes DataTable rows referencing actions that were never the first action of a visit.
filterNonExitActions ( DataTable $dataTable ) Removes DataTable rows referencing actions that were never the last action of a visit.

Method Details

addPagesPerSearchColumn() protected method

Visitors can search, and then click "next" to view more results. This is the average number of search results pages viewed for this keyword.
protected addPagesPerSearchColumn ( DataTable | Piwik\DataTable\Simple | Piwik\DataTable\Map $dataTable, string $columnToRead = 'nb_hits' )
$dataTable Piwik\DataTable | Piwik\DataTable\Simple | Piwik\DataTable\Map
$columnToRead string

doFilterPageDatatableSearch() protected method

This looks very similar to LabelFilter.php should it be refactored somehow? FIXME
protected doFilterPageDatatableSearch ( $callBackParameters, $table, $searchTree )

get() public method

Returns the list of metrics (pages, downloads, outlinks)
public get ( integer $idSite, string $period, string $date, boolean | string $segment = false, boolean | array $columns = false ) : DataTable
$idSite integer
$period string
$date string
$segment boolean | string
$columns boolean | array
return Piwik\DataTable

getDownload() public method

public getDownload ( $downloadUrl, $idSite, $period, $date, $segment = false )

getDownloads() public method

public getDownloads ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false, $flat = false )

getEntryPageTitles() public method

Returns a DataTable with analytics information for every unique entry page title for the given site, time period & segment.
public getEntryPageTitles ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false )

getEntryPageUrls() public method

Returns a DataTable with analytics information for every unique entry page URL, for the specified site, period & segment.
public getEntryPageUrls ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false )

getExitPageTitles() public method

Returns a DataTable with analytics information for every unique exit page title for the given site, time period & segment.
public getExitPageTitles ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false )

getExitPageUrls() public method

Returns a DataTable with analytics information for every unique exit page URL, for the specified site, period & segment.
public getExitPageUrls ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false )

getFilterPageDatatableSearch() protected method

Will search in the DataTable for a Label matching the searched string and return only the matching row, or an empty datatable
protected getFilterPageDatatableSearch ( $callBackParameters, $search, $actionType, $table = false, $searchTree = false )

getPageTitle() public method

public getPageTitle ( $pageName, $idSite, $period, $date, $segment = false )

getPageTitles() public method

public getPageTitles ( $idSite, $period, $date, $segment = false, $expanded = false, $idSubtable = false, $flat = false )

getPageTitlesFollowingSiteSearch() public method

public getPageTitlesFollowingSiteSearch ( integer $idSite, string $period, Date $date, boolean $segment = false, boolean $expanded = false, boolean $idSubtable = false ) : DataTable | Piwik\DataTable\Map
$idSite integer
$period string
$date Piwik\Date
$segment boolean
$expanded boolean
$idSubtable boolean
return Piwik\DataTable | Piwik\DataTable\Map

getPageUrl() public method

public getPageUrl ( $pageUrl, $idSite, $period, $date, $segment = false )

getPageUrls() public method

public getPageUrls ( integer $idSite, string $period, Date $date, boolean $segment = false, boolean $expanded = false, boolean | integer $idSubtable = false, boolean | integer $depth = false, boolean | integer $flat = false ) : DataTable | Piwik\DataTable\Map
$idSite integer
$period string
$date Piwik\Date
$segment boolean
$expanded boolean
$idSubtable boolean | integer
$depth boolean | integer
$flat boolean | integer
return Piwik\DataTable | Piwik\DataTable\Map

getPageUrlsFollowingSiteSearch() public method

public getPageUrlsFollowingSiteSearch ( integer $idSite, string $period, Date $date, boolean $segment = false, boolean $expanded = false, boolean $idSubtable = false ) : DataTable | Piwik\DataTable\Map
$idSite integer
$period string
$date Piwik\Date
$segment boolean
$expanded boolean
$idSubtable boolean
return Piwik\DataTable | Piwik\DataTable\Map

getSiteSearchCategories() public method

public getSiteSearchCategories ( integer $idSite, string $period, Date $date, boolean $segment = false ) : DataTable | Piwik\DataTable\Map
$idSite integer
$period string
$date Piwik\Date
$segment boolean
return Piwik\DataTable | Piwik\DataTable\Map

getSiteSearchKeywords() public method

public getSiteSearchKeywords ( $idSite, $period, $date, $segment = false )

getSiteSearchKeywordsRaw() protected method

protected getSiteSearchKeywordsRaw ( $idSite, $period, $date, $segment )

getSiteSearchNoResultKeywords() public method

public getSiteSearchNoResultKeywords ( $idSite, $period, $date, $segment = false )

keepPagesFollowingSearch() protected method

protected keepPagesFollowingSearch ( DataTable $dataTable )
$dataTable Piwik\DataTable