====== T3sports (cfc_league / cfc_league_fe) ======

===== Anleitungen =====

==== Spielplan erstellen ====

Um einen von anderer Stelle erstellten Spielplan korrekt zu kopieren, kann man den Spielschlüssel verwenden. Ist dieser nicht bekannt, lässt er sich auch einfach selbst erstellen:
  - Spiele __der Hinrunde__ aus Spielplan in Datei kopieren
  - Vereinsnamen durch Nummern ersetzen, __analog zur Reihenfolge der Teams im T3sports-Wettbewerb__
  - Spielschlüssel formatieren: 
      * **Bindestrich** zwischen gegeneinander spielende Teams;
      * **Komma** zwischen den Spielen;
      * **Pipe-Symbol** zwischen den Spieltagen.
      * **Beispiel:** 1-15,3-12,5-10,7-8,9-6,11-4,13-2,16-14|12-7,10-1,8-11,6-5,4-13,2-9,16-3,14-15|1-6,3-14,5-2,7-16,9-4,11-12,13-8,15-10|3-7,16-11,12-13,8-9,6-15,4-5,2-1,14-10|1-4,5-8,7-14,9-12,11-3,13-16,15-2,10-6|3-13,7-11,16-9,12-5,8-1,4-15,2-10,14-6|1-12,5-16,9-3,11-14,13-7,15-8,10-4,6-2|3-5,7-9,13-11,16-1,12-15,8-10,4-6,2-14|1-3,5-7,9-11,15-16,10-12,6-8,2-4,14-13|3-15,7-1,11-5,13-9,16-10,12-6,8-2,4-14|1-11,5-13,15-7,10-3,6-16,4-8,2-12,14-9|3-6,7-10,9-5,11-15,13-1,16-2,12-4,8-14|1-9,15-13,10-11,8-12,6-7,4-16,2-3,14-5|3-4,5-1,7-2,9-15,11-6,13-10,16-8,12-14|14-1,15-5,12-16,10-9,8-3,6-13,4-7,2-11

Der fertige Spielschlüssel kann dann im Wettbewerb eingefügt werden. Damit lässt sich nun der Spielplan im Modul erstellen, wahlweise die gesamte Saison oder aber nur Hin- oder Rückrunde (für die Rückrunde verwendet T3sports die Paarungen der Hinrunde und tauscht Heim/Auswärts).

----

==== Navigation zwischen Spielrunden ====

Für die Navigation zwischen den einzelnen Spieltagen wird der Wert aus dem Feld "Spielrunde" verwendet. Ist dieser nicht eingepflegt, besitzen alle Spiele den Wert "0" und eine Navigation zwischen den Spieltagen ist nicht möglich.

----

===== Snippets =====

Professionelles, sehr umfangreiches System zur Verwaltung von Sportvereinen, Liga- und Pokalwettbewerben. Spielerstatistiken, Liveticker und vieles mehr möglich.

==== Eigene Templates ====

<code typoscript>
# Eigene Templates:
plugin.tx_cfcleaguefe_competition {
  scopeTemplate = fileadmin/...
  matchtableTemplate = fileadmin/...
  leaguetableTemplate = fileadmin/...
  statisticsTemplate = fileadmin/...
  teamlistTemplate = fileadmin/...
  matchcrosstableTemplate = fileadmin/...
  tickerlistTemplate = fileadmin/...
  leaguetableAllTimeTemplate = fileadmin/...
  stadiumlistTemplate = fileadmin/...
}
</code>

----

==== Kompakt-Tabelle ====

<code typoscript>
lib.leagueTable < plugin.tx_cfcleaguefe_competition
lib.leagueTable {
  action = tx_cfcleaguefe_actions_LeagueTableShow
  leaguetableTemplate = fileadmin/...
  tablescope = 0
  tabletype = 0
  
  # UID des eigenen Vereins:
  leaguetable.tablecfg.markClubs = 1
  
  # UID des Wettbewerbs:
  competitionSelection = 2
}
</code>

----

==== Nächstes Spiel ====

