TeamSpeak3_Viewer_Html Class Reference

Renders nodes used in HTML-based TeamSpeak 3 viewers. More...

Inheritance diagram for TeamSpeak3_Viewer_Html:

Public Member Functions
	__construct ($iconpath="images/viewer/", $flagpath=null, $ftclient=null, $pattern=null)
	The TeamSpeak3_Viewer_Html constructor. More...
	fetchObject (TeamSpeak3_Node_Abstract $node, array $siblings=array())
	Returns the code needed to display a node in a TeamSpeak 3 viewer. More...
Public Member Functions inherited from TeamSpeak3_Viewer_Interface
	fetchObject (TeamSpeak3_Node_Abstract $node, array $siblings=array())
	Returns the code needed to display a node in a TeamSpeak 3 viewer. More...

Protected Member Functions
	getContainerClass ()
	Returns a dynamic string for the current container element which can be used as a HTML class property. More...
	getContainerIdent ()
	Returns a unique identifier for the current node which can be used as a HTML id property. More...
	getContainerSummary ()
	Returns the ID of the current node which will be used as a summary element for the container element. More...
	getCorpusClass ()
	Returns a string for the current corpus element which can be used as a HTML class property. More...
	getCorpusIcon ()
	Returns a HTML img tag which can be used to display the status icon for a TeamSpeak_Node_Abstract object. More...
	getCorpusName ()
	Returns a string for the current corpus element which contains the display name for the current TeamSpeak_Node_Abstract object. More...
	getCorpusTitle ()
	Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Abstract object. More...
	getImage ($name, $text="", $class=null, $iconpath=TRUE, $flagpath=FALSE)
	Returns the code to display a custom HTML img tag. More...
	getPrefix ()
	Returns the HTML img tags to display the prefix of the current node. More...
	getPrefixClass ()
	Returns a string for the current prefix element which can be used as a HTML class property. More...
	getRowClass ()
	Returns a dynamic string for the current row element which can be used as a HTML class property. More...
	getSuffixClass ()
	Returns a string for the current suffix element which can be used as a HTML class property. More...
	getSuffixFlag ()
	Returns a HTML img tag which can be used to display the country flag for a TeamSpeak_Node_Client object. More...
	getSuffixIcon ()
	Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Abstract object. More...
	getSuffixIconChannel ()
	Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Channel object. More...
	getSuffixIconClient ()
	Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Client object. More...
	getSuffixIconServer ()
	Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Server object. More...

Detailed Description

Renders nodes used in HTML-based TeamSpeak 3 viewers.

Constructor & Destructor Documentation

__construct()

__construct	(		$iconpath = "images/viewer/",
			$flagpath = null,
			$ftclient = null,
			$pattern = null
	)

The TeamSpeak3_Viewer_Html constructor.

Parameters

string	$iconpath
string	$flagpath
string	$ftclient
string	$pattern

Returns

void

 {
 $this->iconpath = $iconpath;
 $this->flagpath = $flagpath;
 $this->ftclient = $ftclient;

 if($pattern)
 {
 $this->pattern = $pattern;
 }
 }

Member Function Documentation

fetchObject()

fetchObject	(	TeamSpeak3_Node_Abstract	$node,
		array	$siblings = array()
	)

Returns the code needed to display a node in a TeamSpeak 3 viewer.

Parameters

TeamSpeak3_Node_Abstract	$node
array	$siblings

Returns

string

 {
 $this->currObj = $node;
 $this->currSib = $siblings;

 $args = array(
 $this->getContainerIdent(),
 $this->getContainerClass(),
 $this->getContainerSummary(),
 $this->getRowClass(),
 $this->getPrefixClass(),
 $this->getPrefix(),
 $this->getCorpusClass(),
 $this->getCorpusTitle(),
 $this->getCorpusIcon(),
 $this->getCorpusName(),
 $this->getSuffixClass(),
 $this->getSuffixIcon(),
 $this->getSuffixFlag(),
 );

 return TeamSpeak3_Helper_String::factory($this->pattern)->arg($args);
 }

getContainerClass()

getContainerClass ( )

protected

Returns a dynamic string for the current container element which can be used as a HTML class property.

Returns

string

 {
 return "ts3_viewer " . $this->currObj->getClass(null);
 }

getContainerIdent()

getContainerIdent ( )

