Manual

Release notes

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

- Allow playing of a sound when squares have been mixed
  (New admin setting & new config.php setting)

- Excluded non-numerical barcodes from ExcelImport, as they were imported
  wrong

- PHP 8.1 compatibility

- Documentation updates

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

- In class mode, the reg screen in active mode now also shows
  class dancers independend of the active flag, provided the 
  dance program matches.

- Excel import now also accepts comma as separation character.

- Documentation updates

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

- Error corrections on the Excel import

- App admin authorization now alteratively with password instead via IP
  using new parameter $to_conf['admin_pw'] in config.php

- Fix problem in changing dancer beau/belle from app extended functions

- Removed support for old WampServer installations

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

- Optimised display for statistics overview

- Corrected a small error in formatting barcode numbers with leading
  zeroes when filling up the page during barcode print

- Eliminate some control characters during an Excel import

- Bugfix: Allow for printing a single barcode

- Added a section "Troubleshooting connection problems" in the Wifi section of
  the manual.

- New function "Setdancer" on the admin menu, that allows to reset the
  status flags of all dancers.

- Corrections to the ExcelImport function and the new option to also create
  dancers that already have an barcode.


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

- A new option "PVLLS" can be used to punish dancers that try to trick
  the program on "alternating" dances.

- The ExcelImport function now can also import class member lists.

- The Import function now asks if you try to leave the page before an
  import has completed. 

- Bug fix: License calculation fixes for Linux systems

- Bug fix: PHP7 compatibility for automatic determination of default language

- Better documentation of the "Alternating" mode in the manual

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

- Bug fix: The new algorithm introduced in v2.4 still tended to produce
  "double sit out" or "not enough dancers found" errors under certain 
  circumstances. Hopefully better now.

- Bug fix: In a situation where a whole square would have to sit out
  because of an unbalanced number of belles and beaus the program now
  aborts mixing with an error message, requesting to switch more dancers
  to dance both positions.

- Bug fix: Prevent active dancers from being deleted in the edit user dialog
  during a dance, as this did break the program.

- Feature: You can now mix using the barcodes "NEW" or "OPEN".
  The special barcode PDF now also provides these codes.

- Documentation for WiFi access

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

- Bug fix: The new algorithm introduced in v2.4 tended to produce
  double sit out errors, especially often for small groups (9 to 15 dancers).
  This shouldn't happen any longer. 

- Bug fix: Switching of "posmode" on the admin screen did not work correcty.

- Bug fix: Adding additional barcode fields on the user edit screen did
  not work on older web browsers (not supporting the outerHTML property)

- Feature: It is now possible to ignore a double sit out error.
  In certain situations (e. g. during a class with 12 class members
  that are allowed to dance every tip and 9 angels), this might be
  necessary.

- Feature: The mini statistic box shown when mixing the squares has now
  links that allow you to list dancers scheduled to dance a special dance
  position. In case of an unbalanced number of dancers, this makes it easier
  to change some of the dancers.

- Many new dancers in dancer-190221-tri.data

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

- New: Dancers can now have more than two barcodes. Use the "+" marker at the
  end of the barcode list on the user edit screen to add as many barcodes as
  you need.
  This required a new dancer.data file format and a new database structure.
  NOTE 1: After an upgrade, use the "database: check" function to
  update your database.
  NOTE 2: Old program versions will not be able to import the new data.dancer
  file format.

- New: Barcodes can now be printed for a given number range.

- Bug fix: When using the "avoid" feature, tip gereration could fail 
  with error message
  "Check tip error: Warning: sprintf() [function.sprintf]: Too few
  arguments in sd-v2.4/src/tipinc.php on line 168"

- Bug fix: When using filltype "repeat" for barcode printing, a useless
  barcode was printed between the end and the start of the repeat sequence

- Bug fix: Barcode and Special barcode PDF files contained HTML garbage 
  after the end of the PDF code

- Documentation fixes and updates

- German language release notes in the file "aenderungen.txt"

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

- New algorithm for deciding who dances beau and who dances belle, that
  hopefully solves the long known bug of the program that led to unwanted
  splits of fixed couples, especially of couples that are not composed of
  exactly one beau and one belle.
  This is enabled by default and can be deactivated using the new 
  "Pos mode" option on the admin screen. Please report if you should run
  into problems.

