Class Turniersystem

Description

Ein Turnier

Located in /web/mod/mod.tournament.php (line 714)

SqlRowObject
   |
   --Turniersystem
Direct descendents
Class Description
TurnierAdmin Klasse zum verwalten von Turnieren
Variable Summary
mixed $Admin
mixed $currency
mixed $FirstRound
mixed $id
mixed $losersubmit
mixed $matches
mixed $maxcoins
mixed $Orga
mixed $playright
mixed $treetypes
mixed $types
mixed $xmlfile_NGL
Method Summary
Turniersystem Turniersystem ([ $id = false])
integer AddCombatant (integer $teamid, [integer $tournamentid = false])
bool addOrga (mixed $aUser)
integer ConfirmCombatant (integer $inviteid)
bool DeleteCombatant (integer $teamid)
void DeleteScore ([ $matchid = false])
array GetAsked (integer $subjectid, [integer $tournamentid = false])
array GetAsking (integer $subjectid, [integer $tournamentid = false])
array GetCombatants ([bool $withfreilos = false], [bool $withuser = false], integer $tournamentid, integer $teamid)
string GetFullStartString ([integer $time = false], [string $status = false])
string GetGameString (string $game)
array GetMatches ([integer $matchid = false], [integer $tournamentid = false], [bool $clear = false])
unknown getnextLevel ([unknown_type $level = false])
Array getOrgas ()
array GetResults ([integer $tournamentid = false])
string GetStartString (integer $time, string $status)
void GetStatusString ()
Array GetTournamentDetail ([int $tournament_id = false])
string GetTournamentString (integer $tournamentid)
string GetTypeString ([string $type = false], [string $looser = false])
integer GetUserCoins ([mixed $uid = false])
void InsertScore ( &$match, [ $points1 = false], [ $points2 = false], [ $comment = ""], [ $freecall = false])
void isFull ([ $tournamentid = false])
void isLoserBracket ( $level)
void isPlayer ([ $userid = false], [ $tournamentid = false])
void isRoundplayed ([ $newlevel = false], [ $team1 = ""], [ $team2 = ""], [ $antifreilos = true])
bool nglcheck (string $id, [bool $showerror = true])
bool readyUp (Array $match)
bool RemoveCombatant (integer $teamid, [integer $tournamentid = false])
void setRank ( $combatantid,  $rank, [ $tournamentid = false])
bool setStatus (string $status)
void sortGroups ( $groups)
String UserNotJoinText ([integer $tid = false])
bool ValidLigaID ( &$aLigaid, String $aLigaid)
bool wwclcheck (string $id, [bool $showerror = true])
void _DeleteGames ([integer $tournamentid = false])
Variables
mixed $Admin = false (line 748)
mixed $ContentGroup = 'Screenshots' (line 720)
mixed $currency = 'Coins' (line 743)
mixed $FirstRound (line 738)
mixed $id = null (line 746)
mixed $losersubmit = 'N' (line 740)
mixed $matches = null (line 749)
mixed $maxcoins = 0 (line 742)
mixed $Orga = false (line 747)
mixed $playright (line 741)
mixed $playrightconfig = 'tournament_playright' (line 716)
mixed $treetypes = array (
'default' => 'normal',
'small' => 'kompakt',
'narrow' => 'schmal'
)
(line 732)
mixed $types = array (
'ko' => 'KO',
'group' => 'Gruppen',
'dm' => 'Deathmatch'
)
(line 727)
mixed $u18CheckConfig = 'tournament_u18_check' (line 717)
mixed $xmlfile_NGL = 'NGLGames.xml' (line 723)
mixed $xmlfile_WWCL = 'gameini.xml' (line 724)
Methods
Constructor Turniersystem (line 751)
Turniersystem Turniersystem ([ $id = false])
  • $id
AddCombatant (line 1171)

Fügt ein Team einem Turnier hinzu

  • return: Die ID des neuen Datensatzes oder false, wenn ein Fehler auftritt
integer AddCombatant (integer $teamid, [integer $tournamentid = false])
  • integer $teamid: ID des Turnierteams (Subjekt)
  • integer $tournamentid: optional kann ein Turnier angegeben werden, standardmäßig wird das aktuelle genommen ($_GET["id"])
