Handbuch

Release-Notes

------------------------------------
V2.7a   unreleased

- Dokumentation aktualisiert

------------------------------------
V2.7    2024-03-13

- Erlaube das Abspielen eines Tons wenn neu gemischt wurde
  (Neue Einstellung im Admin-Menü und in der config.php)

- Nicht-numerische Barcodes vom ExcelImport ausgeschlossen, da sie fehlerhaft
  importiert wurden

- PHP 8.1-Kompatibilität

- Dokumentation aktualisiert

------------------------------------
V2.6a   2023-10-04

- Im Class-Modus zeigt der Reg-Bildschirm nun auch alle Class-Tänzer,
  unabhämgig vom Aktiv-Status, vorausgesetzt das Tanzprogramm passt.

- Excel-Import erlaubt nun alternativ auch Komma als Trennzeichen

- Doku-Ergänzungen

------------------------------------
V2.6    2022-11-07

- Fehlerkorrekturen im Excel-Import

- App-Admin-Authorisierung nun alternativ mit Kennwort statt über IP
  via neuem Parameter $to_conf['admin_pw'] in der config.php

- Problem bei der Tänzer-Umschaltung Beau/Belle aus den erweiterten
  App-Funktionen behoben

- Support für alte WampServer-Installationen eingestellt

------------------------------------
V2.5d   2022-08-30

- Anzeige für den Statistik-Überblick optimiert

- Kleine Fehlerkorrektur beim Formatieren von Barcodes mit führenden Nullen
  beim Auffüllen der Seite während des Barcode-Drucks

- Beim Excel-Import einige Steuerzeichen eliminieren

- Fehlerkorrektur: Auch Drucken eines einzelnen Barcodes zulassen

- Abschnitt "Behebung von Verbindungsproblemen" im WLAN-Kapitel des
  Handbuchs ergänzt.

- Neue Funktion "Setdancer" im Admin-Menü, mit der die Statusflags aller
  Tänzer zurückgesetzt werden können.

- Korrekturen an der ExcelImport-Funktion und Ergänzung der Option,
  auch Tänzer, die schon einen Barcode haben, beim Import anzulegen


------------------------------------
V2.5c   2019-11-11

- Eine neue Option "BFANS" kann verwendet werden um Tänzer abzustrafen,
  die versuchen, bei "wechelnden" Tänzen zu tricksen.

- Der ExcelImport kann jetzt auch Listen von Class-Teilnehmern importieren.

- Die Import-Funktion fragt nun nach, falls du versuchst, die Seite zu
  verlassen, bevor der Import abgeschlossen ist.

- Fehlerkorrektur: Lizenzberechnung für Linux-Systeme korrigiert

- Fehlerkorrektur: PHP7-Kompatibilität bei automatischer Bestimmung der
  Standardsprache

- Bessere Dokumentation des Wechselnd-Modus im Handbuch

------------------------------------
V2.5b   2019-03-10

- Fehlerkorrektur: Der neue Algorithmus aus v2.4 tendierte noch immer
  dazu, in bestimmten Situationen "double sit out" bzw. "not enough dancers
  found"-Fehler zu erzeugen, jetzt hoffentlich behoben.

- Fehlerkorrktur: In einer Situation, wo ein ganzer Square wegen einer
  unausgeglichenen Anzahl von Belles und Beaus aussetzen müsste, bricht
  das Programm das Mischen nun mit einer Fehlermeldung ab, die fordert,
  dass mehr Tänzer umgestellt werden, sodass sie beide Positionen tanzen.

- Fehlerkorrektur: Verhindere das Löschen von anwesenden Tänzern mit dem
  Dialog zur Bearbeitung der Tänzerdaten, da dies das Programm zerlegte.

- Feature: Mischen ist jetzt mit Barcodes "NEW" bzw. "OPEN" möglich.
  Das PDF mit den Spezialbarcodes enthält entsprechende Barcodes.

- Dokumentation für WLAN-Zugriff

------------------------------------
V2.5a   2019-02-21

- Fehlerkorrektur: Der neue Algorithmus aus v2.4 tendierte dazu,
  "double sit out"-Fehler zu erzeugen, insbesondere für kleine
  Gruppen (9 bis 15 Tänzer). Das sollte nun nicht mehr passieren.

