mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo
synced 2024-11-28 09:40:41 +00:00
2186e9a6b6
We have a convention to put a logger helper function in MWEchoEventLogging, so also enforce that: * Rename to actuallyLogTheEvent to logEvent and centralize the 'enabled' check there. * Make that protected, so new schemas also use a helper function for consistency. Bug: T143092 Change-Id: I8085fc5898f3420172355c5a2df04aac6add9acd
120 lines
3.2 KiB
PHP
120 lines
3.2 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Static class for handling all kinds of event logging
|
|
*/
|
|
class MWEchoEventLogging {
|
|
|
|
/**
|
|
* This is the only function that interacts with EventLogging
|
|
*
|
|
* Logs if logging is enabled for the given $schema.
|
|
*
|
|
* @param string $schema
|
|
* @param array $data
|
|
*/
|
|
protected static function logEvent( $schema, array $data ) {
|
|
global $wgEchoConfig;
|
|
|
|
$schemaConfig = $wgEchoConfig['eventlogging'][$schema];
|
|
if ( !$schemaConfig['enabled'] ) {
|
|
// If logging for this schema is disabled, it's a no-op.
|
|
return;
|
|
}
|
|
|
|
EventLogging::logEvent( $schema, $schemaConfig['revision'], $data );
|
|
}
|
|
|
|
/**
|
|
* Function for logging the event for Schema:Echo
|
|
* @param User $user User being notified.
|
|
* @param EchoEvent $event Event to log detail about.
|
|
* @param string $deliveryMethod 'web' or 'email'
|
|
*/
|
|
public static function logSchemaEcho( User $user, EchoEvent $event, $deliveryMethod ) {
|
|
global $wgEchoConfig, $wgEchoNotifications;
|
|
|
|
// Notifications under system category should have -1 as sender id
|
|
if ( $event->getCategory() === 'system' ) {
|
|
$sender = -1;
|
|
} else {
|
|
$agent = $event->getAgent();
|
|
if ( $agent ) {
|
|
$sender = $agent->isAnon() ? $agent->getName() : $agent->getId();
|
|
} else {
|
|
$sender = -1;
|
|
}
|
|
}
|
|
|
|
if ( isset( $wgEchoNotifications[$event->getType()]['group'] ) ) {
|
|
$group = $wgEchoNotifications[$event->getType()]['group'];
|
|
} else {
|
|
$group = 'neutral';
|
|
}
|
|
$data = array(
|
|
'version' => $wgEchoConfig['version'],
|
|
'eventId' => (int)$event->getId(),
|
|
'notificationType' => $event->getType(),
|
|
'notificationGroup' => $group,
|
|
'sender' => (string)$sender,
|
|
'recipientUserId' => $user->getId(),
|
|
'recipientEditCount' => (int)$user->getEditCount()
|
|
);
|
|
// Add the source if it exists. (This is mostly for the Thanks extension.)
|
|
$extra = $event->getExtra();
|
|
if ( isset( $extra['source'] ) ) {
|
|
$data['eventSource'] = (string)$extra['source'];
|
|
}
|
|
if ( $deliveryMethod == 'email' ) {
|
|
$data['deliveryMethod'] = 'email';
|
|
} else {
|
|
// whitelist valid delivery methods so it is always valid
|
|
$data['deliveryMethod'] = 'web';
|
|
}
|
|
// Add revision ID if it exists
|
|
$rev = $event->getRevision();
|
|
if ( $rev ) {
|
|
$data['revisionId'] = $rev->getId();
|
|
}
|
|
|
|
self::logEvent( 'Echo', $data );
|
|
}
|
|
|
|
/**
|
|
* Function for logging the event for Schema:EchoEmail
|
|
* @param User $user
|
|
* @param string $emailDeliveryMode 'single' (default), 'daily_digest', or 'weekly_digest'
|
|
*/
|
|
public static function logSchemaEchoMail( User $user, $emailDeliveryMode = 'single' ) {
|
|
global $wgEchoConfig;
|
|
|
|
$data = array(
|
|
'version' => $wgEchoConfig['version'],
|
|
'recipientUserId' => $user->getId(),
|
|
'emailDeliveryMode' => $emailDeliveryMode
|
|
);
|
|
|
|
self::logEvent( 'EchoMail', $data );
|
|
}
|
|
|
|
/**
|
|
* @param User $user
|
|
* @param string $skinName
|
|
*/
|
|
public static function logEchoInteraction( User $user, $skinName ) {
|
|
self::logEvent(
|
|
'EchoInteraction',
|
|
array(
|
|
'context' => 'archive',
|
|
'action' => 'special-page-visit',
|
|
'userId' => (int)$user->getId(),
|
|
'editCount' => (int)$user->getEditCount(),
|
|
'notifWiki' => wfWikiID(),
|
|
// Hack: Figure out if we are in the mobile skin
|
|
'mobile' => $skinName === 'minerva',
|
|
)
|
|
);
|
|
}
|
|
|
|
}
|