addOrga (line 853)

Gibt jemanden das Recht 'tournament_orga' über das aktuelle Turniersubjekt Nur ein Subjekt vom Typ User kann als Orga eingetragen werden!

bool addOrga (mixed $aUser)
  • mixed $aUser: irgendwas was einen User identifiziert (siehe CreateSubjectInstance)
ConfirmCombatant (line 1206)

Bestätigung einer Einladung und somit das hinzufügen eines Spielers zu einem Team

  • return: bei erfolg, Die ID der Verknüpfung, ansonsten false.
integer ConfirmCombatant (integer $inviteid)
  • integer $inviteid: Die ID der Einladung
DeleteCombatant (line 1302)

Löscht ein Team

Dabei wird das Team aus der Teilnehmerliste gelöscht und alle Spielpaarungen und Platzierung durch ein Freilos ersetzt! Das Subjekt wird komplett gelöscht!

  • return: false
bool DeleteCombatant (integer $teamid)
  • integer $teamid: ID des zu löschenden Teams
DeleteScore (line 1561)
void DeleteScore ([ $matchid = false])
  • $matchid
GetAsked (line 1117)

Ähnlich wie GetAsking(), gibt aber die angefragten Teams bzw. Spieler zurück

  • return: Spalten aus der DB der angefragten Subjekte
array GetAsked (integer $subjectid, [integer $tournamentid = false])
  • integer $subjectid: Das Subjekt welches die Anfragen gestellt hat
  • integer $tournamentid: optional kann ein Turnier angegeben werden, standardmäßig wird das aktuelle genommen ($_GET["id"])
GetAsking (line 1099)

Liefert Anfragen von Spielern und Teams zurück Je nachdem ob die $subjectid die eines Spielers oder Teams ist, werden die anfragenden Teams bzw. Spieler angezeigt.