- Fehlerkorrektur: Umschalten des "Pos-Modus" auf dem Admin-Bildschirm
  funktionierte nicht richtig.

- Fehlerkorrektur: Hinzufügen weiterer Barcode-Felder im Formular für
  die Bearbeitung der Tänzerdaten funktionierte nicht in älteren 
  Webbrowsern (solchen, die die outerHTML-Eigenschaft nicht unterstützen)

- Feature: Es ist jetzt möglich, einen Doppelt-Aussetzen-Fehler zu ignorieren.
  In bestimmten Situationen (z. B.  während einer Class mit 12 Teilnehmer, 
  die jeden Tip tanzen dürfen und 9 Angels), kann das notwendig sein.

- Feature: Die kleine Statistikbox, die während des Mischens angezeigt wird,
  enthält nun Links, mit denen man anzeigen kann, welche Tänzer im nächsten
  Tip eine bestimmte Position tanzen sollen. Das macht es einfacher im
  Fall einer unausgeglichenen Anzahl von Tänzer einige zu ändern.

- Viele neue Tänzer in dancer-190221-tri.data

------------------------------------
V2.5    2019-01-08

- Neu: Tänzer können jetzt mehr als zwei Barcodes haben. Verwende das
  "+"-Zeichen am Ende der Barcodeliste auf dem Bearbeitungsbildschirm für
  die Tänzerdaten um soviele Barcodes hinzuzufügen, wie du brauchst.
  Diese Änderung erforderte ein neues Format für die dancer.data-Datei
  und eine neue Datenbankstruktur.
  ACHTUNG 1: Nach der Programmaktualisierung bitte unbedingt die Funktion
  "Datenbank: Check" verwenden umd die Datenbank zu aktualisieren.
  ACHTUNG 2: Alte Programmversionen können das neue data.dancer-Dateiformat
  nicht lesen.

- Neu: Barcodes können nun auch nach einem vorgegenen Nummernkreis gedruckt
  werden.

- Fehlerkorrektur: Bei Benutzung der "Vermeiden"-Funktion konnte die Erzeugung
  neuer Tips fehlschlagen mit der Fehlermeldung 
  "Check tip error: Warning: sprintf() [function.sprintf]: Too few
  arguments in sd-v2.4/src/tipinc.php on line 168"

- Fehlerkorrektur: Bei Verwendung des Auffülltyps "wiederholen" beim
  Barcodedruck wurde zwischen Ende und Start der Wiederholungssequenz ein
  unsinniger Barcode gedruckt.

- Fehlerkorrektur: Die PDF-Dateien für den Druck von Barcodes und der
  Spezial-Barocdes enthielten HTML-Müll am Ende des PDF-Codes.

- Korrekturen und Aktualisierungen der Dokumentation

- Deutsche Release-Notes in der Datei "aenderungen.txt"

------------------------------------
V2.4     2018-10-16

- Ein neuer Algorithmus für die Entscheidung, welche Tänzer Beau und
  welche Belle tanzen, der hoffentlich den lang bekannten Bug des
  Programms behebt, der dazu führte, dass unerwünschte Trennungen fester
  Paare auftraten, insbesondere solcher Paare, die nicht genau aus einem
  Beau- und einem Belle-Tänzer bestehen.
  Dieser neue Algorithmus ist per Default aktiv und kann ggf. mit der
  Option "Pos-Modus" auf dem Admin-Schirm deaktiviert werden. In dem
  Fall würde ich um eine entsprechende Meldung an mich bitten.

- Auf dem Admin-Bildschirm zeigte seit ein paar Versionen die Anzeige
  für "Paare in der Class" den falschen Status, wenn sich das Programm im
  Modus "normal" oder "Students ignorieren" befand.

- Eine neue Option "wiederholen" für den Barcode-Druck barcode erlaubt
  es nun, den Rest der Seite mit einer Wiederholung der ausgewählten
  Barcodes zu füllen.

- Fehlerkorrektur: "Redo" führte zu einem Programmfehler wenn es bei einem
  Open Tip benutzt wurde, oder dann, wenn es keinen vorhergehenden Tip gab.

- Zusätzliche Dokumentation für das Format der dancer.data-Datei

------------------------------------
V2.3     2017-11-17

