Autor: Robert

MKTT-Online ist ein Zusatzprogramm für die Tischtennisturniersoftware MKTT von Martin Koreis und Patrik Aicher. Es bietet die Möglichkeit wärend oder nach einem Turnier die Ergebnisse im Internet zu veröffentlichen. Da die Internetverbinung innerhalb von Großsporthallen meist nur durch mobile Webssticks realisiert werden kann, liegt ein Hauptaugenmerk des Programms darin, sowohl die Datenbankzugriffe als auch den Upload minimal zu halten.

Im Folgenden werden die Funktionen des Tools erklärt.

Nicht gesondert erklärt:

• Der Log-Tab: Hier protokolliert das Programm, was es macht. Interessant nur zur Fehlersuche.
• Der Info-Tab: Entwicklungshinweise, wie man es von anderen Programmen auch kennt.

Eine Beschreibung der Vorlagelayouts und wie man diese anpasst folgt in einem gesonderten Tutorial.

Die Einbindung der generierten Daten in die Homepages des HTTV (Typo3) folgt ebenfalls in einem extra Tutorial.

Beginnen wollen wir mit dem Tab "Einstellungen", da man diese entsprechend anpassen sollte, bevor man die Verbindung zur Datenbank herstellt.

Der Bereich Autorun sollte fast selbsterklärend sein. Hier kann man für den voll- oder halbautomatischen Betrieb des Tools Vorgaben machen:

• Nur generieren: Generiert automatisch alle x Minuten die HTML Seiten neu ohne sie hochzuladen.
• Generieren und uploaden: Wie vor, jedoch mit anschließendem Upload auf den unter "FTP Verbindung" konfigurierten Web-Server.
• Aktualisierungsintervall: Zeit in Minuten bis zur nächsten automatischen Aktualisierung. Je nach Größe des Turniers und Uploadgeschwindigkeit am Veranstaltungsort sollte man eine entsprechendes Intervall einstellen.

• Button Programmpfad: Über den Button Programmpfad erhält man Zugriff auf den Installationsordner in dem neben dem eigentlichen Programm auch die Vorlagen und die generierten Daten liegen.
• Button index.content: Hierrüber öffnet sich ein rudimentärer HTMl-Editor mit dem man die Startseite nach seinen Wünschen gestalten kann. Diese Funktion ist noch experimentell!
• Bereich Navigation optimieren: Die Navigation, also die Auflistung aller im Turnier angelegten Klassen, erfolgt über die in MKTT eingegebenen Drucknamen (für Urkunden, etc.) der Klassen und nicht über die in Click-TT voreingestellten. Um sehr lange Klassennamen zu vermeiden kann man hier Wörter eingeben, die aus den Klassennamen herausgefiltert werden sollen. Die einzelnen Worte sind durch Semikolon zu trennen. Aus "Herren A Einzel" wird somit "Herren A". Dies macht besonders viel Sinn, wenn man unter dem Tab Ausgabe, "gruppieren und sortieren" einstellt. Dazu aber weiter unten mehr.
• Bereich Vorlagelayout bei Erstellung: Die Vorlagelayouts liegen im Programmpfad im Ordner "vorlagen". Diese Vorlagen können kopiert, angepasst, etc. werden. Auch hierzu später mehr. Alle Verzeichnisse, die in dem Ordner "vorlagen" existieren, stehen im Drop-Down-Feld zu Auswahl bereit. Standardmäßig sind bei der Installation von mktt-online mindestens 2 Vorlagen vorhanden "default" und "neutral grau". Das Layout, welches hier eingestellt wurde, wird bei der erfolgreichen Verbindung mit der mktt-Datenbank automatisch übernommen. Nachträgliches Ändern ist durch den Button Layout ersetzen möglich.
• Bereich Lage der Hauptnavigation gem. Layout: Sofern ein Vorlagelayout eine Navigation rechts/links und eine Navigation oberhalb der Ergebnisse bietet (beide vorinstallierten Layouts können das) besteht hier die Möglichkeit auszuwählen, wo die Navigation angeordnet werden soll. Je nach Platz auf der Homepage und Anzahl der Turnierklassen, hat die eine oder die andere Version Vorteile. Bei der "Navigation oben" besteht die Möglichkeit die Klassen zu gruppieren nicht. Mit der Option Klassen/Reihe (Klassen pro Reihe) kann man bei der Navigation oben die Anzahl der Klassen festlegen, nach denen ein Zeilenumbruch stattfindet. Der Standardwert 6 hat sich hierbei bewährt.

Hier je ein Beispiel für eine seitliche und eine Navigation oberhalb:

• Seitliche Navigation bei Kreiseinzelmeisterschaft
• Navigation oberhalb bei Kreisrangliste

• Button Import/Export: Ab Version 1.6 besteht nun die Möglichkeit seine Einstellungen zu exportieren bzw. importieren. Es öffnet sich hierbei ein neues Fenster in dem man auswählen kann, was exportiert bzw. importiert werden soll. Beim Import sind nur die Bereiche auswählbar, welche in der Datei vorhanden sind. Nach dem Import ist ein Neustart des Programms notwendig!

Der Tab DB Verbindung ist ebenfalls recht selbsterklärend:

• Datenbankpfad: IP Adresse des Rechners, auf dem die Datenbank von mktt läuft. Falls mktt-online auf dem gleichen Rechner wie die Datenbank läuft ist hier "localhost" einzutragen. 
• Datenbankport: Der Datenbankport ist auf 3306 voreingestellt. Dies sollte auch in 99% der Fälle korrekt sein.
• Datenbankname: Hier muss der Name des Turniers, so wie es in mktt angelegt wurde, eingegeben werden.
• Username/Passwort: Auch hier müssen die entsprechenden Daten gemäß mktt eingetragen werden. Hinweis: der User "root" funktioniert nur, wenn mktt-online auf dem gleichen Rechner wie mktt läuft. Ansonsten ist "mktt-user" mit dem entsprechenden Passwort zu nutzen!

Nach der Eingabe aller Felder zum Abschluss den Test-Button drücken. Erst bei erfolgreicher Verbindung wird der Generate-Button freigeschaltet.

Auch der Tab FTP Verbindung sollte für Leute, die Zugriff auf einen FTP-Server haben, weitestgehend selbsterklärend sein.

• Host: URL des FTP-Server
• Port: Standard "0". Am besten so belassen, hier nur einen Port eintragen, wenn der Server nicht die Standardports verwendet.
• Benutzername/Passwort: Selbsterklärend
• Protokoll: FTP (Standard) / SFTP Auswahl, ob die Daten unverschlüsselt (FTP) oder verschlüsselt (SFTP) übertragen werden. Die meisten Server übertragen die Daten noch unverschlüsselt, daher ist FTP Standard.
• SSH-Schlüssel: Wird benötigt, wenn das SFTP Protokoll angewendet werden soll. Den Schlüssel gibt es vom Hoster der Webseite.
• alle zulassen: Bezieht sich auf den SSH-Schlüssel. Falls dieser nicht bekannt sein sollte, kann man versuchen mit der Option "alle (Schlüssel) zulassen" dennoch eine Übertragung zu realisieren (unsicher).
• Pfad auf Server: Unterverzeichnis in welches das Turnier hochgeladen werden soll. Ab Version 1.6 ist aus Sicherheitsgründen ein Unterverzeichnis nortwendig! Dies kann man direkt eingeben oder die Platzhalter {db} oder {turnier} nutzen. {db} ersetzt hierbei die alte Option "Datenbankname als Unterverzeichnis nutzen". Bei {db} wird der Datenbankname von mktt (ohne das Prefix "mktt_" als Unterverzeichnis für den Upload genutzt. {turnier} nutzt den offiziellen Clicktt-Turniernamen + das Startdatum des Turniers als Unterverzeichnis. Der Ordner wird automatisch beim ersten Upload angelegt. Zur Überprüfung wird unten der komplette FTP-Pfad angezeigt, in den die generierten Daten hochgeladen werden.
• pass. Mod: Passiver Modus (Standard). Manche FTP-Server unterstützen den passiven Modus nicht. Mit diesem Schalter kann man zwischen passiven und aktiven Modus umschalten. Im aktiven Modus kann es sein, dass Firewall Freigaben notwendig werden, daher ist passiv Standard.
• Manuelles Hochladen: kein Haken (Standard) Nur nutzen, falls kein direkter FTP Zugriff existiert, so gibt es hier die Möglichkeit einen manuellen Upload zu vereinbaren. Hierbei werden die hochzuladenden Daten im Programmpfad unter "manueller_upload" abgelegt. Es werden nur die Dateien dorthin kopiert, die sich seit der letzten Generierung geändert haben. Dadurch wird die Größe des zu verrichtenden Uploads minimal gehalten (langsame Internetverbindung). Der Inhalt des Ordners muss manuell gelöscht werden, da das Programm keine Kontrolle darüber hat, ob die Daten wirklich hochgeladen wurden. Es empfiehlt sich hierbei auf die Autorun Funktion komplett zu verzichten und sowohl die Generierung als auch den manuellen Upload (also das Kopieren der neuen Daten in den Ordner) per Hand anzustoßen.