Tournament description improvements

deploy/database/schema.game.sql

@@ -17,7 +17,7 @@ CREATE TABLE game (
     last_winner_id     SMALLINT UNSIGNED,
     tournament_id      SMALLINT UNSIGNED,
     tournament_round_number SMALLINT UNSIGNED,
-    description        VARCHAR(255) NOT NULL,
+    description        VARCHAR(305) NOT NULL,
     chat               TEXT,
     previous_game_id   MEDIUMINT UNSIGNED,
     FOREIGN KEY (previous_game_id) REFERENCES game(id)

deploy/database/updates/03071_long_tournament_description.sql

@@ -0,0 +1 @@
+ALTER TABLE game MODIFY description VARCHAR(305) NOT NULL;

src/api/DummyApiResponder.php

@@ -224,6 +224,13 @@ protected function get_interface_response_loadGameData($args) {
         );
     }
 
+    protected function get_interface_response_loadTournamentData($args) {
+        return $this->load_json_data_from_file(
+            'loadTournamentData',
+            $args['tournament'] . '.json'
+        );
+    }
+
     protected function get_interface_response_countPendingGames() {
         return $this->load_json_data_from_file(
             'countPendingGames',

src/engine/BMInterfaceTournament.php

@@ -503,17 +503,21 @@ protected function generate_new_games(BMTournament $tournament) {
                 array($gameData['buttonId1'], $gameData['buttonId2'])
             );
 
-            $description = 'Round ' . $gameData['roundNumber'];
-            if ('' != $tournament->description) {
-                $description = $tournament->description . ' ' . $description;
+            $roundDescription = 'Tournament Round ' . $gameData['roundNumber'];
+            $tournDescription = $tournament->description;
+
+            if ('' == trim($tournDescription)) {
+                $tournDescription = $roundDescription;
+            } else {
+                $tournDescription = $tournDescription . ' • ' . $roundDescription;
             }
 
             $interfaceResponse = $this->game()->create_game_from_button_ids(
                 array($gameData['playerId1'], $gameData['playerId2']),
                 array($gameData['buttonId1'], $gameData['buttonId2']),
                 $buttonNames,
                 $tournament->gameMaxWins,
-                $description,
+                $tournDescription,
                 NULL,
                 0, // needs to be non-null, but also a non-player ID
                 TRUE,

src/ui/js/Env.js

@@ -524,6 +524,130 @@ Env.applyBbCodeToHtml = function(htmlToParse) {
   return outputHtml;
 };
 
+Env.removeBbCodeFromHtml = function(htmlToParse) {
+  // This is all rather more complicated than one might expect, but any attempt
+  // to parse BB code using simple regular expressions rather than tokenization
+  // is in the same family as parsing HTML with regular expressions, which
+  // summons Zalgo.
+  // (See: http://stackoverflow.com/
+  //   questions/1732348/regex-match-open-tags-except-xhtml-self-contained-tags)
+
+  var replacements = {
+    'b': {},
+    'i': {},
+    'u': {},
+    's': {},
+    'code': {},
+    'spoiler': {},
+    'quote': {},
+    'game': {
+      'isAtomic': true,
+    },
+    'player': {
+      'isAtomic': true,
+    },
+    'button': {
+      'isAtomic': true,
+    },
+    'set': {
+      'isAtomic': true,
+    },
+    'tourn': {
+      'isAtomic': true,
+    },
+    'wiki': {
+      'isAtomic': true,
+    },
+    'issue': {
+      'isAtomic': true,
+    },
+    'forum': {},
+    '[': {
+      'isAtomic': true,
+    },
+  };
+
+  var outputHtml = '';
+  var tagStack = [];
+
+  // We want to build a pattern that we can use to identify any single
+  // BB code start tag
+  var allStartTagsPattern = '';
+  $.each(replacements, function(tagName) {
+    if (allStartTagsPattern !== '') {
+      allStartTagsPattern += '|';
+    }
+    // Matches, e.g., '[ b ]' or '[game = "123"]'
+    // The (?:... part means that we want parentheses around the whole
+    // thing (so we we can OR it together with other ones), but we don't
+    // want to capture the value of the whole thing as a group
+    allStartTagsPattern +=
+      '(?:\\[(' + Env.escapeRegexp(tagName) + ')(?:=([^\\]]*?))?])';
+  });
+
+  var tagName;
+
+  while (htmlToParse) {
+    var currentPattern = allStartTagsPattern;
+    if (tagStack.length !== 0) {
+      // The tag that was most recently opened
+      tagName = tagStack[tagStack.length - 1];
+      // Matches '[/i]' et al.
+      // (so that we can spot the end of the current tag as well)
+      currentPattern +=
+        '|(?:\\[(/' + Env.escapeRegexp(tagName) + ')])';
+    }
+    // The first group should be non-greedy (hence the ?), and the last one
+    // should be greedy, so that nested tags work right
+    // (E.g., in '...blah[/quote] blah [/quote] blah', we want the first .*
+    // to end at the first [/quote], not the second)
+    currentPattern = '^(.*?)(?:' + currentPattern + ')(.*)$';
+    // case-insensitive, multi-line
+    var regExp = new RegExp(currentPattern, 'im');
+
+    var match = htmlToParse.match(regExp);
+    if (match) {
+      var stuffBeforeTag = match[1];
+      // javascript apparently believes that capture groups that don't
+      // match anything are just important as those that do. So we need
+      // to do some acrobatics to find the ones we actually care about.
+      // (match[0] is the whole matched string; match[1] is the stuff before
+      // the tag. So we start with match[2].)
+      tagName = '';
+      for (var i = 2; i < match.length; i++) {
+        tagName = match[i];
+        if (tagName) {
+          break;
+        }
+      }
+      tagName = tagName.toLowerCase();
+      var stuffAfterTag = match[match.length - 1];
+
+      outputHtml += stuffBeforeTag;
+      if (tagName.substring(0, 1) === '/') {
+        // If we've found our closing tag, we can finish the current tag and
+        // pop it off the stack
+        tagName = tagStack.pop();
+      } else {
+        if (!replacements[tagName].isAtomic) {
+          // If there's a closing tag coming along later, push this tag
+          // on the stack so we'll know we're waiting on it
+          tagStack.push(tagName);
+        }
+      }
+
+      htmlToParse = stuffAfterTag;
+    } else {
+      // If we don't find any more BB code tags that we're interested in,
+      // then we must have reached the end
+      outputHtml += htmlToParse;
+      htmlToParse = '';
+    }
+  }
+
+  return outputHtml;
+};
+
 Env.escapeRegexp = function(str) {
   return str.replace(/([.?*+^$[\]\\(){}|-])/g, '\\$1');
 };

src/ui/js/Game.js

@@ -1836,7 +1836,7 @@ Game.pageAddGameHeader = function(action_desc) {
 
   if (Api.game.description) {
     Game.page.append($('<div>', {
-      'text': Api.game.description,
+      'html': Env.applyBbCodeToHtml(Api.game.description),
       'class': 'gameDescDisplay',
     }));
   }

src/ui/js/Overview.js

@@ -443,9 +443,11 @@ Overview.addScoreCol = function(gameRow, gameInfo) {
 
 Overview.addDescCol = function(gameRow, description) {
   var descText = '';
-  if (typeof(description) == 'string') {
-    descText = description.substring(0, 30) +
-               ((description.length > 30) ? '...' : '');
+  if (typeof(description) === 'string') {
+    var descriptionNoMarkup = Env.removeBbCodeFromHtml(description);
+
+    descText = descriptionNoMarkup.substring(0, 30) +
+               ((descriptionNoMarkup.length > 30) ? '...' : '');
   }
   gameRow.append($('<td>', {
     'class': 'gameDescDisplay',

src/ui/js/Tournament.js

@@ -166,13 +166,7 @@ Tournament.pageAddTournamentHeader = function() {
 //    bgcolor = Tournament.color.opponent;
 //  }
 
-  if (Api.tournament.description) {
-    Tournament.page.append($('<div>', {
-      'text': Api.tournament.description,
-      'class': 'gameDescDisplay',
-    }));
-  }
-
+  Tournament.pageAddTournamentDescription();
   Tournament.page.append($('<br>'));
 
   Tournament.pageAddTournamentInfo();
@@ -306,8 +300,23 @@ Tournament.formFollowTournament = function(e) {
     Tournament.showLoggedInPage);
 };
 
+Tournament.pageAddTournamentDescription = function () {
+  if (Api.tournament.description) {
+    Tournament.page.append($('<div>', {
+      'id': 'tournament_desc',
+      'html': Env.applyBbCodeToHtml(Api.tournament.description),
+      'class': 'gameDescDisplay',
+    }));
+  }
+};
+
 Tournament.pageAddTournamentInfo = function () {
-  var infoDiv = $('<div>');
+  var infoDiv = $(
+    '<div>',
+    {
+      'id': 'tournament_info',
+    }
+  );
   Tournament.page.append(infoDiv);
 
   var tournamentTypePar = $('<p>', {
@@ -347,9 +356,18 @@ Tournament.pageAddWinnerInfo = function () {
   var winnerDiv = $('<div>');
   Tournament.page.append(winnerDiv);
 
-  var winnerIdx = Api.tournament.remainCountArray.findIndex(
-    function(x) {return (x > 0);}
+  var winnerIdx;
+  var isWinnerFound = Api.tournament.remainCountArray.some(
+    function(remainCount, idx) {
+      winnerIdx = idx;
+      return remainCount > 0;
+    }
   );
+
+  if (!isWinnerFound) {
+    return;
+  }
+
   var winnerPar = $('<p>', {
     'class': 'winner_name',
     'text': 'Winner: ' + Api.tournament.playerDataArray[winnerIdx].playerName

src/ui/js/TournamentOverview.js

@@ -284,8 +284,10 @@ TournamentOverview.addTypeCol = function(tournamentRow, tournamentInfo) {
 TournamentOverview.addDescCol = function(tournamentRow, description) {
   var descText = '';
   if (typeof(description) === 'string') {
-    descText = description.substring(0, 30) +
-               ((description.length > 30) ? '...' : '');
+    var descriptionNoMarkup = Env.removeBbCodeFromHtml(description);
+
+    descText = descriptionNoMarkup.substring(0, 30) +
+               ((descriptionNoMarkup.length > 30) ? '...' : '');
   }
   tournamentRow.append($('<td>', {
     'class': 'tournamentDescDisplay',

test/src/api/responderTournamentTest.php

@@ -211,7 +211,7 @@ public function test_interface_tournament() {
         $gameOneExpData = $this->generate_init_expected_data_array($gameOneId, 'responder004', 'responder005', 1, 'SPECIFY_DICE');
         $gameOneExpData['tournamentId'] = $tournamentId;
         $gameOneExpData['tournamentRoundNumber'] = 1;
-        $gameOneExpData['description'] = 'Round 1';
+        $gameOneExpData['description'] = 'Tournament Round 1';
         $gameOneExpData['currentPlayerIdx'] = FALSE;
         $gameOneExpData['creatorDataArray'] = array('creatorId' => 0, 'creatorName' => '');
         $gameOneExpData['gameActionLog'][0]['message'] = 'Game created automatically';
@@ -243,7 +243,7 @@ public function test_interface_tournament() {
         $gameTwoExpData['gameSkillsInfo'] = $this->get_skill_info(array('Poison'));
         $gameTwoExpData['tournamentId'] = $tournamentId;
         $gameTwoExpData['tournamentRoundNumber'] = 1;
-        $gameTwoExpData['description'] = 'Round 1';
+        $gameTwoExpData['description'] = 'Tournament Round 1';
         $gameTwoExpData['activePlayerIdx'] = 0;
         $gameTwoExpData['playerWithInitiativeIdx'] = 0;
         $gameTwoExpData['creatorDataArray'] = array('creatorId' => 0, 'creatorName' => '');
@@ -363,7 +363,7 @@ public function test_interface_tournament() {
         $gameThreeExpData['gameSkillsInfo'] = $this->get_skill_info(array('Poison'));
         $gameThreeExpData['tournamentId'] = $tournamentId;
         $gameThreeExpData['tournamentRoundNumber'] = 2;
-        $gameThreeExpData['description'] = 'Round 2';
+        $gameThreeExpData['description'] = 'Tournament Round 2';
         $gameThreeExpData['activePlayerIdx'] = 1;
         $gameThreeExpData['playerWithInitiativeIdx'] = 1;
         $gameThreeExpData['currentPlayerIdx'] = 1;

test/src/engine/BMInterfaceTournamentTest.php

@@ -18,4 +18,5 @@ public function test_create_tournament(
     ) {
 
     }
+
 }

test/src/ui/js/BMTestUtils.js

@@ -46,10 +46,13 @@ BMTestUtils.getAllElements = function() {
     'Loader':         JSON.stringify(Loader, null, "  "),
     'Login':          JSON.stringify(Login, null, "  "),
     'Newgame':        JSON.stringify(Newgame, null, "  "),
+    'Newtournament':  JSON.stringify(Newtournament, null, "  "),
     'Newuser':        JSON.stringify(Newuser, null, "  "),
     'OpenGames':      JSON.stringify(OpenGames, null, "  "),
     'Overview':       JSON.stringify(Overview, null, "  "),
     'Profile':        JSON.stringify(Profile, null, "  "),
+    'Tournament':     JSON.stringify(Tournament, null, "  "),
+    'TournamentOverview': JSON.stringify(TournamentOverview, null, "  "),
     'UserPrefs':      JSON.stringify(UserPrefs, null, "  "),
     'Verify':         JSON.stringify(Verify, null, "  "),
   };
@@ -132,6 +135,14 @@ BMTestUtils.testGameId = function(gameDesc) {
   if (gameDesc == 'NOGAME') { return '10000000'; }
 };
 
+// For each tournament reported by responderTest which we use in UI
+// tests, set a friendly name for tracking purposes.  These values
+// need to be kept in sync with responderTest in order for anything
+// good to happen.
+BMTestUtils.testTournamentId = function(tournamentDesc) {
+  if (tournamentDesc == 'default') { return '1'; }
+};
+
 // We don't currently usually test reading the URL bar contents, because
 // that's hard to do within QUnit, but rather override those contents
 // with hardcoded values that we want to test.
@@ -143,6 +154,10 @@ BMTestUtils.overrideGetParameterByName = function() {
       return BMTestUtils.testGameId(BMTestUtils.GameType);
     }
 
+    if (name == 'tournament') {
+      return BMTestUtils.testTournamentId(BMTestUtils.TournamentType);
+    }
+
     // always return the userid associated with tester1 in the fake data
     if (name == 'id') {
       return '1';

test/src/ui/js/test_Env.js

@@ -272,6 +272,12 @@ test("test_Env.applyBbCodeToHtml", function(assert) {
   assert.ok(holder.find('.chatItalic').length == 1, '[i] tag should be converted to HTML');
 });
 
+test("test_Env.removeBbCodeFromHtml", function(assert) {
+  var rawHtml = '<b>HTML</b><br/>[i]BB Code[/i]';
+  var newHtml = Env.removeBbCodeFromHtml(rawHtml);
+  assert.equal(newHtml, '<b>HTML</b><br/>BB Code', 'Stripped-down HTML should be correct');
+});
+
 test("test_Env.escapeRegexp", function(assert) {
   var rawText = 'example.com';
   var escapedPattern = Env.escapeRegexp(rawText);
@@ -339,7 +345,7 @@ test("test_Env.toggleSpoiler", function(assert) {
   var spoiler = $('<span>', { 'class': 'chatSpoiler' });
   var eventTriggerSpan = {'target': {'tagName': 'span'}};
   var eventTriggerAnchor = {'target': {'tagName': 'a'}};
-  
+
   Env.toggleSpoiler.call(spoiler, eventTriggerSpan);
   assert.ok(spoiler.hasClass('chatExposedSpoiler'),
     'Spoiler should be styled as revealed');

test/src/ui/js/test_Newtournament.js

@@ -26,7 +26,7 @@ module("Newtournament", {
     delete Api.player;
     delete Newtournament.page;
     delete Newtournament.form;
-//    delete Newtournament.justCreatedGame;
+    delete Newtournament.justCreatedTournament;
 
     Login.pageModule = null;
     Newtournament.activity = {};