EXT: T3sports FE¶

What does it do?¶

Diese Extension stellt zwei Frontend-Plugins für die Verwaltung von Sportligen der Extension cfc_league zur Verfügung. Derzeit sind die folgenden Darstellungen enthalten:

Plugin: Ligaverwaltung

• Wettbewerbsauswahl
• Spielplan
• Ligatabelle
• Ligatabelle (All-Time)
• Tabellenfahrt
• Liste der Liveticker
• Statistiken
• Teamliste
• Kreuztabelle

Plugin: Berichte

• Wettbewerbsauswahl
• Spielbericht / Liveticker
• Teamdarstellung
• Personenprofil
• Personenliste
• Vereinsliste

Zu Beginn eine Warnung: Die Extension befindet sich im Betastatus. Neben der Referenzinstallation für den Chemnitzer FC, gibt es allerdings schon weitere Vereine, die die Extension erfolgreich einsetzen. Das Layout und Konfigurationen sind aber in erster Linie für den CFC ausgelegt. Trotzdem sollte der Einsatz natürlich auch generell möglich sein, nur darf man sich nicht wundern, das im Frontend erstmal alles in himmelblau erscheint.

Sollte sich jemand die Arbeit machen und ein neutrales Layout anfertigen, dann würde ich es natürlich gern in die Extension integrieren.

Die Einrichtung von Datensätzen wie Spielen, Teams oder Spielern ist ausführlich in der Dokumentation der Extension cfc_league beschrieben.

Hinweise auf Updates erhält man über folgende Mailingliste: https://lists.sourceforge.net/lists/listinfo/cfcleague-general

Screenshots¶

Die folgenden Darstellungen geben einen Überblick über die vorhandenen Darstellungsmöglichkeiten.

Illustration 1: Spielplan in Spieltagsdarstellung. Vorhandene Spielberichte werden automatisch verlinkt

Illustration 2: Team-Spielplan

Illustration 3: Eine Ligatabelle mit farbiger Markierung von Tabellenplätzen und Teams

Illustration 4: Chart auf Basis der Extension pbimagegraph

Illustration 5: Ausführlicher Spielbericht

Illustration 6: Spielerarchiv mit alphabetischer Ordnung

Illustration 7: Für jeden Spieler kann eine ausführliche Einzeldarstellung erstellt werden.

Illustration 8: Beispiel für ein Flexform

Wettbewerbsauswahl¶

Spielplan¶

Ligatabelle¶

Tabellenfahrt¶

Liste der Liveticker¶

Statistiken¶

Spielbericht¶

Teamdarstellung¶

Personenliste¶

Personenprofil¶

Vereinsliste¶

Langfristig ist geplant alle Templates auf HTML umzustellen.

View Wettbewerbsauswahl¶

Dieser View ist sowohl im Plugin Ligaverwaltung als auch Berichte vorhanden. Seine Einstellungen erfolgen jeweils im ersten Tab des Flexform. Die Hauptaufgabe dieser Einstellungen bestehen darin festzulegen, welche Datensätze genau auf der Seite dargestellt werden sollen.

Illustration 10: Der Scope legt fest, welche Daten gezeigt werden sollen.

Am besten läßt sich dies an einem Beispiel verdeutlichen. Angenommen man möchte auf der Seite eine Teamdarstellung realisieren. Mit Hilfe der Wettbewerbsauswahl legt man fest, welches Team gezeigt werden soll. Diese Angabe erfolgt aber nicht direkt über die Auswahl eines Teamdatensatzes, sondern indem man einen Scope angibt. Dieser Scope besteht im Plugin Berichte aus der Saison des Teams und der Altersgruppe . Da je Saison und Altersgruppe genau ein Team spielen sollte, kann man das Team so genau definieren. Man kann aber auch mehrere Saisondatensätze integrieren und dann im Frontend dem Benutzer die Auswahl überlassen. Dadurch hat man dann automatisch eine Teamhistorie. Im Screenshot kann der Nutzer im Frontend zwischen zwei Spieljahren wählen und bekommt jeweils das Team der 2. Mannschaft angezeigt.

