TrackManiaControl/application/core/Chat.php

158 lines
4.5 KiB
PHP
Raw Normal View History

2013-11-09 17:24:03 +01:00
<?php
namespace ManiaControl;
2014-03-02 11:25:47 +01:00
use Maniaplanet\DedicatedServer\Xmlrpc\Exception;
2014-04-14 13:17:00 +02:00
use ManiaControl\Players\Player;
2014-04-19 23:14:37 +02:00
use Maniaplanet\DedicatedServer\Xmlrpc\LoginUnknownException;
2013-11-09 17:24:03 +01:00
/**
* Chat Utility Class
2013-11-09 17:24:03 +01:00
*
* @author steeffeen & kremsy
* @copyright ManiaControl Copyright © 2014 ManiaControl Team
* @license http://www.gnu.org/licenses/ GNU General Public License, Version 3
2013-11-09 17:24:03 +01:00
*/
class Chat {
/*
* 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';
/*
* Private Properties
2013-11-09 17:24:03 +01:00
*/
private $maniaControl = null;
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
// Init settings
2013-12-08 22:38:20 +01:00
$this->maniaControl->settingManager->initSetting($this, self::SETTING_PREFIX, '» ');
$this->maniaControl->settingManager->initSetting($this, self::SETTING_FORMAT_INFORMATION, '$fff');
$this->maniaControl->settingManager->initSetting($this, self::SETTING_FORMAT_SUCCESS, '$0f0');
$this->maniaControl->settingManager->initSetting($this, self::SETTING_FORMAT_ERROR, '$f00');
$this->maniaControl->settingManager->initSetting($this, self::SETTING_FORMAT_USAGEINFO, '$f80');
}
2013-11-09 17:24:03 +01:00
/**
* Get prefix
*
2014-01-16 18:08:32 +01:00
* @param string|bool $prefix
* @return string
2013-11-09 17:24:03 +01:00
*/
2014-04-14 13:17:00 +02:00
private function getPrefix($prefix) {
2014-01-31 17:08:20 +01:00
if (is_string($prefix)) {
return $prefix;
}
2014-01-31 17:08:20 +01:00
if ($prefix === true) {
return $this->maniaControl->settingManager->getSetting($this, self::SETTING_PREFIX);
}
return '';
2013-11-09 17:24:03 +01:00
}
2014-04-14 13:17:00 +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) {
2014-01-31 17:08:20 +01:00
if (!$this->maniaControl->client) {
return false;
2013-11-09 17:24:03 +01:00
}
2014-04-14 13:17:00 +02:00
if (!$login) {
$prefix = $this->getPrefix($prefix);
2014-04-30 16:57:49 +02:00
$chatMessage = '$<$z$ff0' . str_replace(' ', '', $prefix) . $prefix . $message . '$>';
2014-03-01 11:11:50 +01:00
$this->maniaControl->client->chatSendServerMessage($chatMessage);
} else {
2014-04-30 16:57:49 +02:00
$chatMessage = '$<$z$ff0' . $this->getPrefix($prefix) . $message . '$>';
2014-05-02 04:02:08 +02:00
if (is_object($login) && property_exists($login, 'login')) {
2014-04-14 13:17:00 +02:00
$login = $login->login;
}
2014-03-02 11:25:47 +01:00
try{
2014-04-14 13:17:00 +02:00
$this->maniaControl->client->chatSendServerMessage($chatMessage, $login);
2014-04-19 23:14:37 +02:00
} catch(LoginUnknownException $e){
2014-03-02 11:25:47 +01:00
}
2013-11-09 17:24:03 +01:00
}
2014-01-31 17:08:20 +01:00
return true;
2013-11-09 17:24:03 +01:00
}
/**
* Send an information 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 sendInformation($message, $login = null, $prefix = true) {
$format = $this->maniaControl->settingManager->getSetting($this, self::SETTING_FORMAT_INFORMATION);
2013-11-09 17:24:03 +01:00
return $this->sendChat($format . $message, $login);
}
/**
* Send a success 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 sendSuccess($message, $login = null, $prefix = true) {
$format = $this->maniaControl->settingManager->getSetting($this, self::SETTING_FORMAT_SUCCESS);
2013-11-09 17:24:03 +01:00
return $this->sendChat($format . $message, $login);
}
/**
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) {
$format = $this->maniaControl->settingManager->getSetting($this, self::SETTING_FORMAT_ERROR);
2013-11-09 17:24:03 +01:00
return $this->sendChat($format . $message, $login);
}
2014-04-14 13:17:00 +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 occured: '{$exception->getMessage()}' ({$exception->getCode()})";
2014-04-14 19:04:02 +02:00
$this->maniaControl->errorHandler->triggerDebugNotice($message);
2014-04-14 13:17:00 +02:00
$this->sendError($message, $login);
}
/**
* 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) {
$format = $this->maniaControl->settingManager->getSetting($this, self::SETTING_FORMAT_USAGEINFO);
return $this->sendChat($format . $message, $login);
}
2013-11-09 17:24:03 +01:00
}