protected

Returns a unique identifier for the current node which can be used as a HTML id property.

Returns

string

 {
 return $this->currObj->getUniqueId();
 }

getContainerSummary()

getContainerSummary ( )

protected

Returns the ID of the current node which will be used as a summary element for the container element.

Returns

integer

 {
 return $this->currObj->getId();
 }

getCorpusClass()

getCorpusClass ( )

protected

Returns a string for the current corpus element which can be used as a HTML class property.

If the current node is a channel spacer the class string will contain additional class names to allow further customization of the content via CSS.

Returns

string

 {
 $extras = "";

 if($this->currObj instanceof TeamSpeak3_Node_Channel && $this->currObj->isSpacer())
 {
 switch($this->currObj->spacerGetType())
 {
 case (string) TeamSpeak3::SPACER_SOLIDLINE:
 $extras .= " solidline";
 break;

 case (string) TeamSpeak3::SPACER_DASHLINE:
 $extras .= " dashline";
 break;

 case (string) TeamSpeak3::SPACER_DASHDOTLINE:
 $extras .= " dashdotline";
 break;

 case (string) TeamSpeak3::SPACER_DASHDOTDOTLINE:
 $extras .= " dashdotdotline";
 break;

 case (string) TeamSpeak3::SPACER_DOTLINE:
 $extras .= " dotline";
 break;
 }

 switch($this->currObj->spacerGetAlign())
 {
 case TeamSpeak3::SPACER_ALIGN_CENTER:
 $extras .= " center";
 break;

 case TeamSpeak3::SPACER_ALIGN_RIGHT:
 $extras .= " right";
 break;

 case TeamSpeak3::SPACER_ALIGN_LEFT:
 $extras .= " left";
 break;
 }
 }

 return "corpus " . $this->currObj->getClass(null) . $extras;
 }

getCorpusIcon()

getCorpusIcon ( )

protected

Returns a HTML img tag which can be used to display the status icon for a TeamSpeak_Node_Abstract object.

Returns

string

 {
 if($this->currObj instanceof TeamSpeak3_Node_Channel && $this->currObj->isSpacer()) return;

 return $this->getImage($this->currObj->getIcon() . ".png");
 }

getCorpusName()

getCorpusName ( )

protected

Returns a string for the current corpus element which contains the display name for the current TeamSpeak_Node_Abstract object.

Returns

string

 {
 if($this->currObj instanceof TeamSpeak3_Node_Channel && $this->currObj->isSpacer())
 {
 if($this->currObj->spacerGetType() != TeamSpeak3::SPACER_CUSTOM) return;

 $string = $this->currObj["channel_name"]->section("]", 1, 99);

 if($this->currObj->spacerGetAlign() == TeamSpeak3::SPACER_ALIGN_REPEAT)
 {
 $string->resize(30, $string);
 }

 return htmlspecialchars($string);
 }

 if($this->currObj instanceof TeamSpeak3_Node_Client)
 {
 $before = array();
 $behind = array();

 foreach($this->currObj->memberOf() as $group)
 {
 if($group->getProperty("namemode") == TeamSpeak3::GROUP_NAMEMODE_BEFORE)
 {
 $before[] = "[" . htmlspecialchars($group["name"]) . "]";
 }
 elseif($group->getProperty("namemode") == TeamSpeak3::GROUP_NAMEMODE_BEHIND)
 {
 $behind[] = "[" . htmlspecialchars($group["name"]) . "]";
 }
 }

 return implode("", $before) . " " . htmlspecialchars($this->currObj) . " " . implode("", $behind);
 }

 return htmlspecialchars($this->currObj);
 }

getCorpusTitle()

getCorpusTitle ( )

protected

Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Abstract object.

Returns