- On the admin screen, the "Class couples" setting showed
  the wrong status when in "normal" or "ignore students" mode

- A new option "repeat" for barcode printing allows to fill
  the rest of the page with a repetion of the selected barcodes.

- Bug fix: Redo breaks the program when used on an open tip or
  with no previous tips.

- Additional documentation for dancer.data

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

- Modified licensing algorithm for Windows 10
  This will (hopefully) save Windows 10 users from losing 
  their Triangles Rotation license on major Windows 10 updates.
  Note: Windows 10 users will need to get an update of their Triangles
  Rotation license key! The update can be obtained online and automatically.

- Additional error indications for usage via Android API

- Internal: 
  In preparation of PHP 7 compatibility, replace POSIX regex functions with
  PCRE, and MySQL with MySQLi

- Internal: 
  Created a test suite for automatical software tests

- Additional documentation

- Documentation fixes

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

- Bug fix: V2.2f introduced the problem that under special circumstances
  it was impossible to get back the display screen using the "Display"
  link from the menu.

- Bug fix: Caller display was broken when three squares were present.

- DB check now displays possible duplicate dancers records that already have
  two barcodes in red color.

- Default value for display columns now "3 if 16:9"

- Superuser only: Allow a "dancer only" export

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

- Bug fix: Avoid error message on auto unique names if no dancer is present

- Bug fix: Secondary barcodes were not accepted when trying to set partner
  with an "AS COUPLES" scan

- Bug fix: "Red out" checkbox on admin screen kept loosing its checked status

- New "no welcome screen" option allows to eliminate the welcome screen

- "autohide" will still be honoured after a manual switch to "display" mode.
  Time counts from last mixing, no autohide will occur when manually switching
  to the display after the autohide time period has already expired.

- Additional troubleshooting documentation

- Additional German documentation translations

- Documentation corrections

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

- New dancer database file 161115-dancer-tri.data

- Additional "delete" option for "Setclass" to delete the class flag of all
  dancers once a class has ended.

- Bug fix: make input field below the dancer names on caller screen
  editable (again)

- Improved mouse drag & drop on caller screen 

- Modifications for extended app functions

- Additional documentation

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

- Fix a bug introduced in V2.2c:
  The "check square" function of the app was broken and showed
  an error message "invalid field count"

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

- On barcode printing with fillup type "all", when
  filling up the page, lookup and print dancer names for codes 
  already assigned

- A new warning message will occur when you try to mix squares but
  have an unbalanced number of belles & beaus (this does not yet
  work perfectly, will be improved in a later version).
  You can explicitly ignore this message (but this is not recommended).

- When searching free barcodes for new assignments in ExcelImport, 
  also check alternate barcodes.

- The new admin screen option "clock" now enables display of a clock
  in the lower right corner of every screen.

- Experimental drag & drop implentation for caller screen

- Caller screen allows to toggle between 2 and 4 squares

- Move menu info "Last tip" behind Caller menu entries (if present)

- Experimental work around for correct Reg & Display screen 
  representation of accented letters on some broken computers

- Experimental version of a blacklist to allow global deletion of
  obsolete dancer records 

- App shows program level of tip

- App now shows error messages if tip generation failed.
  Requires app version >= 0.23, older apps will show "Server error"

- App in admin mode now shows correct number of present squares for open tip

- Additional German translations

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

- ExcelImport now also recognizes C3b and C4

- ExcelImport now allows dancer name and gender flag
  to be empty if a barcode is given.

- ExcelImport now allows club name to be empty for
  existing dancers; their club name will remain unchanged
  in that case.

- Three new paper formats added for barcode printing:
  Support for US Letter format and printing of bigger
  barcode cards

- Translations for error messages in tip generation added

- Documentation updates


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

- Fixed a bug introduced in V2.2 which broke the "New dancer" function.

- Rewritten code for "auto unique names", now hopefully removing the race
  condition that could lead to wrong short names in Multiscreen mode
  (especially short names with multiple dots at the end).


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

