mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo
synced 2024-12-01 02:46:46 +00:00
119 lines
3.4 KiB
PHP
119 lines
3.4 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Static class for handling all kinds of event logging
|
|
*/
|
|
class MWEchoEventLogging {
|
|
|
|
/**
|
|
* This is the only function that interacts with EventLogging
|
|
* @param $schema string
|
|
* @param $data array
|
|
*/
|
|
public static function actuallyLogTheEvent( $schema, $data ) {
|
|
global $wgEchoConfig;
|
|
|
|
efLogServerSideEvent( $schema, $wgEchoConfig['eventlogging'][$schema]['revision'], $data );
|
|
}
|
|
|
|
/**
|
|
* Function for logging the event for Schema:Echo
|
|
* @param $user User being notified.
|
|
* @param $event EchoEvent to log detail about.
|
|
* @param $deliveryMethod string containing either 'web' or 'email'
|
|
*/
|
|
public static function logSchemaEcho( User $user, EchoEvent $event, $deliveryMethod ) {
|
|
global $wgEchoConfig, $wgEchoNotifications;
|
|
if ( !$wgEchoConfig['eventlogging']['Echo']['enabled'] ) {
|
|
// Only attempt event logging if Echo schema is enabled
|
|
return;
|
|
}
|
|
|
|
$agent = $event->getAgent();
|
|
// Typically an event should always have an agent, but agent could be
|
|
// null if the data is corrupted
|
|
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' => $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';
|
|
}
|
|
|
|
self::actuallyLogTheEvent( 'Echo', $data );
|
|
}
|
|
|
|
/**
|
|
* Function for logging the event for Schema:EchoEmail
|
|
* @param $user User
|
|
* @param $emailDeliveryMode string
|
|
*/
|
|
public static function logSchemaEchoMail( User $user, $emailDeliveryMode = 'single' ) {
|
|
global $wgEchoConfig;
|
|
|
|
if ( !$wgEchoConfig['eventlogging']['EchoMail']['enabled'] ) {
|
|
// Only attempt event logging if EchoMail schema is enabled
|
|
return;
|
|
}
|
|
|
|
$data = array (
|
|
'version' => $wgEchoConfig['version'],
|
|
'recipientUserId' => $user->getId(),
|
|
'emailDeliveryMode' => $emailDeliveryMode
|
|
);
|
|
|
|
self::actuallyLogTheEvent( 'EchoMail', $data );
|
|
}
|
|
|
|
/**
|
|
* Function for logging the event for Schema:EchoPrefUpdate
|
|
* @param $user User user who updates the preference page
|
|
* @param $prefUpdate array list of user preferences being updated
|
|
*/
|
|
public static function logSchemaEchoPrefUpdate( User $user, array $prefUpdate ) {
|
|
global $wgEchoConfig;
|
|
|
|
if ( !$wgEchoConfig['eventlogging']['EchoPrefUpdate']['enabled'] ) {
|
|
// Only attempt event logging if EchoPrefUpdate schema is enabled
|
|
return;
|
|
}
|
|
|
|
$data = array (
|
|
'version' => $wgEchoConfig['version'],
|
|
'userId' => $user->getId(),
|
|
'saveTimestamp' => wfTimestampNow()
|
|
);
|
|
foreach ( $prefUpdate as $prefName => $prefValue ) {
|
|
$data['property'] = $prefName;
|
|
$data['value'] = (string)$prefValue;
|
|
$data['isDefault'] = User::getDefaultOption( $prefName ) == $prefValue;
|
|
self::actuallyLogTheEvent( 'EchoPrefUpdate', $data );
|
|
}
|
|
}
|
|
|
|
}
|