string

 {
 if($this->currObj instanceof TeamSpeak3_Node_Server)
 {
 return "ID: " . $this->currObj->getId() . " | Clients: " . $this->currObj->clientCount() . "/" . $this->currObj["virtualserver_maxclients"] . " | Uptime: " . TeamSpeak3_Helper_Convert::seconds($this->currObj["virtualserver_uptime"]);
 }
 elseif($this->currObj instanceof TeamSpeak3_Node_Channel && !$this->currObj->isSpacer())
 {
 return "ID: " . $this->currObj->getId() . " | Codec: " . TeamSpeak3_Helper_Convert::codec($this->currObj["channel_codec"]) . " | Quality: " . $this->currObj["channel_codec_quality"];
 }
 elseif($this->currObj instanceof TeamSpeak3_Node_Client)
 {
 return "ID: " . $this->currObj->getId() . " | Version: " . TeamSpeak3_Helper_Convert::versionShort($this->currObj["client_version"]) . " | Platform: " . $this->currObj["client_platform"];
 }
 elseif($this->currObj instanceof TeamSpeak3_Node_Servergroup || $this->currObj instanceof TeamSpeak3_Node_Channelgroup)
 {
 return "ID: " . $this->currObj->getId() . " | Type: " . TeamSpeak3_Helper_Convert::groupType($this->currObj["type"]) . " (" . ($this->currObj["savedb"] ? "Permanent" : "Temporary") . ")";
 }
 }

getImage()

getImage (   $name,   $text = "",   $class = null,   $iconpath = TRUE,   $flagpath = FALSE  )

protected

Returns the code to display a custom HTML img tag.

Parameters

string	$name
string	$text
string	$class
boolean	$iconpath
boolean	$flagpath

Returns

string

 {
 $src = "";

 if($iconpath)
 {
 $src = $this->iconpath;
 }

 if($flagpath)
 {
 $src = $this->flagpath;
 }

 return "<img src='" . $src . $name . "' title='" . $text . "' alt='' align='top' />";
 }

getPrefix()

getPrefix ( )

protected

Returns the HTML img tags to display the prefix of the current node.

Returns

string

 {
 $prefix = "";

 if(count($this->currSib))
 {
 $last = array_pop($this->currSib);

 foreach($this->currSib as $sibling)
 {
 $prefix .= ($sibling) ? $this->getImage("tree_line.gif") : $this->getImage("tree_blank.png");
 }

 $prefix .= ($last) ? $this->getImage("tree_end.gif") : $this->getImage("tree_mid.gif");
 }

 return $prefix;
 }

getPrefixClass()

getPrefixClass ( )

protected

Returns a string for the current prefix element which can be used as a HTML class property.

Returns

string

 {
 return "prefix " . $this->currObj->getClass(null);
 }

getRowClass()

getRowClass ( )

protected

Returns a dynamic string for the current row element which can be used as a HTML class property.

Returns

string

 {
 return ++$this->currNum%2 ? "row1" : "row2";
 }

getSuffixClass()

getSuffixClass ( )

protected

Returns a string for the current suffix element which can be used as a HTML class property.

Returns

string

 {
 return "suffix " . $this->currObj->getClass(null);
 }

getSuffixFlag()

getSuffixFlag ( )

protected

Returns a HTML img tag which can be used to display the country flag for a TeamSpeak_Node_Client object.

Returns

string

 {
 if(!$this->currObj instanceof TeamSpeak3_Node_Client) return;

 if($this->flagpath && $this->currObj["client_country"])
 {
 return $this->getImage($this->currObj["client_country"]->toLower() . ".png", $this->currObj["client_country"], null, FALSE, TRUE);
 }
 }

getSuffixIcon()

getSuffixIcon ( )

protected

Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Abstract object.

Returns

string

 {
 if($this->currObj instanceof TeamSpeak3_Node_Server)
 {
 return $this->getSuffixIconServer();
 }
 elseif($this->currObj instanceof TeamSpeak3_Node_Channel)
 {
 return $this->getSuffixIconChannel();
 }
 elseif($this->currObj instanceof TeamSpeak3_Node_Client)
 {
 return $this->getSuffixIconClient();
 }
 }

getSuffixIconChannel()

getSuffixIconChannel ( )

protected

Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Channel object.

Returns