Man kann die Auswahlboxen auch leer lassen und nur jeweils die Select- Boxen aktivieren. Das bewirkt, daß automatisch alle vorhandenen Datensätze zur Auswahl stehen.

Die Selectboxen im Frontend erscheinen nur, wenn auch der View Wettbewerbsauswahl mit ausgewählt wurde.

Bei der Verwendung von HTML-Templates werden die Selectboxen durch normale Links ersetzt. Damit können die Cachingmechanismen von TYPO3 genutzt werden.

View Spielplan¶

Um den Spielplan anzuzeigen, muß man zunächst im Tab Allgemein den Scope festlegen. Wenn man den Spielplan für ein bestimmtes Team anzeigen möchte, muß man zusätzlich den entsprechenden Verein auswählen. (Achtung: Die Auswahl mehrerer Vereine wurde noch nicht getestet und die Selectbox nicht unterstützt.)

Im Tab Spielplan können nun die weiteren Angaben gemacht werden. Ein Link zum Spielbericht wird nur dann angelegt, wenn dieser im Spiel vorhanden ist und wenn im Flexform eine Seite für dessen Darstellung angegeben wurde.

Wenn der Spielplan nicht für einen bestimmten Verein gezeigt wird, dann wird über den View Wettbewerbsauswahl automatisch eine Selectbox zur Auswahl des Spieltages eingefügt.

Zeitliche Eingrenzung: Man kann den Spielplan auf Tagesbasis eingrenzen. Ausgangspunkt ist natürlich immer das aktuelle Datum.

Per Typoscript ist es zusätzlich möglich auch die Anzahl der Spiele zu begrenzen. Damit kann beispielsweise immer das nächste Spiel eines Teams gezeigt werden.

View Ligatabelle¶

Erzeugt die Darstellung einer Ligatabelle. Auch hier muß vorher der gewünschte Scope eingestellt werden. Die einzelnen Einstellungen haben folgende Bedeutung:

Tabellenscope: Man kann zwischen Saison, Hin- und Rückrunde wählen. Es wird jeweils die passende Tabelle berechnet. Optional kann man die Auswahl aber auch dem Nutzer überlassen (Selectbox anzeigen).

Tabellentyp: Auswahl zwischen Normal, Heim- und Auswärtstabelle. Auch hier ist eine Selectbox für den FE-Nutzer möglich.

Selectbox für Punktesystem: Die Tabelle wird normalerweise entsprechend der Punktezählung im entsprechenden Wettbewerb angezeigt. Mit diesem Punkt kann man dem Nutzer in Frontend die Tabelle aber nach Wahl im 2-Punkte oder 3-Punkte-Modus anzeigen lassen.

Livetabelle: Noch nicht implementiert. Zeigt die Tabelle inklusive aktuell laufender Spiele.

Vereine hervorheben: Hiermit können in der Tabelle die Teams bestimmter Vereine hervorgehoben werden.

Bei der Verwendung von HTML-Templates werden statt der Selectboxen normale Links verwendet.

View Tabellenfahrt¶

Erzeugt eine grafische Darstellung der Tabellenfahrt von ausgewählten Teams. Die Charterzeugung erfolgt mit Hilfe der Extension pgimagegraph . Für genaue Angaben zur Formatierung sei daher auf die sehr ausführliche Dokumentation diese Extension verwiesen. Ein Beispiel Typoscript-Setup findet sich im Standardtemplate dieser Extension: EXT:cfc_league_fe/static/setup.txt

Die Farbangaben erfolgen entweder Hexadezimal oder über Standard- Farbschlüsselwörter, wie yellow, blue oder red.

View Statistiken¶

Dieser View wurde mit Version 0.2.0 komplett umgestellt. Alle Statistiken werden jetzt als Service dynamisch integriert, so daß die bisherigen Spielerstatistiken nun in vier verschiedene Einzelstatistiken aufgeteilt wurden:

• Spieler (der Arbeitsnachweis der Spieler)
• Torschützenliste
• Beste Vorlagengeber
• Spielerzusammenfassung

Die letzte Statistik ist die kürzeste. Hier wird nur ausgegeben, welche Spiele in der Spielerstatistik Verwendung fanden.

