--------------------------------------
[INFUSION] Penalty-Challenge V1.3 (v7)
Fr PHP Fusion Version 7.x
by Sunday (ChSchuetz.de)
--------------------------------------

-------------
0. Einleitung
-------------
Penalty-Challenge ist ein kleines Fungame, das
fr das CMS PHP-Fusion programmiert wurde.

Als angemeldeter User kann man andere Benutzer der
Seite zu einem Elfmeter-Shootout herausfordern.
Jeder Spieler muss dabei drei Schsse und drei Paraden
abgeben. Haben beide Spieler ihren Zug gemacht, wird
die Runde ausgewertet. 
Fr einen Sieg gibt es drei, fr ein Unentschieden
einen Punkt. 
Eingegangene Herausforderungen knnen auch abgelehnt werden,
der Gegner gewinnt dann kampflos mit 3:0.

Optional kann auch das UserGold-System verwendet werden,
falls installiert. Als Grundlage diente bei der Entwicklung
das UserGold-System in der Version "2.0.1" von "AusiMods".

NEU in Version 1.3: Turniermodus !
Bei aktiviertem Turniermodus, wird die Zeitsperre (falls aktiviert)
auer Kraft gesetzt.

-------------
0.1 Changelog
-------------
Version 1.3 (v7)
- Version 1.3 fr PHP-Fusion 7.x umgeschrieben

Version 1.3
- Einige unbedeutende Codeanpassungen durchgefhrt
- Turniermodus eingebaut
- Ewige Tabelle eingebaut
- Danish.php (locale) fr das Panel (Danke an insideout)

Version 1.2
- $db_prefix beim PM-Versand eingesetzt
- Avataranzeige bei Details, Herausforderungen, letzte Matches, Tabelle eingebaut
- Abfrage Goldsystem bei der Auswertung optimiert, sodass bei ausgeschaltetem Goldsystem
keine Fehlermeldung mehr auftaucht.

Version 1.1
- Der Link zur Detailansicht der Matches wird nun fett dargestellt
- Bestenliste-Bug wurde beseitigt (Einige Spiele tauchten nicht auf)
- Bestenliste kann ber den Admin Bereich neu berechnet werden.
Fr neue Features siehe nchsten Abschnitt.

----------
1 Features
----------
.:: User ::.
- Herausforderungen aussprechen
- Herausforderungen annehmen und ablehnen
- Herausforderungen nach bestimmter Zeit zurckziehen
- Anzeige offene und eingegangene Herausforderungen
- Anzeige letzte Matches (inkl. Details)
- Anzeige Bestenliste
- [NEU] Anzeige ewige Bestenliste

.:: Admin ::.
- Admin Panel
- Private Nachrichten (de-)aktivieren
- Goldsystem (de-)aktivieren
- Einstellen Anzahl Gold fr Sieg und Unentschieden
- Einstellen Anzahl angezeigter Herausforderungen
- Einstellen Anzahl angezeigte letzte Matches
- Einstellen Anzahl angezeigter Spieler in Bestenliste, danach Seitenumbruch
- Zeitsperre aktivieren
- Einstellen wieviele Herausforderung pro Zeitraum erlaubt
- Zurckziehen von Herausforderungen (de-)aktivieren
- Auswahl Variante Bestenliste (4 Varianten)
- Neuberechnung der Bestenliste
- [NEU] Archivierung der Bestenliste (-> Ewige Bestenliste)
- [NEU] Turniermodus (de-)aktivieren
- [NEU] Anzahl Matches fr Turnier festlegen

---------------------------------------
2. Installation
---------------------------------------

2.1  Neuinstallation
---------------------------------------
Fr die Neuinstallation wird die Datei "update.php" nicht 
bentigt und kann daher vor dem Upload gelscht werden.

Der komplette Ordner "penalty_challenge" muss in das
"infusions"-Verzeichnis der PHP-Fusion Installation kopiert
werden.

Danach kann die Infusion ber System Admin -> Infusionen
installiert werden. Die bentigten MySQL-Tabellen werden dann
automatisch angelegt.

Nach der Installation findet sich in der Navigation ein
Link zur Penalty-Challenge, der nur fr Mitglieder sichtbar 
ist und schon knnen die Spiele beginnen.

Fr den Admin wird unter "System Admin" -> "Infusionen" ein
ensprechender Bereich angelegt.


2.2  Update von lterer Version
---------------------------------------
Der komplette Ordner "penalty_challenge" muss in das
"infusions"-Verzeichnis der PHP-Fusion Installation kopiert
werden.

Dann muss per Hand die Datei "infusions/penalty_challenge/update.php"
aufgerufen werden. Die erforderlichen Tabellenupdates werden dann
vorgenommen. Danach sollte die "update.php" gelscht werden.

Fr den Admin wird unter "System Admin" -> "Infusionen" ein
ensprechender Bereich angelegt.

Nach dem Update sollte ber den Admin-Bereich die Bestenliste
neu berechnet werden, um den in Version 1.0 vorhandenen Fehler
zu korrigieren.

2.3 Installation Penalty Challenge Panel
---------------------------------------
Das penalty_challge_panel kann im linken oder rechten Bereich der Seite
eingebunden werden. Es zeigt an, ob fr den angemeldeten User Herausforderungen
vorliegen und einen Ausschnitt der Bestenliste.
Lade hierzu den penalty_challenge_panel Ordner in das infusions-Verzeichnis Deiner
PHP-Fusion Installation.
Dann muss ber System-Admin -> Panels ein neues Panel mit Angabe "penalty_challenge_panel"
angelegt werden.


2.4 Integration ins Benutzerprofil
---------------------------------------
Man kann einen Button in die Benutzerprofile setzen, der es mglich macht,
einen User ber das Profile direkt heraus zu fordern.
Dazu muss der folgende Code in die profile.php eingefgt werden:
(VORHER BITTE EIN BACKUP DER DATEI MACHEN !!)

_______________________________________________
if (iMEMBER && $lookup != $userdata['user_id'])
{
opentable("");
$lnk = INFUSIONS."penalty_challenge/penalty_challenge.php?act=challenge&uid=".$lookup;
echo '<form method="post" action="'.$lnk.'">';
echo '<table width="50%" cellspacing="1" cellpadding="3" border="0" align="center">
<tr>
<td align="center"><b>Penalty Challenge</b><br><input type="submit" value="Herausfordern" class="button"></td>
</tr></table>';
echo '</form>';
closetable();
}
_______________________________________________


2.5  Deinstallation
---------------------------------------
"Panelty-Challenge" kann ber "System Admin" -> "Infusionen" deinstalliert
werden. ber PhpMyAdmin sollte sichergestellt werden, dass die
folgenden Tabellen gelscht worden sind:
- penalty_challenge
- penalty_tbl
- penalty_cfg
Falls die Tabelle nicht vollstndig gelscht werden sollten, kann
dies per Hand geschehen.


3. Schlusswort
----------------------------------------
So, und nun viel Spa mit diesem kleinen Spielchen
und viel Erfolg.

Bei Fragen, oder Problemen bitte im Forum auf
www.php-fusion.de melden oder einfach per eMail
an chris [at] chschuetz [punkt] de.