- New "avoid" feature added.
  Please note that this required a change of the 
  database structure, so use "check database" after the update
  to modify your database accordingly.
  This feature also required a change of the dancer.data
  format, this means that older versions of the program
  will not be able to read newer exports of the dancer.data
  file.

- dancer.data format changed (see above)

- Database structure changed (see above)

- On ExcelImport for specials, also the secondary barcode
  can be used to identify the dancer

- On ExcelImport for specials try to recognize duplicate imports

- Abort ExcelImport on detection of wrong character set

- Corrected a bug on the automatic creation of unique names
  which could result in short names having a dot too much
  at the end.

- Reorganized manual and added a search function

- New admin screen setting "square arrangement" modifies default
  square ordering on the caller display

- Documentation and translation of "setclass" function

- Additional German translations of some manual chapters

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

- Correct a display paging error that occasionally could
  lead to a display of an empty page ("Page 2 of 1")

- New configuraton option "Class couples" allows to ignore 
  fixed couples during class mode

- Indicate activated "Class" mode in "New" link

- On empty configuration, guess language using browser settings

- Ignore locks to non-existing squares

- Check database now warns about possibly duplicate dancer records

- ExcelImport now drops leading and trailing spaces on first, last
  and club names

- Check database removes a single trailing space on first names
  (as those break the unique names mode)

- Improved and documented the experimental caller display

- Additional translations on statistics

- Additional German translations of some manual chapters

- Corrections in documentation 

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

- Bug fix: paging of dancer display still
  required "register_globals"

- Bug fix on Import new dancers that was introduced
  in V2.1d: Import stops on inconsistent data

- Experimental support for registering dancers
  via the Android app; this includes a new 
  special barcode "APP" which creates a security
  code for access from the app

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

- Bug fix on paging of dancer display that
  was introduced in V2.1c

- Bug fix on "3 if 16:9" columns mode

- On "import new dancers" try to import club names
  of dancers where the club name was unknown

- Support basic admin functionality for the app

- Support for "check square" function of the app

- Additional help texts

- Additional German translations of help texts

- Alternative download link for bcompiler binary in manual


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

- New option for switching between dancer position naming "Beau+Belle" 
  or "Boy+Girl"

- Optionally allow three column dancer display (instead of the
  standard two columns).

- Corrected a bug on display size calculations

- Additional help texts

- Additional German translations of help texts


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

- Corrected a bug on importing new dancers where the dancer barcode
  already exists as secondary barcode 

- Corrected handling of adding secondary barcodes on import of new
  dancers

- Corrected a bug in the edit dancer dialog which could corrupt data
  after an error message (e.g. duplicate barcode) occured on "save"

- Corrected a bug on setting partners in the edit dancer dialog
  which could lead to broken relation links.

- New sub option "shared reg & disp" for multiscreen mode

- Additional help texts

- Additional German translations of help texts

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

- Bug fixes for app mode (register_globals related)
  (this bug was introduced in V2.1)

- Bug fix on edit dancer data: allow empty M-ID field 
  (this bug was introduced in V2.1)

- Produce a warning message and ask for a confirmation of "new tip" 
  when the last tip is older than 20 hours.
  (as this probably means that you just forgot to reset tip statistics)

- Tip undo/redo (including warnings) now also works in combination 
  with open tips.

- Always try to create database tables with ENGINE MyISAM
  for better performance on slower computers.
  (Database check function now also tries to change type of existing
  tables.)

- Corrections in check/creation of configuration cache which
  could lead to an unusable configuration when copying the program
  on to a different system.

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

- Corrections in help texts

- Corrected calculation of line height on font size change for 
  dancer display table
  (Note: you probably need to adjust your browser to the new
  calculation by using the "big" or "small" function on the display
  screen once)

- Reworked code: PHP setting register_globals is no longer needed
  (Although this means that the application is now PHP 5.4 compatible,
  unfortunately there is no working bcompiler for that PHP version
  available; searching for a solution...)

------------------------------------
V2.0k     unreleased

- Corrections in help texts

- Dancer mixing algorithm improved: The effect of dancing too often
  with the same dancers in one square while not dancing with some
  others is now reduced.

