TrackManiaControl/core/Chat.php

264 lines
8.3 KiB
PHP
Raw Normal View History

2013-11-09 17:24:03 +01:00
<?php
namespace ManiaControl;
use ManiaControl\Admin\AuthenticationManager;
2015-06-21 22:24:10 +02:00
use ManiaControl\Callbacks\CallbackListener;
use ManiaControl\Callbacks\CallbackManager;
use ManiaControl\Communication\CommunicationListener;
use ManiaControl\Communication\CommunicationMethods;
use ManiaControl\Players\Player;
use Maniaplanet\DedicatedServer\Xmlrpc\UnknownPlayerException;
2013-11-09 17:24:03 +01:00
/**
* Chat Utility Class
2013-11-09 17:24:03 +01:00
*
2014-05-02 17:40:47 +02:00
* @author ManiaControl Team <mail@maniacontrol.com>
2015-01-19 11:06:20 +01:00
* @copyright 2014-2015 ManiaControl Team
2014-05-02 17:40:47 +02:00
* @license http://www.gnu.org/licenses/ GNU General Public License, Version 3
2013-11-09 17:24:03 +01:00
*/
class Chat implements CallbackListener, CommunicationListener {
/*
* Constants
*/
2014-01-16 18:08:32 +01:00
const SETTING_PREFIX = 'Messages Prefix';
const SETTING_FORMAT_INFORMATION = 'Information Format';
2014-01-16 18:08:32 +01:00
const SETTING_FORMAT_SUCCESS = 'Success Format';
const SETTING_FORMAT_ERROR = 'Error Format';
const SETTING_FORMAT_USAGEINFO = 'UsageInfo Format';
2015-06-21 22:24:10 +02:00
const CHAT_BUFFER_SIZE = 200;
/*
* Private properties
2013-11-09 17:24:03 +01:00
*/
/** @var ManiaControl $maniaControl */
private $maniaControl = null;
2015-06-21 22:24:10 +02:00
private $chatBuffer = array();
2013-11-09 17:24:03 +01:00
/**
* Construct chat utility
*
2014-01-16 18:08:32 +01:00
* @param ManiaControl $maniaControl
*/
public function __construct(ManiaControl $maniaControl) {
$this->maniaControl = $maniaControl;
2014-01-16 18:08:32 +01:00
// Settings
2014-08-11 19:24:21 +02:00
$this->maniaControl->getSettingManager()->initSetting($this, self::SETTING_PREFIX, '» ');
$this->maniaControl->getSettingManager()->initSetting($this, self::SETTING_FORMAT_INFORMATION, '$fff');
$this->maniaControl->getSettingManager()->initSetting($this, self::SETTING_FORMAT_SUCCESS, '$0f0');
$this->maniaControl->getSettingManager()->initSetting($this, self::SETTING_FORMAT_ERROR, '$f30');
$this->maniaControl->getSettingManager()->initSetting($this, self::SETTING_FORMAT_USAGEINFO, '$f80');
2015-06-21 22:24:10 +02:00
//Callbacks
$this->maniaControl->getCallbackManager()->registerCallbackListener(CallbackManager::CB_MP_PLAYERCHAT, $this, 'onPlayerChat');
//Socket Listenings
$this->maniaControl->getCommunicationManager()->registerCommunicationListener(CommunicationMethods::GET_SERVER_CHAT, $this, function ($error, $data) {
2015-06-21 22:24:10 +02:00
return $this->chatBuffer;
});
}
2013-11-09 17:24:03 +01:00
2015-06-21 22:24:10 +02:00
2013-11-09 17:24:03 +01:00
/**
2014-05-02 17:40:47 +02:00
* Send an information message to the given login
*
2014-05-02 17:40:47 +02:00
* @param string $message
* @param string $login
2014-01-16 18:08:32 +01:00
* @param string|bool $prefix
2014-05-02 17:40:47 +02:00
* @return bool
2013-11-09 17:24:03 +01:00
*/
2014-05-02 17:40:47 +02:00
public function sendInformation($message, $login = null, $prefix = true) {
2014-08-11 19:24:21 +02:00
$format = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_FORMAT_INFORMATION);
2014-05-02 18:21:38 +02:00
return $this->sendChat($format . $message, $login, $prefix);
2013-11-09 17:24:03 +01:00
}
2014-05-02 17:40:47 +02:00
2013-11-09 17:24:03 +01:00
/**
* Send a chat message to the given login
*
2014-01-16 18:08:32 +01:00
* @param string $message
* @param string $login
* @param string|bool $prefix
* @return bool
2013-11-09 17:24:03 +01:00
*/
public function sendChat($message, $login = null, $prefix = true) {
if (!$this->maniaControl->getClient()) {
return false;
2013-11-09 17:24:03 +01:00
}
2014-08-11 19:51:46 +02:00
$prefix = $this->buildPrefix($prefix, $login);
$chatMessage = '$<$z$ff0' . $prefix . $message . '$>';
if ($login) {
if (!is_array($login)) {
$login = Player::parseLogin($login);
}
2014-05-02 17:40:47 +02:00
try {
2014-08-11 19:51:46 +02:00
return $this->maniaControl->getClient()->chatSendServerMessage($chatMessage, $login);
} catch (UnknownPlayerException $e) {
2014-08-11 19:51:46 +02:00
return false;
2014-03-02 11:25:47 +01:00
}
2013-11-09 17:24:03 +01:00
}
2014-08-11 19:51:46 +02:00
return $this->maniaControl->getClient()->chatSendServerMessage($chatMessage);
2013-11-09 17:24:03 +01:00
}
/**
2014-08-11 19:51:46 +02:00
* Build the chat message prefix
2013-11-09 17:24:03 +01:00
*
2014-08-11 19:51:46 +02:00
* @param string|bool $prefixParam
* @param string|array $login
2014-05-02 17:40:47 +02:00
* @return string
2013-11-09 17:24:03 +01:00
*/
2014-08-11 19:51:46 +02:00
private function buildPrefix($prefixParam, $login = null) {
if (is_string($prefixParam)) {
return $prefixParam;
2014-05-02 17:40:47 +02:00
}
2014-08-11 19:51:46 +02:00
if ($prefixParam === true) {
$prefix = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_PREFIX);
if ($login) {
// Private - Doubled default prefix
$prefix .= $prefix;
// TODO: validate whether to use specific private & public prefixes instead of just doubling a default one
}
return $prefix;
2014-05-02 17:40:47 +02:00
}
return '';
2013-11-09 17:24:03 +01:00
}
/**
* Send an Error Message to all Connected Admins
*
* @param string $message
* @param int $minLevel
* @param bool $prefix
*/
public function sendErrorToAdmins($message, $minLevel = AuthenticationManager::AUTH_LEVEL_MODERATOR, $prefix = true) {
2014-08-11 19:24:21 +02:00
$format = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_FORMAT_ERROR);
$this->sendMessageToAdmins($format . $message, $minLevel, $prefix);
}
/**
2014-07-25 15:16:41 +02:00
* Send a Message to all connected Admins
*
* @param string $message
* @param int $minLevel
* @param bool|string $prefix
2014-07-25 15:16:41 +02:00
* @return bool
*/
public function sendMessageToAdmins($message, $minLevel = AuthenticationManager::AUTH_LEVEL_MODERATOR, $prefix = true) {
2014-08-11 19:24:21 +02:00
$admins = $this->maniaControl->getAuthenticationManager()->getConnectedAdmins($minLevel);
2014-07-25 15:16:41 +02:00
return $this->sendChat($message, $admins, $prefix);
}
2013-11-09 17:24:03 +01:00
/**
* Send a success message to the given login
*
2014-01-16 18:08:32 +01:00
* @param string $message
* @param string $login
* @param bool|string $prefix
* @return bool
2013-11-09 17:24:03 +01:00
*/
public function sendSuccess($message, $login = null, $prefix = true) {
2014-08-11 19:24:21 +02:00
$format = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_FORMAT_SUCCESS);
2014-05-02 18:21:38 +02:00
return $this->sendChat($format . $message, $login, $prefix);
2013-11-09 17:24:03 +01:00
}
2014-08-23 12:59:08 +02:00
/**
* Sends a Information Message to all connected Admins
*
* @param string $message
* @param int $minLevel
* @param bool|string $prefix
* @return bool
*/
public function sendInformationToAdmins($message, $minLevel = AuthenticationManager::AUTH_LEVEL_MODERATOR, $prefix = true) {
$format = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_FORMAT_INFORMATION);
return $this->sendMessageToAdmins($format . $message, $minLevel, $prefix);
}
2014-07-25 15:16:41 +02:00
/**
* Sends a Success Message to all connected Admins
*
* @param string $message
* @param int $minLevel
* @param bool|string $prefix
* @return bool
*/
public function sendSuccessToAdmins($message, $minLevel = AuthenticationManager::AUTH_LEVEL_MODERATOR, $prefix = true) {
2014-08-11 19:24:21 +02:00
$format = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_FORMAT_SUCCESS);
2014-07-25 15:16:41 +02:00
return $this->sendMessageToAdmins($format . $message, $minLevel, $prefix);
}
2014-05-02 17:40:47 +02:00
/**
* Send the Exception Information to the Chat
*
* @param \Exception $exception
* @param string $login
* @return bool
*/
public function sendException(\Exception $exception, $login = null) {
$message = "Exception occurred: '{$exception->getMessage()}' ({$exception->getCode()})";
return $this->sendError($message, $login);
}
2013-11-09 17:24:03 +01:00
/**
2014-04-14 13:17:00 +02:00
* Send an Error Message to the Chat
2013-11-09 17:24:03 +01:00
*
2014-01-16 18:08:32 +01:00
* @param string $message
* @param string $login
* @param string|bool $prefix
* @return bool
2013-11-09 17:24:03 +01:00
*/
public function sendError($message, $login = null, $prefix = true) {
2014-08-11 19:24:21 +02:00
$format = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_FORMAT_ERROR);
2014-05-02 18:21:38 +02:00
return $this->sendChat($format . $message, $login, $prefix);
2013-11-09 17:24:03 +01:00
}
/**
* Send a Exception Message to all Connected Admins
*
* @param \Exception $exception
* @param int $minLevel
* @param bool|string $prefix
*/
2014-08-25 15:33:22 +02:00
public function sendExceptionToAdmins(\Exception $exception, $minLevel = AuthenticationManager::AUTH_LEVEL_MODERATOR, $prefix = true) {
2014-08-11 19:24:21 +02:00
$format = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_FORMAT_ERROR);
$message = $format . "Exception: '{$exception->getMessage()}' ({$exception->getCode()})";
$this->sendMessageToAdmins($message, $minLevel, $prefix);
}
/**
* Send an usage info message to the given login
*
2014-01-16 18:08:32 +01:00
* @param string $message
* @param string $login
* @param string|bool $prefix
* @return bool
*/
public function sendUsageInfo($message, $login = null, $prefix = false) {
2014-08-11 19:24:21 +02:00
$format = $this->maniaControl->getSettingManager()->getSettingValue($this, self::SETTING_FORMAT_USAGEINFO);
2014-05-02 18:21:38 +02:00
return $this->sendChat($format . $message, $login, $prefix);
}
2015-06-21 22:24:10 +02:00
/**
* Stores the ChatMessage in the Buffer
*
* @param $data
*/
public function onPlayerChat($data) {
$login = $data[1][1];
$player = $this->maniaControl->getPlayerManager()->getPlayer($login);
$nickname = "";
if ($player) {
$nickname = $player->nickname;
}
array_push($this->chatBuffer, array("user" => $login, "nickname" => $nickname, "message" => $data[1][2]));
if (count($this->chatBuffer) > self::CHAT_BUFFER_SIZE) {
array_shift($this->chatBuffer);
}
}
2013-11-09 17:24:03 +01:00
}