TrackManiaControl/application/core/Manialinks/ManialinkManager.php

268 lines
8.1 KiB
PHP
Raw Normal View History

<?php
namespace ManiaControl\Manialinks;
2013-12-30 14:52:48 +01:00
use FML\Controls\Control;
use FML\Controls\Frame;
use FML\Controls\Labels\Label_Text;
2013-12-31 17:11:53 +01:00
use FML\ManiaLink;
use ManiaControl\Callbacks\CallbackListener;
use ManiaControl\Callbacks\CallbackManager;
use ManiaControl\ManiaControl;
use ManiaControl\Players\Player;
use Maniaplanet\DedicatedServer\Xmlrpc\Exception;
/**
* Manialink manager class
*
* @author steeffeen & kremsy
*/
2013-12-30 14:52:48 +01:00
class ManialinkManager implements ManialinkPageAnswerListener, CallbackListener {
2013-12-31 17:11:53 +01:00
2013-12-30 14:52:48 +01:00
/**
2013-12-24 12:49:53 +01:00
* Constants
*/
2013-12-31 17:11:53 +01:00
const MAIN_MLID = 'Main.ManiaLinkId';
const ACTION_CLOSEWIDGET = 'ManiaLinkManager.CloseWidget';
2013-12-30 14:52:48 +01:00
const CB_MAIN_WINDOW_CLOSED = 'ManialinkManagerCallback.MainWindowClosed';
const CB_MAIN_WINDOW_OPENED = 'ManialinkManagerCallback.MainWindowOpened';
2013-12-31 17:11:53 +01:00
/**
* Public properties
*/
public $styleManager = null;
2013-12-30 14:52:48 +01:00
public $customUIManager = null;
2013-12-31 17:09:29 +01:00
public $iconManager = null;
/**
* Private properties
*/
private $maniaControl = null;
private $pageAnswerListeners = array();
/**
* Create a new manialink manager
*
2013-12-31 12:17:25 +01:00
* @param ManiaControl $maniaControl
*/
public function __construct(ManiaControl $maniaControl) {
2013-12-31 17:11:53 +01:00
$this->maniaControl = $maniaControl;
$this->styleManager = new StyleManager($maniaControl);
2013-12-30 14:52:48 +01:00
$this->customUIManager = new CustomUIManager($maniaControl);
2013-12-31 17:11:53 +01:00
$this->iconManager = new IconManager($maniaControl);
2013-12-31 17:09:29 +01:00
// Register for callbacks
2013-12-30 14:52:48 +01:00
$this->registerManialinkPageAnswerListener(self::ACTION_CLOSEWIDGET, $this, 'closeWidgetCallback');
2013-12-31 17:11:53 +01:00
$this->maniaControl->callbackManager->registerCallbackListener(CallbackManager::CB_MP_PLAYERMANIALINKPAGEANSWER, $this, 'handleManialinkPageAnswer');
}
/**
* Register a new manialink page answer listener
*
2013-12-31 17:11:53 +01:00
* @param string $actionId
2013-12-31 12:17:25 +01:00
* @param ManialinkPageAnswerListener $listener
2013-12-31 17:11:53 +01:00
* @param string $method
* @return bool
*/
public function registerManialinkPageAnswerListener($actionId, ManialinkPageAnswerListener $listener, $method) {
2014-01-28 15:56:50 +01:00
if (!method_exists($listener, $method)) {
trigger_error("Given listener for actionId '{$actionId}' doesn't have callback method '{$method}'!");
2013-12-31 17:11:53 +01:00
return false;
}
2014-01-28 15:56:50 +01:00
if (!array_key_exists($actionId, $this->pageAnswerListeners) || !is_array($this->pageAnswerListeners[$actionId])) {
// Init listeners array
$this->pageAnswerListeners[$actionId] = array();
}
// Register page answer listener
array_push($this->pageAnswerListeners[$actionId], array($listener, $method));
2013-12-31 17:11:53 +01:00
return true;
}
2013-12-14 23:27:15 +01:00
/**
* Remove a Manialink Page Answer Listener
2013-12-30 14:52:48 +01:00
*
2013-12-31 12:17:25 +01:00
* @param ManialinkPageAnswerListener $listener
2013-12-14 23:27:15 +01:00
* @return bool
*/
public function unregisterManialinkPageAnswerListener(ManialinkPageAnswerListener $listener) {
$removed = false;
foreach($this->pageAnswerListeners as &$listeners) {
foreach($listeners as $key => &$listenerCallback) {
2014-01-28 15:56:50 +01:00
if ($listenerCallback[0] != $listener) {
continue;
}
unset($listeners[$key]);
$removed = true;
}
2013-12-14 23:27:15 +01:00
}
return $removed;
}
/**
* Handle ManialinkPageAnswer callback
*
2013-12-31 12:17:25 +01:00
* @param array $callback
*/
public function handleManialinkPageAnswer(array $callback) {
$actionId = $callback[1][2];
2013-12-31 17:11:53 +01:00
$login = $callback[1][1];
$player = $this->maniaControl->playerManager->getPlayer($login);
2014-01-28 15:56:50 +01:00
if (!array_key_exists($actionId, $this->pageAnswerListeners) || !is_array($this->pageAnswerListeners[$actionId])) {
// No page answer listener registered
return;
}
// Inform page answer listeners
2014-01-03 16:24:35 +01:00
foreach($this->pageAnswerListeners[$actionId] as $listener) {
call_user_func(array($listener[0], $listener[1]), $callback, $player);
}
}
/**
* Send the given manialink to players
*
2013-12-31 12:17:25 +01:00
* @param string $manialinkText
2013-12-31 17:11:53 +01:00
* @param mixed $logins
* @param int $timeout
* @param bool $hideOnClick
* @return bool
*/
2014-01-28 16:05:18 +01:00
public function sendManialink($manialinkText, $logins = null, $timeout = 0, $hideOnClick = false) {
$manialinkText = (string)$manialinkText;
2014-01-17 22:35:14 +01:00
try {
2014-01-28 15:56:50 +01:00
if (!$logins) {
2014-01-17 22:35:14 +01:00
return $this->maniaControl->client->sendDisplayManialinkPage(null, $manialinkText, $timeout, $hideOnClick);
}
2014-01-28 15:56:50 +01:00
if (is_string($logins)) {
2014-01-17 22:35:14 +01:00
return $this->maniaControl->client->sendDisplayManialinkPage($logins, $manialinkText, $timeout, $hideOnClick);
}
2014-01-28 15:56:50 +01:00
if (is_array($logins)) {
2014-01-17 22:35:14 +01:00
$success = true;
foreach($logins as $login) {
$subSuccess = $this->maniaControl->client->sendDisplayManialinkPage($login, $manialinkText, $timeout, $hideOnClick);
2014-01-28 15:56:50 +01:00
if (!$subSuccess) {
2014-01-17 22:35:14 +01:00
$success = false;
}
}
2013-12-31 17:11:53 +01:00
2014-01-17 22:35:14 +01:00
return $success;
}
} catch(Exception $e) {
// TODO: only possible valid exception should be "wrong login" - throw others (like connection error)
2014-01-17 22:35:14 +01:00
return false;
}
2013-12-31 17:11:53 +01:00
2014-01-17 22:35:14 +01:00
return true;
}
/**
* Enable the alt menu for the player
*
2013-12-31 12:17:25 +01:00
* @param Player $player
* @return bool
*/
public function enableAltMenu(Player $player) {
2014-01-16 18:08:32 +01:00
return $this->maniaControl->client->triggerModeScriptEvent('LibXmlRpc_EnableAltMenu', $player->login);
}
/**
* Disable the alt menu for the player
*
2013-12-31 12:17:25 +01:00
* @param Player $player
* @return bool
*/
public function disableAltMenu(Player $player) {
2014-01-16 18:08:32 +01:00
return $this->maniaControl->client->triggerModeScriptEvent('LibXmlRpc_DisableAltMenu', $player->login);
}
/**
2014-01-28 20:23:47 +01:00
* Displays a ManiaLink Widget to a certain Player (Should only be used on Main Widgets)
2013-12-30 14:52:48 +01:00
*
* @param mixed $maniaLink
2013-12-31 12:17:25 +01:00
* @param Player $player
2014-01-11 17:36:46 +01:00
* @param string $widgetName
*/
public function displayWidget($maniaLink, Player $player, $widgetName = '') {
2013-12-30 14:52:48 +01:00
// render and display xml
2014-01-05 19:15:37 +01:00
$this->maniaControl->manialinkManager->sendManialink($maniaLink, $player->login);
2014-01-28 20:23:47 +01:00
if ($widgetName != '') { //TODO make check by manialinkId, getter is needed to avoid uses on non main widgets
$this->disableAltMenu($player);
// Trigger callback
$this->maniaControl->callbackManager->triggerCallback(self::CB_MAIN_WINDOW_OPENED, array(self::CB_MAIN_WINDOW_OPENED, $player, $widgetName));
}
}
2013-12-24 12:49:53 +01:00
/**
* Closes a widget via the callback
2013-12-30 14:52:48 +01:00
*
2013-12-31 17:11:53 +01:00
* @param array $callback
2013-12-31 12:17:25 +01:00
* @param Player $player
2013-12-24 12:49:53 +01:00
*/
public function closeWidgetCallback(array $callback, Player $player) {
$this->closeWidget($player);
}
/**
2014-01-16 20:58:39 +01:00
* Closes a Manialink Widget
2013-12-30 14:52:48 +01:00
*
2013-12-31 12:17:25 +01:00
* @param Player $player
2014-01-16 20:58:39 +01:00
* @param bool $widgetId
*/
2014-01-16 20:58:39 +01:00
public function closeWidget(Player $player, $widgetId = false) {
2014-01-28 15:56:50 +01:00
if (!$widgetId) {
2014-01-16 20:58:39 +01:00
$emptyManialink = new ManiaLink(self::MAIN_MLID);
$manialinkText = $emptyManialink->render()->saveXML();
$this->maniaControl->manialinkManager->sendManialink($manialinkText, $player->login);
$this->enableAltMenu($player);
// Trigger callback
$this->maniaControl->callbackManager->triggerCallback(self::CB_MAIN_WINDOW_CLOSED, array(self::CB_MAIN_WINDOW_CLOSED, $player));
} else {
$emptyManialink = new ManiaLink($widgetId);
$manialinkText = $emptyManialink->render()->saveXML();
$this->maniaControl->manialinkManager->sendManialink($manialinkText, $player->login);
}
}
2013-12-15 11:55:44 +01:00
/**
* Adds a line of labels
2013-12-30 14:52:48 +01:00
*
2013-12-31 12:17:25 +01:00
* @param Frame $frame
* @param array $labelStrings
* @param array $properties
2014-01-03 16:24:35 +01:00
* @return array Returns the labels (to add special Properties later)
2013-12-15 11:55:44 +01:00
*/
2013-12-30 14:52:48 +01:00
public function labelLine(Frame $frame, array $labelStrings, array $properties = array()) {
// define standard properties
2014-01-28 16:05:18 +01:00
$hAlign = (isset($properties['hAlign']) ? $properties['hAlign'] : Control::LEFT);
$style = (isset($properties['style']) ? $properties['style'] : Label_Text::STYLE_TextCardSmall);
$textSize = (isset($properties['textSize']) ? $properties['textSize'] : 1.5);
$textColor = (isset($properties['textColor']) ? $properties['textColor'] : 'FFF');
2013-12-31 17:11:53 +01:00
$profile = (isset($properties['profile']) ? $properties['profile'] : false);
$script = (isset($properties['script']) ? $properties['script'] : null);
2014-01-03 16:24:35 +01:00
$labels = array();
foreach($labelStrings as $text => $x) {
2013-12-15 11:55:44 +01:00
$label = new Label_Text();
$frame->add($label);
$label->setHAlign($hAlign);
$label->setX($x);
$label->setStyle($style);
$label->setTextSize($textSize);
$label->setText($text);
$label->setTextColor($textColor);
2013-12-31 17:11:53 +01:00
2014-01-28 15:56:50 +01:00
if ($profile) {
2013-12-31 12:17:25 +01:00
$script->addProfileButton($label, $profile);
}
2013-12-31 17:11:53 +01:00
2014-01-03 16:24:35 +01:00
$labels[] = $label; // add Label to the labels array
2013-12-15 11:55:44 +01:00
}
2013-12-31 17:11:53 +01:00
2014-01-03 16:24:35 +01:00
return $labels;
2013-12-15 11:55:44 +01:00
}
}