string

 {
 if($this->currObj instanceof TeamSpeak3_Node_Channel && $this->currObj->isSpacer()) return;

 $html = "";

 if($this->currObj["channel_flag_default"])
 {
 $html .= $this->getImage("channel_flag_default.png", "Default Channel");
 }

 if($this->currObj["channel_flag_password"])
 {
 $html .= $this->getImage("channel_flag_password.png", "Password-protected");
 }

 if($this->currObj["channel_codec"] == TeamSpeak3::CODEC_CELT_MONO || $this->currObj["channel_codec"] == TeamSpeak3::CODEC_OPUS_MUSIC)
 {
 $html .= $this->getImage("channel_flag_music.png", "Music Codec");
 }

 if($this->currObj["channel_needed_talk_power"])
 {
 $html .= $this->getImage("channel_flag_moderated.png", "Moderated");
 }

 if($this->currObj["channel_icon_id"])
 {
 if(!$this->currObj->iconIsLocal("channel_icon_id") && $this->ftclient)
 {
 if(!isset($this->cacheIcon[$this->currObj["channel_icon_id"]]))
 {
 $download = $this->currObj->getParent()->transferInitDownload(rand(0x0000, 0xFFFF), 0, $this->currObj->iconGetName("channel_icon_id"));

 if($this->ftclient == "data:image")
 {
 $download = TeamSpeak3::factory("filetransfer://" . (strstr($download["host"], ":") !== FALSE ? "[" . $download["host"] . "]" : $download["host"]) . ":" . $download["port"])->download($download["ftkey"], $download["size"]);
 }

 $this->cacheIcon[$this->currObj["channel_icon_id"]] = $download;
 }
 else
 {
 $download = $this->cacheIcon[$this->currObj["channel_icon_id"]];
 }

 if($this->ftclient == "data:image")
 {
 $html .= $this->getImage("data:" . TeamSpeak3_Helper_Convert::imageMimeType($download) . ";base64," . base64_encode($download), "Channel Icon", null, FALSE);
 }
 else
 {
 $html .= $this->getImage($this->ftclient . "?ftdata=" . base64_encode(serialize($download)), "Channel Icon", null, FALSE);
 }
 }
 elseif(in_array($this->currObj["channel_icon_id"], $this->cachedIcons))
 {
 $html .= $this->getImage("group_icon_" . $this->currObj["channel_icon_id"] . ".png", "Channel Icon");
 }
 }

 return $html;
 }

getSuffixIconClient()

getSuffixIconClient ( )

protected

Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Client object.

Returns

string

 {
 $html = "";

 if($this->currObj["client_is_priority_speaker"])
 {
 $html .= $this->getImage("client_priority.png", "Priority Speaker");
 }

 if($this->currObj["client_is_channel_commander"])
 {
 $html .= $this->getImage("client_cc.png", "Channel Commander");
 }

 if($this->currObj["client_is_talker"])
 {
 $html .= $this->getImage("client_talker.png", "Talk Power granted");
 }
 elseif($cntp = $this->currObj->getParent()->channelGetById($this->currObj["cid"])->channel_needed_talk_power)
 {
 if($cntp > $this->currObj["client_talk_power"])
 {
 $html .= $this->getImage("client_mic_muted.png", "Insufficient Talk Power");
 }
 }

 // Get current groups the client is a member of.
 // Shift off first group (channel group), leaving only server groups.
 $groups = $this->currObj->memberOf();
 $clientGroups = [$groups[0]];
 unset($groups[0]);

 // Create temp assoc array to use in custom uasort function.
 $sgroups = [];
 foreach($groups as $group) {
 $sgroups[$group['sgid']] = $group;
 }
 // Use same server group sort function from TeamSpeak3_Node_Server class.
 uasort($sgroups, array(get_class($this->currObj->getParent()), "sortGroupList"));

 // Append first group (channel group), convert to non-assoc array.
 $clientGroups = array_merge($clientGroups, array_values($sgroups));
 unset($sgroups); // Clean-up temp sorting array.

 foreach($clientGroups as $group)
 {
 if(!$group["iconid"]) continue;

 $type = ($group instanceof TeamSpeak3_Node_Servergroup) ? "Server Group" : "Channel Group";

 if(!$group->iconIsLocal("iconid") && $this->ftclient)
 {
 if(!isset($this->cacheIcon[$group["iconid"]]))
 {
 $download = $group->getParent()->transferInitDownload(rand(0x0000, 0xFFFF), 0, $group->iconGetName("iconid"));

 if($this->ftclient == "data:image")
 {
 $download = TeamSpeak3::factory("filetransfer://" . (strstr($download["host"], ":") !== FALSE ? "[" . $download["host"] . "]" : $download["host"]) . ":" . $download["port"])->download($download["ftkey"], $download["size"]);
 }

 $this->cacheIcon[$group["iconid"]] = $download;
 }
 else
 {
 $download = $this->cacheIcon[$group["iconid"]];
 }

 if($this->ftclient == "data:image")
 {
 $html .= $this->getImage("data:" . TeamSpeak3_Helper_Convert::imageMimeType($download) . ";base64," . base64_encode($download), $group . " [" . $type . "]", null, FALSE);
 }
 else
 {
 $html .= $this->getImage($this->ftclient . "?ftdata=" . base64_encode(serialize($download)), $group . " [" . $type . "]", null, FALSE);
 }
 }
 elseif(in_array($group["iconid"], $this->cachedIcons))
 {
 $html .= $this->getImage("group_icon_" . $group["iconid"] . ".png", $group . " [" . $type . "]");
 }
 }

 if($this->currObj["client_icon_id"])
 {
 if(!$this->currObj->iconIsLocal("client_icon_id") && $this->ftclient)
 {
 if(!isset($this->cacheIcon[$this->currObj["client_icon_id"]]))
 {
 $download = $this->currObj->getParent()->transferInitDownload(rand(0x0000, 0xFFFF), 0, $this->currObj->iconGetName("client_icon_id"));

 if($this->ftclient == "data:image")
 {
 $download = TeamSpeak3::factory("filetransfer://" . (strstr($download["host"], ":") !== FALSE ? "[" . $download["host"] . "]" : $download["host"]) . ":" . $download["port"])->download($download["ftkey"], $download["size"]);
 }

 $this->cacheIcon[$this->currObj["client_icon_id"]] = $download;
 }
 else
 {
 $download = $this->cacheIcon[$this->currObj["client_icon_id"]];
 }

 if($this->ftclient == "data:image")
 {
 $html .= $this->getImage("data:" . TeamSpeak3_Helper_Convert::imageMimeType($download) . ";base64," . base64_encode($download), "Client Icon", null, FALSE);
 }
 else
 {
 $html .= $this->getImage($this->ftclient . "?ftdata=" . base64_encode(serialize($download)), "Client Icon", null, FALSE);
 }
 }
 elseif(in_array($this->currObj["client_icon_id"], $this->cachedIcons))
 {
 $html .= $this->getImage("group_icon_" . $this->currObj["client_icon_id"] . ".png", "Client Icon");
 }
 }

 return $html;
 }