Das Grundprinzip der Statistiken bleibt wie bisher erhalten. Es wird zunächst wieder der Scope ausgewählt, um festzulegen, über welche Spiele und ggf. für welche Teams eine Statistik erstellt werden soll.

Die Reihenfolge der Spieler im Arbeitsnachweis kann nicht mehr über das Flexform festgelegt werden. Das geschieht jetzt mit folgender TypoScript-Anweisung:

# Sortierung der Spieler: 0-alphabetisch, 1- wie im Team
plugin.tx_cfcleaguefe_competition.statistics.player.profileSortOrder = 0

Cache-Timeout: Da die Berechnung der Spielerstatistiken je nach Datenmenge mehrere Sekunden dauern kann, verwendet diese Extension einen internen Cache.Diesen kann man mit dem Timeout in regelmäßigen Abständen leeren.

Der interne Statistik-Cache wurde im Zuge der Codeumstellung vorerst deaktiviert. Daher ist es dringend zu empfehlen im Livebetrieb das Plugin für die Statistik als USER laufen zu lassen. Nur so ist der Seitencache von TYPO3 wirksam! Bei Standardinstallation ist das Plugin automatisch als USER in TYPO3 registriert.

ACHTUNG: Diese Statistiken werden nicht mehr weiterentwickelt. Im TER befindet sich die Extension t3sportstats , welche umfangreicherer und performantere Statistiken bereitstellt.

View Spielbericht¶

Für diesen View ist die Angabe eines Scopes nicht notwendig. Die Einstellung Zeige Ticker ist noch nicht implementiert.

Man hat die Möglichkeit einzelne Ticker-Typen im Spielstenogramm nicht anzuzeigen. Dies ist dann sinnvoll, wenn diese Informationen nur der Statistik dienen, wie z.B. die Torvorlagen.

View Teamdarstellung¶

Nach Eingabe des Scopes mit Saison und Altersgruppe muß man hier zusätzlich noch den gewünschten Verein angeben. Wenn man von der Liste der Spieler, Trainer und Betreuer auf die Einzeldarstellung der Personen verlinken möchte, dann müssen noch die entsprechenden Seiten festgelegt werden. Für Trainer und Betreuer wird die selbe Seite verwendet.

In diesem View hat man bei der Ausgabe die Möglichkeit auch Teamnotizen anzuzeigen.

View Personenprofil¶

Der Scope ist hier nicht notwendig. Man hat die Möglichkeit ein bestimmtes Profil darzustellen. Üblicherweise wird man diese Angabe aber nicht machen und stattdessen des gewünschte Profil per Parameter von einer anderen Seite (Teamview oder Personenliste) erhalten.

In jedem Fall muß aber der SysFolder angegeben werden, der die Profile enthält.

Weiterhin besteht die Möglichkeit ein zufällig ausgewählte Person anzeigen zu lassen. Dies ist nützlich, wenn man z.B. einige Spieler in einem Teaser anzeigen möchte.

View Personenliste¶

Auch hier ist der Scope nicht von Bedeutung, es muß lediglich der gewünschte SysFolder mit den Profilen angegeben werden. Bei einer Verlinkung zur Einzeldarstellung muß die entsprechende Seite festgelegt werden (Constant-Editor).

Abbildung 11: Flexform der Personenliste

Optional kann die Personenliste mit einem Buchstaben-Menu angezeigt werden. Des weiteren besteht die Möglichkeit eine Geburtstagsliste zu erstellen. Es können alle Personen angezeigt, die entweder im aktuellen Monat oder Tag Geburtstag haben. FAQ ^^^

Warum werden keine Links für die Teamdarstellung im Spielplan/Ligatabelle erzeugt?

Damit Links erzeugt werden sind grundsätzlich zwei Bedingungen notwendig. Erstens muss eine Seite konfiguriert werden, auf die der Link verweisen soll. Dies geschieht entweder im Flexform des Plugins oder per Typoscript-Konstante über den TYPO3 Constant-Editor. Zweitens muss das Team auch ein Häkchen bei Link auf Teamseite möglich im Datensatz gesetzt haben. Diese Vorbedingungen werden deshalb verwendet, weil man dadurch recht gezielt einstellen kann, wo Links erscheinen sollen.

