EXT: Betgame for T3sports¶

What does it do?¶

This is an extension to create bet games for T3sports. ` *T3sports* <http://typo3.org/extensions/repository/?tx_terfe_pi1[ view]=search&no_cache=1&tx_terfe_pi1[sword]=t3sports>`_ is an extension to manage clubs and competitions. Each betgame consists of several bet rounds containing a list of matches to bet for. Results can be summarized for the whole game or round by round. There are also special bets on teams possible.

Mit dieser Extension können Tipsspiele auf Basis der Extension ` T3sports <http://typo3.org/extensions/repository/?tx_terfe_pi1[vi ew]=search&no_cache=1&tx_terfe_pi1[sword]=t3sports>`_ veranstaltet werden. Jedes Tipspiel besteht aus verschiedenen Tiprunden, denen individuell Begegnungen zugeordnet werden können. Die Auswertung erfolgt entweder auf das gesamte Tipspiel oder auf einzelne Tiprunden. Zusätzlich können Sondertips auf bestimmte Teams abgegeben werden.

Screenshots¶

Abbildung 1: Das Backendmodul

Abbildung 2: Tipabgabe im Frontend

Abbildung 3: Highscoreliste

How to create a betgame¶

The first step is to create a competition with some matches to bet for. This is done with T3sports as usual.

Der erste Schritt ist die Erstellung einiger Spiele, die man für das Tipspiel verwenden möchte. Dies geschieht über die normalen Funktionen von T3sports.

Abbildung 4: Einige Spiele anlegen. Hier die Vorrundengruppen A und B der EM 2008

Now it is possible to create a new bet game. Switch to module **T3sports->T3sports betgame* and select a SysFolder. This SysFolder will store all data for betgame.*

Abbildung 5: Im Modul T3sports befindet sich ein neues Submodul.

Jetzt können wir ein Tipspiel anlegen. Dafür wechseln wir in das Modul T3sports->T3sports Tipspiel und wählen im Seitenbaum den SysFolder, in dem alle Daten abgelegt werden sollen.

Create the betgame and fill out all fields. You have to select all competitions you want to bet for. Save and close the record and switch back to the module.

Bei der Erstellung des Tipspiel sollten alle Felder ausgefüllt werden. Bei den Wettbwerben müssen alle Wettbewerbe ausgewählt werden, für die später Tips abgegeben werden sollen. Der Datensatz kann nach der Bearbeitung gespeichert und geschlossen werden. Wir gelangen wieder zurück ins Modul.

Abbildung 6: In diesem Tipspiel können die Vorrunden der EM getippt werden.

Since version 0.3.x it is possible to create all betsets for a complete competition with one click. The wizard creates a betset for each round in competition. This wizard is available only, if no betset is found in the betgame .

Ab Version 0.3.x enthält die Extension einen Wizard, um ein Tipspiel aus einem kompletten Wettbewerb automatisch zu erstellen. Für jeden Spieltag werden einzelne Tiprunden angelegt. Der Wizard wird nur angeboten, wenn dem Tipspiel noch keine Tiprunden zugeordnet wurden.

Now we have a betgame, but still no bet round/bet set. So create one by clicking the marked button.

Wir haben nun ein Tipspiel, aber noch keine Tiprunde. Diese kann man aber einfach durch Klick auf den markierten Button erstellen.

Of course you have to select a betgame for the new round. It is also possible to set a name. Assure that you set a unique round number. The bet sets are order by this number. There are three possible states for a bet round:

• preparation – the round is not visible in frontend
• Open – Bets are possible in frontend
• Closed – The whole round is closed. No more bets can be made!

It is not necessary the select matches here. The is a better way in next step.

In der Tiprunde muss natürlich das Tipspiel zugeordnet werden. Außerdem können wir einen Namen vergeben. Es gibt drei Stati:

• Vorbereitung - Spiele im FE nicht sichtbar
• Offen - Spiele der Runde können im FE getippt werden
• Beendet – die gesamte Tiprunde ist beendet. Keine Tips mehr möglich

Abbildung 7: Die Spiele werden über das Modul zugeordnet

Die Spiele müssen hier noch nicht zugeordnet werden, daß geschieht einfacher im nächsten Schritt. Save and close this record. Now we want to set the matches for this round. Press the button **Add matches to betset* . The new screen comes up with a competition selector. Do you remember the bet game record? Here is your selected competition again. So you can join all matches from different competitions into one betgame. Simply mark the matches and press Join matches .*

If your bet round is complete you can finally change the state to **Open* . Of course you can add more match round if you wish.*

Abbildung 8: Die Zuordnung der Spiele erfolgt mit dem Backendmodul.

Nachdem die Tiprunde gespeichert und geschlossen wurde, kann man im Modul auf den Button Der Tiprunde Spiele hinzufügen klicken. Jetzt finden wir auch die vorhin ausgewählten Wettbewerbe wieder. Wie man sieht, kann man somit Spiele aus beliebigen Wettbewerben in einem Tipspiel kombinieren. Nun einfach die gewünschten Spiele markieren und in die Tiprunde übernehmen.

Wenn alle gewünschten Spiele zugeordnet sind, kann der Status auf Offen geändert werden. Die FE-Nutzer können dann ihre Tips abgeben.

Team bets¶

Starting with version 0.4.0 it is possible to create special team bets. So you can ask questions like “Which team will be winning the cup?”. The possible points for a bet can be changed over the time. The players will always get the points available at the time of betting.