getSuffixIconServer()

getSuffixIconServer ( )

protected

Returns the HTML img tags which can be used to display the various icons for a TeamSpeak_Node_Server object.

Returns

string

 {
 $html = "";

 if($this->currObj["virtualserver_icon_id"])
 {
 if(!$this->currObj->iconIsLocal("virtualserver_icon_id") && $this->ftclient)
 {
 if(!isset($this->cacheIcon[$this->currObj["virtualserver_icon_id"]]))
 {
 $download = $this->currObj->transferInitDownload(rand(0x0000, 0xFFFF), 0, $this->currObj->iconGetName("virtualserver_icon_id"));

 if($this->ftclient == "data:image")
 {
 $download = TeamSpeak3::factory("filetransfer://" . (strstr($download["host"], ":") !== FALSE ? "[" . $download["host"] . "]" : $download["host"]) . ":" . $download["port"])->download($download["ftkey"], $download["size"]);
 }

 $this->cacheIcon[$this->currObj["virtualserver_icon_id"]] = $download;
 }
 else
 {
 $download = $this->cacheIcon[$this->currObj["virtualserver_icon_id"]];
 }

 if($this->ftclient == "data:image")
 {
 $html .= $this->getImage("data:" . TeamSpeak3_Helper_Convert::imageMimeType($download) . ";base64," . base64_encode($download), "Server Icon", null, FALSE);
 }
 else
 {
 $html .= $this->getImage($this->ftclient . "?ftdata=" . base64_encode(serialize($download)), "Server Icon", null, FALSE);
 }
 }
 elseif(in_array($this->currObj["virtualserver_icon_id"], $this->cachedIcons))
 {
 $html .= $this->getImage("group_icon_" . $this->currObj["virtualserver_icon_id"] . ".png", "Server Icon");
 }
 }

 return $html;
 }

---

The documentation for this class was generated from the following file:

• /Volumes/home/Repositories/planetteamspeak/ts3phpframework/libraries/TeamSpeak3/Viewer/Html.php