Verwendung von Team-Notizen¶

Mit der Version 0.4.4 von T3sports FE können im Frontend die sogenannten Team-Notizen ausgegeben werden. Damit wird die Möglichkeit gegeben einem Spieler in Abhängigkeit zu einem bestimmten Team weitere Informationen zu zuordnen. Am Beispiel der Rückennummer lässt sich das sehr gut verdeutlichen. Diese Nummer kann für einen Spieler von Jahr zu Jahr unterschiedlich sein. Daher kann diese Informationen nicht direkt im Spieler abgespeichert werden, weil sie dann jedes Jahr durch eine neue Nummer ersetzt werden müsste. Man würde also die Historie der Daten verlieren.

Mit der Team-Notiz liefert T3sports die passende Datenstruktur für diese Information. Im folgenden Beispiel wird gezeigt, wie man Rückennummern und ein zusätzliches Bild für den Spieler als Team-Notiz anlegt und im Frontend ausgibt. Für alle Aktionen wird das Modul Liste verwendet.

Integration der Spiele als Event in der Extension Calendar base (cal)¶

Es ist möglich die Spiele als Termine in einem Kalender darzustellen. Dafür müssen die folgenden Schritte durchgeführt werden:

Über den Extension Manager muss in der Extension T3sports FE die Option Enable Integration for Calendar Base aktiviert werden.

Anschließend muss das static Template League Management cal- events eingebunden werden. Dieses muss unbedingt nach dem normalen static Template der Extension stehen, da es sich auf dessen Angaben bezieht!

Illustration 17: Das Kalendertemplate der Ligaverwaltung muss nach dem normalen Tempalte stehen.

Im Plugin des Kalenders muss die Seite mit den Spielen nun als Quelle für Termine mit angegeben werden: Die Gestaltung des Layouts geschieht über ein HTML-Template. Eine Vorlage liegt unter ext:cfc_league_fe/views/templates/match_event.html.

Damit nun nicht alle Spiele gezeigt werden, kann wie üblich die Auswahl vorher eingeschränkt werden. In diesem Fall aber nur per Typoscript:

01: plugin.tx_cal_controller {
02:   view.cfc_league_events {
03:     # Eigenes Template einbinden
04:     template = fileadmin/templates/match_events.html
05:     # Es kann auf die gleichen Werte, wie in den normalen Views eingegrenzt werden
06:     # Andernfalls werden alle Spiele im Kalender eingetragen
07:     # Die folgenden Werte sind jeweils UIDs und müssen natürlich angepaßt werden!
08:     # Die Saison wird nicht eingegrenzt, damit sind jedes Jahr aktualisiert werden muss
09: #    saisonSelection =
10:     # Altersklasse festlegen
11:     groupSelection = 1
12:     # Vereinsauswahl
13:     clubSelection = 3
14:     # Wettbewerbsauswahl in diesem Fall nicht gesetzt
15: #    competitionSelection =
16:   }
17: }

In diesem Typoscript-Beispiel werden also alle Spiele gefunden, deren Altersklasse die UID 1 hat und bei denen Teams des Vereins mit der UID 3 antreten.

Diese Angaben können auch direkt im Plugin von Calendar Base im Tab Typoscript eingegeben werden. Dann muss man die äußere Klammer natürlich weglassen (plugin.tx_cal_controller).

Bei Problemen ist es möglich die Datenbank-Query im FE anzeigen zu lassen, mit der die Spiele in der Datenbank gesucht werden. Dafür muss man im Plugin von Calendar Base im Tab Typoscript folgende Angabe machen:

view.cfc_league_events.debug = 1

Weitere Optionen:

view.cfc_league_events.ignoreDummy = 0/1 (Spielfrei nicht anzeigen)
view.cfc_league_events.competitionTypes = 0/1/2 (Wettbewerbstypen: Sonstige/Liga/Pokal)
view.cfc_league_events. CompetitionObligation = 0/1/2 (Pflichtwettbewerbe: Alle/Pflicht/Freundschaft)
view.cfc_league_events.limit = 10 (maximale Anzahl Ergebnisse)
view.cfc_league_events.liveticker = 0/1 (Nur Livetickerspiele anzeigen)