<code typoscript>
lib.nextGame < plugin.tx_cfcleaguefe_competition
lib.nextGame {
  action = tx_cfcleaguefe_actions_MatchTable
  matchtableTemplate = fileadmin/...
  
  # Saison-UID(s), z.B. Liga, Pokal und Testspiele:
  saisonSelection = 4,5,6
  
  # UID des eigenen Vereins:
  clubSelection = 1
  
  # Nur Spiele der nächsten 30 Tage anzeigen:
  matchtable.timeRangeFuture = 30
  
  # Nur ein (das erste) Spiel:
  matchtable.options.limit = 1
  
  # Nur angesetzte und laufende Spiele anzeigen:
  # matchtable.fields.MATCH.STATUS.OP_IN_INT = 0,1
  
  # "Eigenen Teamnamen" ausblenden:
  matchtable.match {
    home =< lib.t3sports.teamSmall
    home {
      name.if {
        value = Eigenen Teamnamen
        equals.field = name
        negate = 1
      }
    }
    guest =< lib.t3sports.teamSmall
    guest {
      name.if {
        value = Eigenen Teamnamen
        equals.field = name
        negate = 1
      }
    }
  }
}
</code>

----

==== Verlängerung/Elfmeterschießen ====

Mit dem Marker ''MATCH_DCRESULTSUFFIX'' wird ein Zusatz ausgegeben, wenn im Spiel der Haken bei Verlängerung oder Elfmeterschießen gesetzt wurde.

**TypoScript:**
<code typoscript>
lib.t3sports.match.dcresultsuffix = COA
lib.t3sports.match.dcresultsuffix {
	20 = TEXT
	20.value = n.V.
	20.if {
		value = 1
		equals.field = is_extratime
	}
	30 = TEXT
	30.value = n.E.
	30.if {
		value = 1
		equals.field = is_penalty
	}
}
</code>

** Template-Teilstück (matchtable):**
<code html>
<!-- ###RESULT_STATUS_2### Ergebnis nach Spielende -->
  ###MATCH_GOALS_HOME###:###MATCH_GOALS_GUEST### ###MATCH_DCRESULTSUFFIX### (###MATCH_GOALS_HOME_1###:###MATCH_GOALS_GUEST_1###)
<!-- ###RESULT_STATUS_2### Ergebnis nach Spielende -->
</code>
**Ausgabe:** 3:2 n.V. (1:1). Die Marker zu Beginn geben den Endstand aus, in Klammern folgt der Halbzeitstand.

----

==== Ligatabelle: Scope als Select-Feld ====

Die Tabelle bietet Ansichten für Hin- und Rückrunde, Heim- und Auswärtsspiele. Um diese Links als Select-Feld anzulegen, benötigt man das folgende TypoScript und eine Änderung im //leaguetable//-Template.

**TypoScript:**
<code typoscript>
# Wraps ersetzen (nötig für Selectfeld bei Scope):
plugin.tx_cfcleaguefe_competition.leaguetable.controls {
  tabletype {
    current.wrap = selected="selected" value="/|"
    normal.wrap = value="/|"
  }
  tablescope {
    current.wrap = selected="selected" value="/|"
    normal.wrap = value="/|"
  }
  pointsystem {
    current.wrap = selected="selected" value="/|"
    normal.wrap = value="/|"
  }
}
</code>

**Template-Teilstück (leaguetable):**
<code html>
<!-- ###CONTROLS### start -->
<div class="cfcleague-scopeselection">
###CONTROL_TABLETYPE###
<select class="t3s-select" name="action" onChange="window.location=(this.options[this.selectedIndex].value);">
  <option ###CONTROL_TABLETYPE_NORMAL_LINKURL###>Normal</option>
  <option ###CONTROL_TABLETYPE_HOME_LINKURL###>Heimtabelle</option>
  <option ###CONTROL_TABLETYPE_AWAY_LINKURL###>Auswärtstabelle</option>
</select>
###CONTROL_TABLETYPE###

###CONTROL_TABLESCOPE###
<select class="t3s-select" name="action" onChange="window.location=(this.options[this.selectedIndex].value);">
  <option ###CONTROL_TABLESCOPE_NORMAL_LINKURL###>Saison</option>
  <option ###CONTROL_TABLESCOPE_FIRST_LINKURL###>Hinrunde</option>
  <option ###CONTROL_TABLESCOPE_SECOND_LINKURL###>Rückrunde</option>
