PHP Class Piwik\Plugins\ExampleTracker\Columns\ExampleVisitDimension

See {@link http://developer.piwik.org/api-reference/Piwik/Plugin\Dimension\VisitDimension} for more information.
Inheritance: extends Piwik\Plugin\Dimension\VisitDimension
Afficher le fichier Open project: piwik/piwik

Protected Properties

Свойство Type Description
$columnName string This will be the name of the column in the log_visit table if a $columnType is specified.
$columnType string If a columnType is defined, we will create this a column in the MySQL table having this type. Please make sure MySQL will understand this type. Once you change the column type the Piwik platform will notify the user to perform an update which can sometimes take a long time so be careful when choosing the correct column type.

Méthodes publiques

Méthode Description
getName ( ) : string The name of the dimension which will be visible for instance in the UI of a related report and in the mobile app.
onConvertedVisit ( Request $request, Piwik\Tracker\Visitor $visitor, Action | null $action ) : mixed | false This event is executed shortly after "onNewVisit" or "onExistingVisit" in case the visitor converted a goal.
onExistingVisit ( Request $request, Piwik\Tracker\Visitor $visitor, Action | null $action ) : mixed | false The onExistingVisit method is triggered when a visitor was recognized meaning it is not a new visitor.
onNewVisit ( Request $request, Piwik\Tracker\Visitor $visitor, Action | null $action ) : mixed | false The onNewVisit method is triggered when a new visitor is detected. This means here you can define an initial value for this user. By returning boolean false no value will be saved. Once the user makes another action the event "onExistingVisit" is executed. That means for each visitor this method is executed once. If you do not want to perform any action on a new visit you can just remove this method.

Méthodes protégées

Méthode Description
configureSegments ( ) By defining one or multiple segments a user will be able to filter their visitors by this column. For instance show all reports only considering users having more than 10 achievement points. If you do not want to define a segment for this dimension just remove the column.

Method Details

configureSegments() protected méthode

By defining one or multiple segments a user will be able to filter their visitors by this column. For instance show all reports only considering users having more than 10 achievement points. If you do not want to define a segment for this dimension just remove the column.
protected configureSegments ( )

getName() public méthode

The name of the dimension which will be visible for instance in the UI of a related report and in the mobile app.
public getName ( ) : string
Résultat string

onConvertedVisit() public méthode

In this example we give the user 5 extra points for this achievement. Usually this event is not needed and you can simply remove this method therefore. An example would be for instance to persist the last converted action url. Return boolean false if you do not want to change the current value.
public onConvertedVisit ( Request $request, Piwik\Tracker\Visitor $visitor, Action | null $action ) : mixed | false
$request Piwik\Tracker\Request
$visitor Piwik\Tracker\Visitor
$action Piwik\Tracker\Action | null
Résultat mixed | false

onExistingVisit() public méthode

If you want you can overwrite any previous value set by the event onNewVisit. By returning boolean false no value will be updated. If you do not want to perform any action on a new visit you can just remove this method.
public onExistingVisit ( Request $request, Piwik\Tracker\Visitor $visitor, Action | null $action ) : mixed | false
$request Piwik\Tracker\Request
$visitor Piwik\Tracker\Visitor
$action Piwik\Tracker\Action | null
Résultat mixed | false

onNewVisit() public méthode

The onNewVisit method is triggered when a new visitor is detected. This means here you can define an initial value for this user. By returning boolean false no value will be saved. Once the user makes another action the event "onExistingVisit" is executed. That means for each visitor this method is executed once. If you do not want to perform any action on a new visit you can just remove this method.
public onNewVisit ( Request $request, Piwik\Tracker\Visitor $visitor, Action | null $action ) : mixed | false
$request Piwik\Tracker\Request
$visitor Piwik\Tracker\Visitor
$action Piwik\Tracker\Action | null
Résultat mixed | false

Property Details

$columnName protected_oe property

This will be the name of the column in the log_visit table if a $columnType is specified.
protected string $columnName
Résultat string

$columnType protected_oe property

If a columnType is defined, we will create this a column in the MySQL table having this type. Please make sure MySQL will understand this type. Once you change the column type the Piwik platform will notify the user to perform an update which can sometimes take a long time so be careful when choosing the correct column type.
protected string $columnType
Résultat string