Darüber hinaus können weitere Angaben direkt über die üblichen Fields und Options gesetzt werden:

view.cfc_league_events.fields.
view.cfc_league_events.options.

Sollte nach dieser Angabe im FE keine Ausgabe erfolgen, dann ist die Integration nicht korrekt konfiguriert. Ursache kann eine falsche Reihenfolge der Static Templates sein oder eine fehlende Aktivierung über den Extension Manager.

Einen Teaser für das nächste Spiel einer Mannschaft erstellen¶

Für diese Darstellung wird der View Spielplan verwendet. Wir müssen den Scope zunächst so einstellen, daß wir einen Mannschaftsspielplan erhalten. Es muss also mindestens die Altersklasse und der Verein des Teams festgelegt werden. Optional kann natürlich auch die Saison und der Wettbewerb eingeschränkt werden. Bei letzterem kann man dann zum Beispiel auch speziell das nächste Pokalspiel anzeigen.

01: # Ein neues Objekt anlegen, daß später z.B. einem Marker zugeordnet werden kann.
02: lib.nextMatch < plugin.tx_cfcleaguefe_competition
03:   action = tx_cfcleaguefe_actions_MatchTable
04:   # UID der Saison
05:   saisonSelection = 4
06:   # UID der Altersklasse
07:   groupSelection = 1
08:   # UID des Vereins
09:   clubSelection = 3
00:   # Der Wettbewerb wird nicht eingeschränkt
11: #  competitionSelection =
12:   # Sicher soll ein spezielles Template verwendet werden
13:   matchtableTemplate = fileadmin/templates/nextmatch_teaser.html
14:   # Nur Spiele der nächsten 20 Tage betrachten
15:   matchtable.timeRangeFuture = 20
16:   # Jetzt die Ergebnisliste auf das erste Spiel beschränken
17:   matchtable.options.limit = 1
18:   # nur angesetzte und laufende Spiele anzeigen
19:   matchtable.fields.MATCH.STATUS.OP_IN_INT = 0,1
20: }

Einen Teaser für das letzte Spiel einer Mannschaft erstellen¶

Im Prinzip funktioniert das wie im vorherigen Beispiel. Es sind nur kleine Anpassungen notwendig:

01: lib.lastMatch =< lib.nextMatch
02: lib.lastMatch {
03:   matchtable {
04:     fields.MATCH.STATUS.OP_IN_INT = 2
05:     # Wichtig: Absteigend nach Datum sortieren!
06:     options.ORDERBY.MATCH.DATE = DESC
07:     timeRangePast = 20
08:     timeRangeFuture = 1
09:   }
10: }

Erstellung eines Teasers der aktuellen Ligatabelle¶

Man kann recht einfach auch eine Kurztabelle erstellen, die man dann am Seitenrand als Teaser plaziert. Mit TypoScript sind die folgenden Angaben notwendig:

01: lib.shortTable < plugin.tx_cfcleaguefe_competition
02: lib.shortTable {
03:   action = tx_cfcleaguefe_actions_LeagueTableShow
04:   tablescope = 0
05:   tabletype = 0
06:   # Hier die UID des Vereins
07:   leaguetable.tablecfg.markClubs = 123
08:   # Hier die UID des Wettbewerbs
09:   competitionSelection = 123
10:   leaguetableTemplate = fileadmin/mytableteaser.html
11:   # Anzahl der gezeigten Teams
12:   leaguetable.tablecfg.tableSize = 5
13: }

Das Objekt lib.shortTable kann man dann in einen Marker seines Typoscript-Templates einbauen.

Es ist auch möglich die Anzahl der Teams in der Tabelle direkt über das Plugin zu ändern. Hierzu gibt man im Tab Typoscript einfach diese Zeile ein:

leagueTableSize = 5

Umgang mit Bildern¶