- Geänderter Lizensierungsalgorithmus für Windows 10
  Dieser wird (hoffentlich) dafür sorgen, dass Windows 10-
  Anwender in Zukunft auch bei großen Windows 10-Updates
  nicht mehr ihre Triangles-Rotation-Lizenz verlieren.

  Achtung: Windows 10-Anwender müssen nach dem Update ihre
  Triangles-Rotation-Lizenz aktualisieren.
  Der Lizenz-Update ist online und automatisch möglich.

- Zusätzliche Fehlerhinweise bei Verwendung über die Android-APP

- Intern:
  In Vorbereitung einer PHP-7-Kompatibilität wurden die POSIX
  regex-Funktionen durch PCRE und MySQL durch MySQLi ersetzt

- Intern:
  Testsuite für automatische Softwaretests angelegt

- Zusätzliche Dokumentation

- Korrekturen der Dokumentation

------------------------------------
V2.2g    2017-05-01

- Fehlerkorrektur: Seit V2.2f gab es das Problem, dass unter bestimmten
  Umständen nich möglich war, die Square-Anzeige mit dem "Anzeigen"-Link
  aus dem Menü nochmal anzeigen zu lassen.

- Fehlerkorrektur: Die Caller-Anzeige war kaputt, wenn drei Squares
  anwesend waren.

- Der Datenbank-Check zeigt nun bei möglicherweise doppelten Tänzern
  diejenigen Tänzerdatensätze, die schon zwei Barcodes haben, in roter
  Farbe an.

- Der Standardwert für die Anzahl der Anzeigespalten ist nun "3 falls 16:9"

- Nur für den Superuser: Erlaube einen "dancer only" export

------------------------------------
V2.2f    2017-03-12

- Fehlerkorrektur: Vermeide eine Fehlermeldung im "Eindeutige
  Namen"-Modus, wenn noch kein Tänzer anwesend ist.

- Fehlerkorrektur: Zweitbarcodes wurden nicht akzeptiert, wenn man versuchte,
  sie bei einem "AS COUPLES"-Barcode-Scan zur Verpartnerung zu benutzen.

- Fehlerkorrektur: Die "Zeige rote Outs"-Checkbox weigerte sich unter
  bestimmten Umständen, den ausgewählten Status beizubehalten.

- Eine neue Option "Kein Willkommen" erlaubt es, die Verwendung des
  Willkommen-Bildschirms komplett abzuschalten.

- Die bei "Autohide" angegebene Zeitspanne wird nun auch dann korrekt
  berücksichtigt, wenn man nach dem Mischen nochmal auf einen anderen
  Bildschirm gewechselt und dann auf "Anzeige" zurück gewechselt ist.
  Die Zeit zählt ab dem letzten Mischen, d.h. es geschieht kein
  automatischer Bildschirmwechsel, wenn die in "Autohide" angegebene
  Zeitspanne schon abgelaufen ist.

- Zusätzliche Dokumentation zur Fehlersuche

- Zusätzliche deutsch Übersetzungen der Dokumentation

- Korrekturen an der Dokumentation

------------------------------------
V2.2e    2016-11-15

- Neue Version der Tänzerdaten in 161115-dancer-tri.data

- Zusätzliche "lösch"-Option beim "Setclass" auf dem Adminbildschirm, um das
  Class-Kennzeichen bei allen Tänzern nach Classende zu löschen.

- Fehlerkorrektur: Eingabefeld unter dem Tänzernamen auf dem Callerbildschirm 
  (wieder) editierbar

- Verbesserte Verarbeitung von Drag & Drop mit der Maus auf dem
  Callerbildschirm

- Anpassungen für erweiterte Funktionen der App

- Zusätzliche Dokumentation

------------------------------------
V2.2d    2016-05-05

- Behebe einen Fehler, der in V2.2c entstanden war:
  Die "Square prüfen"-Funktion der App war defekt und zeigte statt der
  Tänzernamen eine Fehlermeldung "invalid field count"

------------------------------------
V2.2c    2016-03-24

- Beim Barcodedruck mit Fülltyp "alle" suche beim Auffüllen der
  Seite jeweils nach dem Namen der Tänzer, die zu den Füllbarcodes
  gehören und drucke ihn mit aus, falls dieser Barcode schon vergeben
  wurde.