Ab Version 0.4.0 können Sondertips zu Teams erstellt werden. So kann man im Vorfeld nach dem kommenden Meister fragen. Die möglichen Punkte können dabei im Laufe der Zeit verändert werden. Die Spieler erhalten am Ende immer die Punkte für den richtigen Tip, die zum Zeitpunkt der Tipabgabe eingestellt waren.

The frontend tasks¶

To enable our users to bet for matches, we need to setup the frontend pages. Normally you need three pages: one for the upcoming bets, one for finished bets and a highscore list. The highscore page can be accessible by anyone, for the other pages a logged on user is needed.

Abbildung 9: Drei FE-Seiten für das Tipspiel

Damit die Nutzer im Frontend Tips abgeben können, müssen wir natürlich die entsprechenden Seiten einrichten. Üblicherweise benötigen wir dafür drei Seiten: eine für die aktuellen Tips, eine für die beendeten Tiprunden und eine Highscoreliste. Letztere kann öffentlich zugänglich gemacht werden. Die anderen beiden Seiten benötigen einen angemeldeten FE-User.

The plugin has two possible views: **List of bet sets* and Highscore list . Put one plugin at each page. At the highscore page select the view Highscore list , at the other page select view List of bet sets . With the tab dividers you can set additional information. To select the betgame to show. In List of bet sets you can also defined the state of betsets to show. In page for upcoming bets select Open and Finished for finished bets page.*

Abbildung 10: Die Detailangaben zu den Views werden in den entsprechenden Tabs gesetzt.

Abbildung 11: Die Tiprunden werden nach ihrem Status angezeigt

Das Plugin hat zwei mögliche Views: Liste der Tiprunden und die Bestenliste. Die Liste der Tiprunden verwenden wir sowohl für die aktuellen Tips als auch für die Tip-Historie. Der Status muss entsprechend ausgewählt werden. Und natürlich muss immer auch das gewünschte Tipspiel ausgesucht werden.

Abbildung 12: Mögliche Ausgabe im Frontend

Since version 0.3.0 it is possible to show finished bets from other users. This is done from highscore list with a link for each user. This link targets to another page with a betlist. In plugins flexform of this betlist enable the option Allow user from request . You should also use a special HTML template for this view without any form elements. Have a look at ext:t3sportsbet/templates/userbetlist.html .

Mit der Version 0.3.0 ist es möglich beendete Tips anderer User anzuzeigen. In der Bestenliste wird dafür ein Link für die Nutzer gesetzt, der auf eine weitere, neue verweist. Auf dieser Seite muss wiederum ein Plugin mit der Liste der Tiprunden angelegt werden. Im Flexform muss die Option Nutzer aus Request erlauben gesetzt werden. Zusätzlich sollte ein modifiziertes HTML-Template ohne Formular-Elemente verwendet werden. Als Vorlage kann das Template ext:t3sportsbet/templates/userbetlist.html dienen.

After the matches¶

When some matches are over and all bets are done, it is time to score the results. At first you need to set the match results with module **T3sports->Edit matches* . Don't forget to set the match status to finished! If this is done, switch back to module T3sports->Bet game . You will see the finished matches and the results. Now you can press the button Analyze bets and all available bets are scored.*

It is not necessary the wait for all matches to be finished. You can score the results as often as you want. The system takes care about which bets to score. If all matches of a bet set are finished and scored, you should set the state to Finished. This will move that bet set in frontend to bet history page.

Nachdem die Spiele vorbei sind und hoffentlich zahlreiche Tips abgegeben wurden, kann die Auswertung erfolgen. Dafür müssen zunächst über das Modul T3sports->Spiele bearbeiten die Spielergebnisse eingetragen werden. Ist das geschehen, wechselt man wieder zum Modul des Tipspiels. Hier sieht man nun in der Tiprunde die beendeten Spiele. Mit dem Button Tips auswerten, startet man die Auswertung.

Es ist nicht notwendig auf die Beendigung alles Spiele zu warten. Das System erkennt selbstständig welche Spiele noch ausgewertet werden müssen. Ist eine Tiprunde komplett beendet, sollte der Status auf Beendet gesetzt werden. Dadurch wandern die Spiele im Frontend in die Tiphistorie.

FAQ¶

Installation¶

You can install this extension as usual with extension manager from TER. Please install all required extensions too. Otherwise you will maybe crash your TYPO3 system!

After install add the static template to your Typoscript Template. The CSS template is optionally and not more then an example.

Die Extension wird wie üblich mit dem Extension-Manager installiert. Es müssen alle abhängigen Extensions mit installiert werden, da sonst unter Umständen TYPO3 nicht mehr richtig funktioniert!

Für die FE-Ausgabe muss das Static-Template der Extension in das Typoscript-Template der Seite eingebunden werden. Das CSS-Template ist optional und soll nur als Beispiel dienen.

HTML-Templates¶

The default HTML template should be copied to a folder under fileadmin. Then you can link to either in the plugin or with TS- Constant-Editor.

Abbildung 13: Templatezuordnung über den TS-Contant-Editor

Die mitgelieferten HTML-Vorlagen sollten unter den Fileadmin kopiert werden. Die Zuordnung erfolgt dann entweder direkt im Plugin oder über den TS-Contant-Editor.

FAQ¶