Mit der Version 0.6.0 wurde eine Umstellung der Bildausgabe vorgenommen. Die Ausgabe der Bilder erfolgt jetzt über eine einheitliche Schnittstelle und kann per Typoscript und einem HTML- Template (fast) beliebig angepasst werden. Es sollte möglich sein, so gut wie jede Javascript-Gallerie einzubinden. Vorlagen für Lightbox und Galleriffic werden bereits mitgeliefert.

Am Beispiel des Spielberichts soll gezeigt werden, wie man eine Gallerie für die Ausgabe der Bilder einbindet. Im HTML-Template des Spiels befindet sich lediglich der Marker ###MATCH_PICTURES###. Diesem ist per Typoscript folgende Konfiguration zugewiesen:

lib.t3sports.match {
  pictures = USER
  pictures {
    userFunc = tx_rnbase_util_TSDAM->printImages
    refField = dam_images
    refTable = tx_cfcleague_games
    template = EXT:cfc_league_fe/res/lightboxpics.html
    subpartName = ###PICTURES###
    media {
      file = IMG_RESOURCE
      file.file.import.field = file
      file.file.maxW = {$plugin.tx_cfcleaguefe_report.maxW_matchPicture}
      file.file.maxH = {$plugin.tx_cfcleaguefe_report.maxH_matchPicture}
      thumbnail < .file
      thumbnail = IMAGE
      thumbnail.file.maxW = {$plugin.tx_cfcleaguefe_report.maxW_matchThumb}
      thumbnail.file.maxH = {$plugin.tx_cfcleaguefe_report.maxH_matchThumb}
      thumbnail.params = border="0"
      thumbnail.titleText.field = title
    }
  }
}

Wichtig ist zunächst der Verweis auf das HTML-Template lightboxpics.html . In diesem befindet sich im Subpart ###PICTURES### die Vorlage für die Ausgabe der Bilder. Für die Lightbox hat er folgendes Aussehen:

###PICTURES###
###MEDIAS######MEDIA###
<a href="###MEDIA_FILE###" rel="lightbox[pictures]">###MEDIA_THUMBNAIL###</a>
###MEDIA######MEDIAS###
###PICTURES###

Es handelt sich also um eine gewöhnliche Listenausgabe. Die Typoscript-Formatierung für MEDIA, es handelt sich hier um Datensätze der Tabelle tx_dam, befindet sich mit im obigen TS-Code. Die Ausgabe verwendet nur die Marker MEDIA_FILE und MEDIA_THUMBNAIL . Der erste Marker liefert die URL aus das komplette Bild und der zweite Marker ein Image-Tag auf das Thumbnail.

Damit nun wirklich eine Lightbox angezeigt wird, muss man das notwendige Javascript noch in die Seite einbinden. Dafür kann man z.B. auf der FE-Seite mit dem Spielbericht ein neues Typoscript-Template anlegen und folgenden Code integrieren:

page.headerData.77 = TEXT
page.headerData.77.value (
<link rel="stylesheet" href="fileadmin/lightbox/css/lightbox.css" type="text/css" media="screen" />
<script type="text/javascript" src="fileadmin/lightbox/js/prototype.js"></script>
<script type="text/javascript" src="fileadmin/lightbox/js/scriptaculous.js"></script>
<script type="text/javascript" src="fileadmin/lightbox/js/lightbox.js"></script>
)

Die entsprechenden Dateien müssen natürlich an der angegebenen URL vorhanden sein.

plugin.tx_cfcleaguefe_report {
  matchreport.match.pictures.template = EXT:cfc_league_fe/res/gallerifficpics.html
}

page.headerData.55 = TEXT
page.headerData.55.value (
<link rel="stylesheet" href="fileadmin/galleriffic/css/basic.css" type="text/css" />
<link rel="stylesheet" href="fileadmin/galleriffic/css/galleriffic-2.css" type="text/css" />
<script type="text/javascript" src="fileadmin/galleriffic/js/jquery-1.3.2.js"></script>
<script type="text/javascript" src="fileadmin/galleriffic/js/jquery.galleriffic.js"></script>
<script type="text/javascript" src="fileadmin/galleriffic/js/jquery.opacityrollover.js"></script>
)

Verschiedene Altersklassen in einem Wettbewerb¶