- Eine neue Warnmeldung erscheint, wenn man versucht Squares zu mischen
  wenn die Anzahl der Belle- und Beau-Tänzer unausgeglichen ist (das
  funktioniert noch nicht perfekt, aber wird in zukünftigen Versionen
  noch weiter verbessert).
  Man kann die Meldung explizit ignorieren (was ich aber nicht
  empfehle).

- Wenn beim ExcelImport neu zu vergebende Barcodes gesucht werden,
  prüfe auch, ob der Barcode schon als Zweitbarcode vergeben wurde.

- Die neue Option "Uhr" auf dem Admin-Screen erlaubt es, eine
  Uhrzeitanzeige in der unteren rechten Ecke des Bildschirms zu
  aktivieren.
  (Achtung: Wenn die Uhr nicht erscheint, liegt das daran, dass dein
  Webbrowser die CSS-Datei noch im Cache hat. Du kannst ein Neuladen
  durch Aufruf von http://localhost/sd/triangles.css forcieren).

- Experimentelle Implementierung eines Drag & Drop für den
  Caller-Screen.

- Caller screen erlaubt nun Umschaltung zwischen der Anzeige von
  2 und 4 Squares

- Zeige die Menü-Info "Letzter Tip" rechts von den Caller-Menü-Einträgen
  an (falls die vorhanden sind)

- Experimenteller Work-Around der auf einigen kaputten Computern eine
  korrekte Anzeige der Tänzernamen erlauben soll.

- Experimentelle Version einer Blacklist, die das globale Löschen
  überflüssiger Tänzerdatensätze erlauben soll.

- Die App zeigt nun das Programmlevel des letzten Tips.

- Die App zeigt nun eine Fehlermeldung, falls die Generierung eines
  neuen Tips fehlgeschlagen ist.
  Dies erfordert eine App-Version >= 0.23, alte Apps zeigen
  "Server-Fehler"

- Die App im Admin-Modus zeigt nun die korrekte Anzahl von Squares auch
  während eines Open Tips.

- Weitere deutsche Übersetzungen.

------------------------------------
V2.2b    2015-10-29

- Verschiedene Verbesserungen im ExcelImport:
  - Erkennt nun auch C3b und C4
  - Clubname darf für existierende Tänzer nun leer sein, sodass
    die korrekten Werte in der Datenbank nicht mehr überschrieben werden

- Neue Barcode-Druck-Optionen:
  - Unterstützung für Papier im US-Letter-Format
  - Unterstützung für einen Druck von größeren Barcode-Karten

- Englische Übersetzungen für Fehler bei der Tipgenerierung ergänzt

- Dokumentationsaktualisierungen

------------------------------------
V2.2a    2015-05-18

- Fehler behoben, der in V2.2 eingeführt wurde, der dazu führt, dass
  mit der "Neuer Tänzer"-Funktion leider keine Tänzer mehr angelegt
  werden können.

- Programmcode für die Funktion "Automatisch eindeutige Namen" wurde
  komplett überarbeitet und dabei hoffentlich die Race-Condition
  entfernt, die dazu führtre, dass im Multiscreen-Modus gelegentlich
  falsche Kurznamen erzeugt wurden (insbesondere solche, die am Ende
  mehrere Punkte haben).

------------------------------------
V2.2     2015-05-03

- Neues "avoid"-Feature wurde implementiert.
  Bitte beachten, dass dazu eine Änderung der Datenbankstruktur
  erforderlich war. Nach einem Update muss mit "Check DB" aus dem
  Admin-Menü die Datenbankstruktur aktualisiert werden.
  Das Feature erforderte auch eine Änderung des dancer.data-Formats,
  d.h. alte Programmversionen können neue Exports der dancer.data nicht
  mehr lesen.

- dancer.data Format geändert (vgl. oben)

- Datenbankstruktur geändert (vgl. oben)

- Beim ExcelImport für Specials können nun auch die Zweitbarcodes
  verwendet werden, um die Tänzer zu identifizieren.

- Beim ExcelImport für Specials wird nun versucht, doppelte Tänzer zu
  erkennen.

- ExcelImport bricht nun mit Fehler ab, wenn ein falscher Zeichensatz
  erkannt wurde.

- Versuche einen Fehler zu beheben, der bei der Erzeugung von
  eindeutigen Namen dazu führen konnte, dass bei abgekürzten Namen mehrere
  Punkte auftauchen (ich glaube aber, das hat noch nicht richtig
  funktioniert.)

- Handbuch reorganisiert und Suchfunktion implementiert.

- Neue Admin-Einstellung "Square-Anordnung" beeinflusst die
  Standard-Square-Anordnung auf der Calleranzeige.

- Dokumentation und Übersetzung für die "setclass"-Funktion

- Zusätzliche deutsche Übersetzungen für einige Handbuchkapitel.

------------------------------------
V2.1f     2015-02-15

- Behebung eines gelegentlich auftretenden Fehlers auf
  dem Anzeigebildschirm, der dann nur eine leere Seite
  zeigt ("Seite 2 von 1")

- Neue Konfiguratonsoption "Paare in der Class", die es erlaubt,
  feste Verpartnerungen im Class-Modus zu ignorieren

- Der aktivierte "Class-Modus" wird nun im "Tip: Neu" angezeigt

- Bei leerer oder initialer Konfiugrationsdatenbank wird die
  Anzeigesprache mittels der Browsereinstellung erraten

- Tänzer-Locks auf nicht existierende Squares werden nun ignoriert

- Der Datenbank-Check warnt nun über möglicherweise doppelte
  Tänzerdatensätze

- ExcelImport entfernt nun Leerzeichen am Anfang und am Ende
  von Vor-, Nach- und Clubname

- Der Datenbank-Check entfernt nun ein einzelnes Leerzeichen
  am Ende der Vornamen (da diese den Auto-Eindeutige-Namen-Modus
  behindern)

- Die experimentelle Caller-Anzeige wurde verbessert und dokumentiert

- Zusätzliche Übersetzungen in den Statistiken

- Zusätzliche deutsche Übersetzungen einiger Handbuchkapitel

- Korrekturen in der Dokumentation

------------------------------------
V2.1e     2014-11-19

- Fehlerbehebung: Das Blättern der Tänzeranzeige benötigte
  noch immer die PHP-Einstellung "register_globals"

- Behebung eines Fehlers beim Import neuer Tänzer der in
  der Version V2.1d entstanden ist: Der Import brach bei inkonsistenten
  Daten ab.

- Experimentelle Unterstützung für eine Tänzer-Registrierung
  direkt aus der Android-App; dies schließt einen neuen
  Spezialbarcode "APP" ein, mit dem ein Sicherheitscode für
  den Zugriff aus der App erzeugt werden kann.

------------------------------------
V2.1d     2014-11-01

- Fehlerbehebung beim Blättern in der Tänzeranzeige, der in V2.1c
  eingeführt worden war

- Fehlerbehebung im "3 falls 16:9"-Spalten-Modus

- Versuche beim Import neuer Tänzer den Clubnamen zu setzen, falls
  der bisher unbekannt gewesen war

- Unterstützung für Admin-Funktionalität in der Android-App

- Unterstützung für eine "Square prüfen"-Funktion der App

- Zusätzliche Hilfe-Texte

- Zusätzliche deutsche Übersetzungen von Hilfe-Texten

- Alternativer Download-link für das bcompiler-Modul im Handbuch

------------------------------------
V2.1c     2014-09-12

- Es gibt eine neue Option, mit der zwischen den Bezeichnungen
  "Beau+Belle" oder "Boy+Girl" (das ist besonders in Mainstream- oder
  Plus-Clubs hilfreich, die mit "Beau" und "Belle" wenig anfangen
  können)

- Optional kann eine dreispaltige Tänzeranzeige gewählt werden (statt
  der standardmäßigen zweispaltigen Anzeige). Das ist besonders auf
  16:9-Bildschirmen praktisch, wo man sonst viel Platz verschenkt.

- Fehlerbehebung bei der Berechnung der Anzeigegröße

- Weitere Hilfetexte

- Weitere deutsche Übersetzungen von Hilfetexten

------------------------------------
V2.1b     2014-05-15

- Die mitgelieferte dancer.data-Datei enthält nun viele neue Tänzer,
  ich empfehle dringend, die mit der Import/Neu-Funktion zu importieren

- Fehlerkorrektur beim Import neuer Tänzer, der auftreten konnte, wenn
  der Barcode schon als Zweitbarcode eines anderen Tänzers existiert

- Fehlerbehebung beim Ergänzen von Zweitbarcodes zu Tänzern bei der
  Import/Neu-Funktion

- Behebung eines Fehlers im Dialog zur Tänzerbearbeitung, der zu
  Datenverlust führen konnte, nachdem ein Speicherversuch mit
  Fehler (z. B. "doppelter Barcode") abgebrochen war

- Fehlerbehebung beim Setzen des Partners im Dialog zur
  Tänzerbearbeitung, der zu defekten Verknüpfungen führen konnte

- Neue Unteroption "Reg. & Anzeige gemeinsam" für den Multiscreen-Modus

- Weitere Hilfetexte

- Weitere deutsche Übersetzungen von Hilfetexten

------------------------------------
V2.1a     2014-03-12

- Fehlerkorrekturen für den App-Modus (bezogen auf register_globals)
  (dieser Fehler entstand neu in V2.1)

- Fehlerkorrektur im Tänzerdaten-Bearbeiten-Dialog: Erlaube leeres M-ID-Feld
  (dieser Fehler entstand neu in V2.1)

- Erzeuge bei "Neuer Tip" eine Warnmeldung und frage nach einer Bestätigung
  falls der letzte Tip älter ist als 20 Stunden.
  (Normalerweise bedeutet das nämlich, dass vergessen wurde, die
  Tip-Statistik zurückzusetzen.)

- Tip Undo/Redo (einschließlich der Warnungen) funktioniert nun auch
  bei Open Tips.

- Es wird nun immer versucht, die Datenbanktabellen mit der Datenbank-
  Engine MyISAM zu erzeugen, da diese gerade auf langsameren Rechnern
  eine deutlich bessere Performance bieten.
  (Die Datenbank-Check-Funktion versucht jetzt, bestehende
  Datenbanktabellen auf diesen Typ umzustellen.)

- Korrekturen an der Prüfung/Erzeugung des Konfigurations-Caches; bisher
  konnte hier u.U. eine ungültige Konfiguration erzeugt werden, wenn
  das System auf einen anderen Rechner kopiert wurde.

------------------------------------
V2.1      2014-02-16

- Korrektur am Menü: Die Änderungen in Version v2.0j führten leider
  dazu, dass das Menü zu breit ist und am rechten Bildschirmrand
  etwas abgeschnitten wurde.

- Mischalgorithums verbessert: Der Effekt, dass man zu oft mit den
  gleichen Tänzern in einem Square tanzt, wärend man mit manchen
  Tänzern gar nicht tanzt ist nun deutlich verringert.

- Korrektur bei der Berechnung der Anzeigezeilen, die auf die Tänzer-
  anzeige passen.
  (Bitte beachten: Ihr müsst in Eurem Webbrowser im "Anzeige"-Dialog
  einmalig "big" oder "small" drücken, damit Eure Anzeige
  auf die neue Berechnung aktualisiert wird.)

- Überarbeiteter Code: Die PHP-Einstellung register_globals ist nun
  nicht mehr erforderlich.
  (Das bedeutet im Prinzip, dass die Anwendung nun PHP 5.4-kompatibel
  ist, leider gibt es für diese PHP-Version aktuell keinen
  funktionierenden bcompiler; ich suche nach einer Lösung...)

------------------------------------
V2.0k     unveröffentlicht

- Korrekturen der Hilfetexte

- Tänzermischalgorithmus verbessert: Der Effekt, dass man mit manchen
  Tänzern öfter im Square ist, mit anderen dagegen nie, ist nun reduziert.

- Korrektur des Top-Menüs: Änderungen aus Version v2.0j hatten dazu geführt,
  dass das Topmenü zu breit ist, sodass Teile am rechten Rand abgeschnitten
  wurden.

------------------------------------
V2.0j     2014-01-26

- Neu: Zweitbarcode für Tänzer
  ACHTUNG: Datenbankstruktur und dancer.data-Dateiformat haben sich geändert!

- Das Topmenü ist nun fixiert (scrollt nicht mehr), sodass die Navigation
  einfacher ist.

- Fehlerkorrektur: Beim Import neuer Tänzer wurde die Verpartnerung von
  Tänzern nicht richtig behandelt (es wurden bisher falsche und inkonsistente
  Verpartnerungen erzeugt)

- Korrekturen der Hilfetexte

------------------------------------

Zurück zu Inhaltsverzeichnis