- Correction on top menu: Changes of version v2.0j led to top menu
  being too wide so that a part was cut off at right screen border.

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

- New secondary barcode for dancers
  NOTE: Database structure and dancer.data format changed!
- Top menu now fixed against scrolling for faster navigation
- Error correction: Do not import partnership relations for "new"
  dancers (created wrong and inconsistent relations in previous version)
- Corrections in help texts

------------------------------------
V2.0i     2014-01-18

- New option "max squares" to limit number of squares
- Correct an error in dancer list (special flag not displayed
  correctly)
- Add display of active flag in dancer list
- Correct an error affecting the possible partners available
  in the edit user dialog
- Some code cleanup
- More help
- Correct error on recreating binconf.php
- Better error message for missing binary version

------------------------------------
V2.0h     2013-12-02

- Error corrections for Android app
- Change timeout for special scan messages from 2 min to 20 sec
- Add "autocomplete off" to scanner input field to avoid input hints
  on some browsers
- Start rework of bilingual scanner messages
- Some code cleanup

------------------------------------
V2.0g     2013-11-19

- Implement $to_conf['ip_allow'] to restrict access for non-app requests
- Modified for use with Android client app
- Additional documentation & translations
- Code cleanup for welcome screen

------------------------------------
V2.0f     2013-11-08

- Check for duplicate barcodes on edit dancer record
- Fixed a bug on importing a dancer record with no level flags set
- Additional translations
- Partial restructuring of docs
- Additional documentation
- Changed file format to DOS (LF->CR/LF) to avoid problems of 
  users editing the file on Windows
- Error correction for selection of "omit own" for regmode "special"

------------------------------------
V2.0e     2013-10-25

- If a ../config.php exists, this will take precedence over
  ./config.php; this makes it possible to keep a local config.php
  during updates
- Add header
- Hide short name when autonames option is switched on
- Time limited license
- New config.php.template as real template, remove old config.php
- New help index and general operation chapters 
- Use HTML entities for Umlauts in doc
- Link to manual index

------------------------------------
V2.0d     2013-09-18

- Fix top margin for page layout b for barcode printing
- Try to reduce tendency to set dancers into same square number as
  before
- Bug fix for import of short barcodes
- Bug fix for setting of dancer program level on excel import
- Bug fix set level for new dancers
- Bug fix: Level Special barcode scan did not set level in database

------------------------------------
V2.0c     2013-08-10

- Fix error "cannot load font metric file"
- More translations en->de added
- Add consistency check function for admin
- Fix font for show raw database config
- Take account of PHP word size: different bytecode per version
- Compile only for highest bytecode version
- Add uname to binconf and ignore config on change in uname
- New sysinfo.php utility for debugging purposes

------------------------------------
V2.0b     2013-07-21

- Default sd logo for welcome screen
- Started to implement multi language support
- Moved all images to new img dir

------------------------------------
V2.0a     2013-07-19

- Implement alternating dance programs
- Switch from HTML barcodes to PDF
- Prefer Code128-C over Code128-A/B
- Print all barcodes into a single (posibly multi page) document
- Bigger font for names
- Sorting corrected (also use last name)
- Add printing for special barcodes
- Some corrections in help texts
- Better documentation of barcode printing selection
- Doc of paper type
- Doc of red out
- Changed format of table tip to include dance level
- Implement alternating dance program
- Show dancer progs when dancer registers
- Implement INFO special barcode
- Implement PrXX special barcode
- Bugfix punishmode
- Prefer low prog dancers on low prog tips of alternating dances
- On alternating dances, for the high prog tips use mainly high tip dances
  to calculate equal sitouts
- Add regmode dancer marking in alternate mode (higher level
  dancer get a >> in front of their name
- Implement "red out" option
- Add statistics for alternating dance programs in tri_lese_tips 
  and InOut stat display
- Code cleanup
- remove now unused old functions tri_optimize_sitouts, TesteTaenzerTausch,
  HatSeltenerGetanzt

------------------------------------
V2.0      2013-07-07

- Introduce flags for B, MS, PL

------------------------------------
V1.7a     2013-07-06

- Change default page change time for non-ajax-scan from 60000 to 6000 sec
- Registry access for 64bit windows

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

Back to Index