Es ist grundsätzlich möglich, daß in einem Wettbewerb verschiedene Altersklassen gegeneinander antreten. In Pokal-Wettbewerben sind z.B. häufig neben der 1. Mannschaft auch Teams der U23 vertreten. Mit Version 0.6.0 können daher einem Wettbewerb mehrere Altersklasse zugeordnet werden. Um dann auch weiterhin eine Einschränkung des Scopes auf die Spieler genau einer Altersklasse zu ermöglichen, kann auch im Teams genau eine Altersklasse eingestellt werden. Diese Erweiterung des Datenmodells hat Auswirkungen auf die meisten Ausgaben des Wettbewerbs-Plugins.

Um bspw. den Team-Spielplan der U23 eines Vereins zu zeigen, setzte man bisher den Scope auf die Altersgruppe „U23“ und den Verein auf den gewünschten Wert. Wenn aber jetzt zwei Teams des selben Vereins im selben Wettbewerb spielen, dann werden natürlich zu viele Spiele geliefert. Als Lösung muss man zusätzlich in den beiden betroffenen Teams die richtige Altersklasse einstellen und per Typoscript den Scope erweitern:

plugin.tx_cfcleaguefe_competition.scope.teamGroup = 1

Mit dieser Anweisung wird zusätzlich noch die Altersklasse des Teams in den Scope mit eingeschlossen. Dieses Vorgehen wirkt dann natürlich auch analog bei den Statistiken.

Link auf Spielbericht aus einer tt_news-Meldung¶

Seit Version 0.3.3 ist es möglich in Meldungen von tt_news direkte Links auf Views von T3sports zu setzen. Der „Link“ in der Meldung hat dabei ein besonderes Format:

[t3sports:tsconfigid:parameter{,parameter} Link Label]

Das sieht etwas kyptisch aus, ist aber am konkreten Beispiel überschaubar. Hier der Link auf den Spielbericht der Partie mit der UID 123:

[t3sports:matchreport:123 Zum Spielbericht]

Damit dieser Link funktioniert, müssen im Typoscript-Setup von tt_news einige Einstellungen getroffen werden:

01: plugin.tt_news {
02:   external_links {
03:     matchreport {
04:       ext_parameters = matchId
05:       pid = {$plugin.tx_cfcleaguefe_report.matchreportpage}
06:     }
07:     profile {
08:       ext_parameters = profileId
09:       pid = {$plugin.tx_cfcleaguefe_competition.playerpage}
10:     }
11:   }
12: }

In dieser Konfiguration ist bereits eine weitere Einstellung für die Verlinkung auf einzelne Spieler mit eingebaut. Der entsprechende Link hat dann dieses Aussehen:

[t3sport:profile:11 Die Person mit der UID 11]

Abbildung 18: Links in tt_news

Abbildung 19: Und die Ausgabe auf der Webseite

Nach diesem Prinzip können auch Links auf weitere Views von T3sports eingerichtet werden.

Beim Link auf den Spielbericht ist zusätzlich die Altersgruppe des Spiels als Register T3SPORTS_GROUP gesetzt. Damit kann man die Zielseite dann auch variieren:

plugin.tt_news {
  external_links {
    matchreport {
      ext_parameters = matchId
      pid >
      pid.cObject = CASE
      pid.cObject {
        key.data = register:T3SPORTS_GROUP
        2 = TEXT
        2.value = 123
        default = TEXT
        default.value = {$plugin.tx_cfcleaguefe_report.matchreportpage}
      }
    }
  }
}

In diesem Beispiel wird für die Altersgruppe mit der UID 2 die Zielseite mit der UID 123 verwendet. Für alle anderen Altersgruppen wird weiter die Standardseite verwendet.

Lokalisierung von HTML-Templates¶

Seit Version 0.4.0 besteht die Möglichkeit beliebige Sprach-Marker in den Views von T3sports zu integrieren. Dafür muss zunächst per Typoscript der Marker definiert werden. Als Beispiel soll ein Marker für den Begriff Team angelegt werden. Per Typoscript definiert man folgende Übersetzung:

plugin.tx_cfcleaguefe_report {
  _LOCAL_LANG {
    default.label_team = Team
    de.label_team = Mannschaft
  }
}

In den HTML-Templates des Plugins T3sports: Berichte kann nun der Marker ###LABEL_TEAM### verwendet werden. Für das Plugin T3sports: Ligaverwaltung verwendet man analog folgendes Setup:

plugin.tx_cfcleaguefe_competition {
  _LOCAL_LANG {
    default.label_team = Team
    de.label_team = Mannschaft
  }
}

Die Sprachmarker beginnen also immer mit LABEL_ . Der Rest ist dann frei wählbar und man kann beliebig viele Marker anlegen.

Verwendung ohne DAM¶

Wenn T3sports ohne DAM eingesetzt wird, dann muss das zusätzliche Static Template „T3sports without DAM“ eingebunden werden. Es muss unbedingt NACH dem Standardtemplate stehen. Dieses Template stellt die Ausgabe aller Grafiken um.

Verwendung mit FAL¶

Ab der Version 0.9.1 kann T3sports in TYPO3 6.x im Zusammenspiel mit FAL verwendet werden. Mit FAL (File Abstraction Layer) wird die externe Extension DAM obsolet und kann auch nicht mehr installiert werden. T3sports erkennt im Backend automatisch das Vorhandensein von FAL und stellt die Eingabemasken entsprechend um. Für die Ausgabe im Frontend muss aber das zusätzliche Static Template „T3sports with FAL“ eingebunden werden. Auch dieses Template muss NACH dem Standard- Template eingereiht werden!

FAQ¶

-TYPO3 Fatal Error: Extension key "rn_base" was NOT loaded! (t3lib_extMgm::extPath)

Wenn man diese Meldung von TYPO3 erhält, dann hat man bei der Installation der Extension vermutlich die Abhängigkeitshinweise des Extension-Managers ignoriert. Wenn man noch Zugriff auf das TYPO3-Backend hat, sollte man die fehlenden Extensions noch installieren. Sollte dies nicht mehr möglich sein, dann muss man in der Datei typo3conf/localconf.php die Extensions cfc_league und cfc_league_fe manuell aus dem Array $TYPO3_CONF_VARS['EXT']['extList'] entfernen. Dann die temp_CACHED_-Dateien löschen. Der Zugang zum Backend sollte nun wieder funktionieren.

CSS¶

Ich habe vorerst darauf verzichtet eine neutrale CSS-Formatierung fest in die Extension zu integrieren. Das liegt vor allem daran, weil ich noch keine erstellt habe...

Im Verzeichnis EXT:cfc_league_fe/res/ liegt allerdings eine CSS-Datei die als Vorlage verwendet werden kann. Man sollte die Datei in den Ordner fileadmin kopieren und diese dann per Typoscript in sein Template einbinden:

page.includeCSS {
  t3sports = fileadmin/cfcleague.css
}

Reference Plugin Wettbewerb¶

- Properties of plugin.tx_cfcleaguefe_competition

plugin.tx_cfcleaguefe_competition {
  action = tx_cfcleaguefe_CompetitionSelection,tx_cfcleaguefe_MatchTable
}

plugin.tx_ cfcleaguefe_competition {
  template = fileadmin/templates/liga/scope.html
}

plugin.tx_ cfcleaguefe_competition {
  leaguetable.table.markClub.override = mein-css
}

plugin.tx_ cfcleaguefe_competition {
  leaguetable.controls.tablescope{
    0.override = Normal
    1.override = Hinrunde
    2.override = Rückrunde
  }
}

FAQ¶

Include Markers with services¶

Starting with version 0.3.0 it is possible to integrate markers in HTML templates by TYPO3-services. The principle is adopted from extension Calendar Base . You will find a complete example in folder ext:cfc_league_fe/svmarker/ . All you need to do is to write a new service class with a method getMarkerValue($params, $formatter).

For a complete example check out EXT:cfc_league_fe/svmarker/class.tx _cfcleaguefe_svmarker_ChartMatch.php

This add the marker ###MARKERMODULE__CHARTMATCH### used in match report to include a chart of opponent teams.