Somit können alle Spieler die Anfragen an ein Team gestellt haben oder alle Teams die einen Spieler eingeladen haben aufgelistet werden. z.B. die Anfragen von Team 1303 im Turnier 6:

  1.  print_r(GetAsking(13036));
  2.  
  3.  Array
  4.  (
  5.      [1304=> Array
  6.          (
  7.              [id=> 1
  8.              [mtime=> 20041022132831
  9.              [from=> user
  10.              [tournaments_id=> 6
  11.              [user_id=> 1304
  12.              [team_id=> 1303
  13.          )
  14.  
  15.  )

  • return: Spalten aus der DB der anfragenden Subjekte
array GetAsking (integer $subjectid, [integer $tournamentid = false])
  • integer $subjectid: Das Subjekt zu dem die Anfragen gesucht werden
  • integer $tournamentid: optional kann ein Turnier angegeben werden, standardmäßig wird das aktuelle genommen ($_GET["id"])
GetCombatants (line 1160)

Liest alle teilnehmenden Teams eines Turnieres aus.

Optional kann auch nur ein bestimmtes Team ausgelesen werden. Weiterhin können die Namen der Teammitglieder ausgelsen werden.

  • return: Alle Zeilen aus flip_tournament_combatant welche zu dem aktuellen bzw. $tournamentid Turnier gehören.
array GetCombatants ([bool $withfreilos = false], [bool $withuser = false], integer $tournamentid, integer $teamid)
  • bool $withfreilos: gibt an, ob auch Freilose zurückgegeben werden
  • integer $tournamentid: optional kann ein Turnier angegeben werden, standardmäßig wird das aktuelle genommen ($_GET["id"])
  • integer $teamid: gibt an ob nur ein bestimmtes Team ausgelesen werden soll
  • bool $withuser: gibt an ob zu den Teams auch die Mitglieder ausgelesen werden sollen
GetFullStartString (line 971)

Gibt das Datum und die relative Zeit zum Turnierstart an

  • return: "16.04.2007 13:52 (in 3 Tagen 4 Std. 32 Min.)"
string GetFullStartString ([integer $time = false], [string $status = false])
  • integer $time: PHP-Timestamp
  • string $status: Der Status wird dazu benutzt um festzustellen ob ein Turnier Verspätung hat.
GetGameString (line 901)

Gibt den vollen Namen zu einem Spielkürzel zurück

  • return: ausgeschriebener Name des Spieles
string GetGameString (string $game)
  • string $game: Spielkürzel (max. 4 Zeichen)
GetMatches (line 1027)

Liest die Datenbankspalten aller Matches eines Turnieres aus und sortiert diese nach der Runde und Position in der Runde Mit Angabe einer MatchID wird nur jenes Match zurückgegeben.

  • return: Ein nummerisches Array welches für jedes Match ein Array mit den Spalten der Datenbank enthält. Falls $matchid angegeben wird, wird ein eindimensionales Array zurückgegeben
array GetMatches ([integer $matchid = false], [integer $tournamentid = false], [bool $clear = false])
  • integer $matchid: Wenn angegeben werden nur die Daten des Matches zurückgegeben, sonst alle
  • integer $tournamentid: Wenn angegeben werden die Matches des angegebenen Turnieres zurückgegeben, sonst die des aktuellen ($_GET["id"])
  • bool $clear: Gibt an ob der Cache gelöscht werden soll um die Daten neu aus der DB zu lesen
getnextLevel (line 1832)

TODO: verschieben (vmtl. nach TournamentMatch)

unknown getnextLevel ([unknown_type $level = false])
  • unknown_type $level
getOrgas (line 842)

Liefert alle Orgas des Turnieres

  • return: IDs und Namen der Orgas (ID=>Name)
Array getOrgas ()
GetResults (line 1060)

Liefert die Platzierungen eines Turnieres sortiert zurück

  • return: alle Platzierungen des Turnieres aufsteigend sortiert
array GetResults ([integer $tournamentid = false])
  • integer $tournamentid: Optional kann ein Turnier angegeben werden, standardmäßig wird das aktuelle genommen ($_GET["id"])
GetStartString (line 957)

Gibt die Startzeit in abhängig des Abstandes zu jetzt zurück

  • return: "Freitag, 13:37" oder "in 4 Std. 32 Min."
string GetStartString (integer $time, string $status)
  • integer $time: PHP-Timestamp
  • string $status: Der Status wird dazu benutzt um festzustellen ob ein Turnier Verspätung hat.
GetStatusString (line 908)

converts the DB-status-enum strings into (german) descriptions

void GetStatusString ()
GetTournamentDetail (line 1003)

Gibt alle Daten des Turniers (auch formatiert) als Array zurück

  • return: assoziatives Array der Turnierdaten bzw. leeres Array
Array GetTournamentDetail ([int $tournament_id = false])
  • int $tournament_id: optionale TurnierID
GetTournamentString (line 888)

Gibt einen Text zurück, welcher das Turnier beschreibt.

Ausser dem Namen des Spieles und der Teamgröße (XonX) steht evtl. die Liga oder FUN vor dem Turniernamen.

  • return: "[\[Gruppe\]] [LIGA] full gamename XonX" ([...] is optional)
string GetTournamentString (integer $tournamentid)
  • integer $tournamentid: Die ID des Turnieres von dem man den Text haben möchte
GetTypeString (line 936)

Gibt die Art des Turnieres zuück (Gruppen, Single- oder Doubleelimination) Die Parameter sind optional, es wird dann der Typ des aktuellen Turnieres genutzt.

  • return: Art des Turnieres
string GetTypeString ([string $type = false], [string $looser = false])
  • string $type: Typ des Turnieres (group oder ko)
  • string $looser: gibt es ein Loserbracket (Y/N)
GetUserCoins (line 870)

Liest das verbleibende Guthaben eines Users aus.

  • return: verbleibende Coins
integer GetUserCoins ([mixed $uid = false])
  • mixed $uid: Bezeichnung eines Users (siehe core.subject.php, CreateSubjectInstance())
InsertScore (line 1522)

Ergebnis eines Matches eintragen

allgemeines hier, spezifisches in <type>Matches::setScore()

void InsertScore ( &$match, [ $points1 = false], [ $points2 = false], [ $comment = ""], [ $freecall = false])
  • &$match
  • $points1
  • $points2
  • $comment
  • $freecall
isFull (line 1449)
void isFull ([ $tournamentid = false])
  • $tournamentid
isLoserBracket (line 1734)
void isLoserBracket ( $level)
  • $level
isPlayer (line 1461)
void isPlayer ([ $userid = false], [ $tournamentid = false])
  • $userid
  • $tournamentid
isRoundplayed (line 1741)
void isRoundplayed ([ $newlevel = false], [ $team1 = ""], [ $team2 = ""], [ $antifreilos = true])
  • $newlevel
  • $team1
  • $team2
  • $antifreilos
nglcheck (line 1947)

Prüft ob ein String eine gültige NGL-ID ist und noch nicht vergeben ist Hierbei wird geprüft ob es sich um eine Zahl mit 3-6 Stellen handelt

  • return: true oder false, zusätzlich wird eine Fehlermeldung ausgegeben, wenn $showerror true ist
bool nglcheck (string $id, [bool $showerror = true])
  • string $id: Der zu prüfende String
  • bool $showerror: Gibt an ob eine Fehlermeldung ausgegeben und das Skript beendet wird
readyUp (line 1367)

Teilt den Teams mit, dass ein Match statt finden kann

  • return: false bei Fehler
bool readyUp (Array $match)
  • Array $match: Daten des Matches welches zu bestreiten ist (Zeile aus flip_tournament_matches)
RemoveCombatant (line 1273)

Entfernt ein Team aus einem Turnier Dabei wird das Team aus der Teilnehmerliste gelöscht und alle Spielpaarungen und Platzierung durch ein Freilos ersetzt!

  • return: false
bool RemoveCombatant (integer $teamid, [integer $tournamentid = false])
  • integer $teamid: ID des zu entfernenden Teams
  • integer $tournamentid: optional kann ein Turnier angegeben werden, standardmäßig wird das aktuelle genommen ($_GET["id"])
setRank (line 1679)
void setRank ( $combatantid,  $rank, [ $tournamentid = false])
  • $combatantid
  • $rank
  • $tournamentid
setStatus (line 918)

Ändert den Status in der DB und im Objekt und erstellt einen Logeintrag

  • return: true/false wenn Fehler beim Schreiben in die DB auftreten
bool setStatus (string $status)
  • string $status: Name des Statuses welcher gesetzt werden soll
sortGroups (line 1706)
  • see: _cmp_ergebnis()
  • author: loom
  • since: 1398 - 24.05.2007
void sortGroups ( $groups)
  • $groups
UserNotJoinText (line 1406)

Prüft, ob ein User an einem Turnier teilnehmen darf und gibt einen entsprechenden Fehlertext zurück

  • return: Text warum die Teilnahme verwehrt wird oder false, wenn Teilnahme möglich ist
String UserNotJoinText ([integer $tid = false])
  • integer $tid: optionale TurnierID
ValidLigaID (line 1889)

Prüft, ob die angegebene ID in dem aktuellen Turnier erlaubt ist "none" ist immer gültig, sonst wird für die entsprechende Liga eine Prüfung durchgeführt.

  • return: true wenn ID gültig, false wenn nicht
bool ValidLigaID ( &$aLigaid, String $aLigaid)
  • String $aLigaid
  • &$aLigaid
wwclcheck (line 1913)

Prüft ob ein String eine gültige WWCL-ID ist und noch nicht vergeben ist Für ein 1on1 Turnier wird eine PlayerID benötigt, ansonsten muss eine ClanID angegeben werden.

Z.B: PlayerID: P1234 ClanID: C2345

  • return: true oder false, zusätzlich wird eine Fehlermeldung ausgegeben, wenn $showerror true ist
bool wwclcheck (string $id, [bool $showerror = true])
  • string $id: Der zu prüfende String
  • bool $showerror: Gibt an ob eine Fehlermeldung ausgegeben und das Skript beendet wird
_DeleteGames (line 1661)

Löscht alle Spiele eines Turnieres

zusätzlich werden Serverzuweisungen und Screenshots gelöscht, Platzierungen zurückgesetzt

  • return: nix
void _DeleteGames ([integer $tournamentid = false])
  • integer $tournamentid: Turnier-ID (optional)

Inherited Methods

Inherited From SqlRowObject

SqlRowObject::SqlRowObject()

Documentation generated on Mon, 22 Oct 2007 17:17:29 +0200 by phpDocumentor 1.3.1