</select>
###CONTROL_TABLESCOPE###

###CONTROL_POINTSYSTEM###
<select class="t3s-select" name="action" onChange="window.location=(this.options[this.selectedIndex].value);">
  <option ###CONTROL_POINTSYSTEM_POINT3_LINKURL###>3-Punkte-Regel</option>
  <option ###CONTROL_POINTSYSTEM_POINT2_LINKURL###>2-Punkte-Regel</option>
</select>
###CONTROL_POINTSYSTEM###
</div>
<!-- ###CONTROLS### end -->
</code>

---- 

==== Eigenes Team in Tabellen hervorheben ====

In Ligatabellen kann Tabellenzeilen mit dem eigenen Team eine CSS-Klasse hinzugefügt werden.

<code typoscript>
plugin.tx_cfcleaguefe_competition.leaguetable.table.markClub.override = fav-team
</code>

----

==== Datum formatieren ====

<code typoscript>
lib.t3sports.match.date.default.strftime = %d.%m.%Y &bull; %H:%M
</code>

----

==== Klammer um Platznamen entfernen ====

<code typoscript>
plugin.tx_cfcleaguefe_competition.matchtable.match.stadium.wrap >
</code>

----

==== Scopeselection: Aktiver Spieltag ====

Den aktiven Spieltag in der Spieltagsliste anders formatieren.

<code typoscript>
plugin.tx_cfcleaguefe_competition.scopeSelection.round.current.stdWrap.wrap = <span class="spieltag-act">|</span>
</code>

----

==== Spielplan-Ausgabe ohne eigenen Teamnamen ====

Teamnamen werden mit den Markern ''###MATCH_HOME_NAME###'' und ''###MATCH_GUEST_NAME###'' ausgegeben. Um nur den Gegner des eigenen Teams auszugeben, zum Beispiel in einem Spielplan, kann man das folgende TypoScript verwenden. Es entfernt den Inhalt des Markers, wenn er mit dem ''value'' übereinstimmt.

**TypoScript:**
<code typoscript>
# UID der Seite mit Spielplan-Ausgabe
[PIDinRootline = 4]
# "1. FC Köln" in Terminliste ausblenden:
plugin.tx_cfcleaguefe_competition.matchtable.match {
  home =< lib.t3sports.teamSmall
  home {
    name.if {
      value = 1. FC Köln
      equals.field = name
      negate = 1
    }
  }
  guest =< lib.t3sports.teamSmall
  guest {
    name.if {
      value = 1. FC Köln
      equals.field = name
      negate = 1
    }
  }
}
[global]
</code>
**Template-Teilstück (matchtable):**
<code html>
###MATCH###
<ul>
  <li>###MATCH_DATE###</li>
  <li>###MATCH_ROUND_NAME###</li>
  <li>###MATCH_HOME_NAME######MATCH_GUEST_NAME###</li>
  <li>###MATCH_STADIUM###</li>
</ul>
<!-- ###MATCH_FREE### Team hat spielfrei -->
<!-- ###MATCH_FREE### Team hat spielfrei -->
###MATCH###
</code>

----

==== Bildgrößen bei Spiel-Notiz, Typ 'Media' ====
<code typoscript>
lib.t3sports.teamnote.conf.tx_cfcleague_team_notes {
	1.file.maxW = 120
	1.file.maxH = 200
}
</code>

----

==== Teamnotizen ausgeben ====

<code typoscript>
lib.t3sports.profile.tntrikotnr =< lib.t3sports.teamnote
lib.t3sports.profile.tnposition =< lib.t3sports.teamnote
lib.t3sports.profile.tnphoto =< lib.t3sports.teamnote
</code>
<WRAP tip>
Der verwendete HTML-Marker muss im Notiz-Typ **klein** geschrieben werden!
Nur im HTML-Template wird er groß geschrieben:\\
###TEAM_PLAYER_TNPOSITION###
</WRAP>