Design Document board18New Page - Revision history

Rich: second part of the rewrite for version 2.6.8

2020-08-28T16:53:06Z

second part of the rewrite for version 2.6.8

← Older revision		Revision as of 16:53, 28 August 2020
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{ReleaseNotice\|2.5}}{{Design Document Index}}		{{ReleaseNotice\|2.6}}{{Design Document Index}}
	{{WIKI Links for BOARD18 WEB Pages}}		{{WIKI Links for BOARD18 WEB Pages}}
	Selecting "Make New Game" from the main menu in the board18Main.php page		Selecting "Make New Game" from the main menu in the board18Main.php page
	causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.		causes the board18New.php page to be displayed. <br>This page can be used to create a new BOARD18 game.

	'''Most of the JavaScript logic for board18New is in the [[Board18New1\|scripts/board18New1.js]] ~~file~~ and the [[Board18New2\|scripts/board18New2.js]] ~~file~~.'''		'''Most of the JavaScript logic for board18New is in the [[Board18New1\|scripts/board18New1.js]] and the [[Board18New2\|scripts/board18New2.js]] files.'''

	The board18New.php page also uses the scripts/board18com.js file and some other open source JavaScript files.<br>		The board18New.php page also uses the scripts/board18com.js file and some other open source JavaScript files.<br>
Line 11:		Line 11:

	== Start a New Game Session ==		== Start a New Game Session ==
	To start a new game session, one must fill in the fields in the ~~new game form~~ that is displayed at the top of the "RightOfPage" division.<br>		To start a new game session, one must fill in the fields in the '''New Game Form''' that is displayed at the top of the "RightOfPage" division.<br>
	Clicking on a game box in the Available Game Box Table will enter that game box ID into the game box field on this form.<br>		Clicking on a game box in the Available Game Box Table will enter that game box ID into the game box field on this form.<br>
	The active player is automatically entered into the first player field on this form.<br>		The active player is automatically entered into the first player field on this form.<br>
Line 17:		Line 17:
	When the form is submitted, the fields are verified and then an AJAX call is made to the php/createGame.php program.		When the form is submitted, the fields are verified and then an AJAX call is made to the php/createGame.php program.

			== Game Box List ==
			When entered board18New.php performs an AJAX call to the boxGetAll.php function to get and display a list of the game boxes that are available for play.
			This list is directly below the '''New Game Form'''. The player must choose a game box from this list.
			Clicking on a row on this list will copy the Box ID for that game into the form.

	== ~~The Available Game Box Table~~ ==		== List Display Selection Controls ==
	~~When entered board18New.php performs an AJAX call to the function to get and~~ display ~~a list~~ of the ~~game boxes that are available for play.~~		The <span style="color: Fuchsia">list display selection controls </span> in each of the list forms can be used
	~~This~~ list ~~is displayed at the bottom of the "RightOfPage" division.~~		to switch between lists and also to filter the box list via the '''Box Name'''<br>
			Any portion of a box name can be entered in the '''Filter Game Box Name By''' field.
	~~== The Players Table ==~~
	~~When entered board18New.php uses the php showPlayers() function~~ to ~~get~~ and ~~display a~~ list of the ~~players that have userID~~'~~s on this BOARD18 server.~~<br>
	~~This list is displayed~~ in the ~~"LeftOfPage" division~~.


			== Player Lists ==
			board18New can perform an AJAX call to the playerSort.php
			to display one of three Player Lists. The lists can be sorted by the three displayed fields.<br>
			These lists show all of the players known to the server.
			<span style="color: Fuchsia">
			Clicking on a Player ID will add that player to the form.</span>

	[[Category:Design]]		[[Category:Design]]

Rich: partial edit - to be continued

2020-08-28T14:50:49Z

partial edit - to be continued

← Older revision		Revision as of 14:50, 28 August 2020
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{ReleaseNotice\|2.5}}{{Design Document Index}}		{{ReleaseNotice\|2.5}}{{Design Document Index}}
			{{WIKI Links for BOARD18 WEB Pages}}
	Selecting "Make New Game" from the main menu in the board18Main.php page		Selecting "Make New Game" from the main menu in the board18Main.php page
	causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.		causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.

	'''Most of the JavaScript logic for board18New is in the [[~~Board18New~~\|scripts/~~board18New~~.js]] file.'''		'''Most of the JavaScript logic for board18New is in the [[Board18New1\|scripts/board18New1.js]] file and the [[Board18New2\|scripts/board18New2.js]] file.'''

	The board18New.php page also uses the scripts/board18com.js file and some other open source JavaScript files.<br>		The board18New.php page also uses the scripts/board18com.js file and some other open source JavaScript files.<br>
	Style is supplied by the style/board18New.css and the style/board18com.css files.		Style is supplied by the style/board18New.css and the style/board18com.css files.

			== Start a New Game Session ==
			To start a new game session, one must fill in the fields in the new game form that is displayed at the top of the "RightOfPage" division.<br>
			Clicking on a game box in the Available Game Box Table will enter that game box ID into the game box field on this form.<br>
			The active player is automatically entered into the first player field on this form.<br>
			Clicking on a player in the Players Table will enter that player ID in the next player field on this form.<br>
			When the form is submitted, the fields are verified and then an AJAX call is made to the php/createGame.php program.


	~~{{WIKI Links for BOARD18 WEB Pages}}==Included PHP File==~~
	~~board18New.php uses require_once() to include the [[Design_Document_Server_Side_Coding_Details#makeTables.php\|makeTables.php]] PHP file.<br>~~
	~~This file contains 3 PHP functions:~~
	*showBoxes($conn) - create a table of all game boxes in database.
	*showPlayers($conn) - create a table of all players in database.
	*gamePlayers($gameid, $conn) - create a table of players in game.

	== The Available Game Box Table ==		== The Available Game Box Table ==
	When entered board18New.php ~~uses~~ the ~~php showBoxes()~~ function to get and display a list of the game boxes that are available for play.		When entered board18New.php performs an AJAX call to the function to get and display a list of the game boxes that are available for play.
	This list is displayed at the bottom of the "RightOfPage" division.		This list is displayed at the bottom of the "RightOfPage" division.

Line 26:		Line 26:
	This list is displayed in the "LeftOfPage" division.		This list is displayed in the "LeftOfPage" division.

	~~== Start a New Game Session ==~~
	~~To start a new game session, one must fill in the fields in the new game form that is displayed at the top of the "RightOfPage" division.<br>~~
	~~Clicking on a game box in the Available Game Box Table will enter that game box ID into the game box field on the form.<br>~~
	~~The active player is automatically entered into the first player field on the form.<br>~~
	~~Clicking on a player in the Players Table will enter that player ID in the next player field on the form.<br>~~
	~~When the form is submitted, the fields are verified and then~~
	~~an AJAX call is made to the php/createGame.php program.<br>~~
	~~The php/createGame.php program is documented on the [[Design_Document_Server_Side_Coding_Details#createGame.php\|createGame.php]] WIKI page.<br>~~

	[[Category:Design]]		[[Category:Design]]

Rich: updated release notice

2017-07-28T21:03:58Z

updated release notice

← Older revision		Revision as of 21:03, 28 July 2017
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{ReleaseNotice\|2.4}}{{Design Document Index}}		{{ReleaseNotice\|2.5}}{{Design Document Index}}
	Selecting "Make New Game" from the main menu in the board18Main.php page		Selecting "Make New Game" from the main menu in the board18Main.php page
	causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.		causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.

Rich: 2.4

2016-10-17T22:23:49Z

2.4

← Older revision		Revision as of 22:23, 17 October 2016
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{ReleaseNotice\|2.1}}{{Design Document Index}}		{{ReleaseNotice\|2.4}}{{Design Document Index}}
	Selecting "Make New Game" from the main menu in the board18Main.php page		Selecting "Make New Game" from the main menu in the board18Main.php page
	causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.		causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.

Rich: 2.1`

2016-06-02T22:12:51Z

2.1`

← Older revision		Revision as of 22:12, 2 June 2016
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{ReleaseNotice\|1.3}}{{Design Document Index}}		{{ReleaseNotice\|2.1}}{{Design Document Index}}
	Selecting "Make New Game" from the main menu in the board18Main.php page		Selecting "Make New Game" from the main menu in the board18Main.php page
	causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.		causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.

Rich at 00:01, 11 December 2015

2015-12-11T00:01:56Z

← Older revision		Revision as of 00:01, 11 December 2015
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{ReleaseNotice\|0.4}}{{Design Document Index}}		{{ReleaseNotice\|1.3}}{{Design Document Index}}
	Selecting "Make New Game" from the main menu in the board18Main.php page		Selecting "Make New Game" from the main menu in the board18Main.php page
	causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.		causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.

Rich at 21:27, 9 October 2014

2014-10-09T21:27:57Z

← Older revision		Revision as of 21:27, 9 October 2014
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Design Document Index}}		{{ReleaseNotice\|0.4}}{{Design Document Index}}
	Selecting "Make New Game" from the main menu in the board18Main.php page		Selecting "Make New Game" from the main menu in the board18Main.php page
	causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.		causes the board18New.php page to be displayed. This page can be used to create a new BOARD18 game.

Rich: /* The Available Game Box Table */

2014-09-16T02:25:02Z

The Available Game Box Table

← Older revision		Revision as of 02:25, 16 September 2014
Line 19:		Line 19:

	== The Available Game Box Table ==		== The Available Game Box Table ==
	When entered board18New.php uses the php showBoxes() function to get and display a list of the game boxes that are available for play. ~~<br>~~		When entered board18New.php uses the php showBoxes() function to get and display a list of the game boxes that are available for play.
	This list is displayed at the bottom of the "RightOfPage" division.		This list is displayed at the bottom of the "RightOfPage" division.

Rich: Major revision

2014-09-16T02:23:59Z

Major revision

← Older revision		Revision as of 02:23, 16 September 2014
Line 1:		Line 1:
			__NOTOC__
	{{Design Document Index}}		{{Design Document Index}}
	Selecting "Make New Game" from the main menu in the board18Main.php page		Selecting "Make New Game" from the main menu in the board18Main.php page
Line 10:		Line 11:


	{{WIKI Links for BOARD18 WEB Pages}}== The Available Game Box Table ==		{{WIKI Links for BOARD18 WEB Pages}}==Included PHP File==
	When entered board18New.php uses the php showBoxes function to get and display a list of the game boxes that are available for play. <br>		board18New.php uses require_once() to include the [[Design_Document_Server_Side_Coding_Details#makeTables.php\|makeTables.php]] PHP file.<br>
			This file contains 3 PHP functions:
			*showBoxes($conn) - create a table of all game boxes in database.
			*showPlayers($conn) - create a table of all players in database.
			*gamePlayers($gameid, $conn) - create a table of players in game.

			== The Available Game Box Table ==
			When entered board18New.php uses the php showBoxes() function to get and display a list of the game boxes that are available for play. <br>
	This list is displayed at the bottom of the "RightOfPage" division.		This list is displayed at the bottom of the "RightOfPage" division.

	== The Players Table ==		== The Players Table ==
	When entered board18New.php uses the php showPlayers function to get and display a list of the players that have userID's on this BOARD18 server.<br>		When entered board18New.php uses the php showPlayers() function to get and display a list of the players that have userID's on this BOARD18 server.<br>
	This list is displayed in the "LeftOfPage" division.		This list is displayed in the "LeftOfPage" division.

	== Start a New Game Session ==		== Start a New Game Session ==
	To start a new game session, one must fill in the fields in the new game form that is displayed at the top of the "RightOfPage" division.<br>		To start a new game session, one must fill in the fields in the new game form that is displayed at the top of the "RightOfPage" division.<br>
	~~'''There are currently no shortcuts to automate this chore~~.~~'''~~<br>		Clicking on a game box in the Available Game Box Table will enter that game box ID into the game box field on the form.<br>
			The active player is automatically entered into the first player field on the form.<br>
			Clicking on a player in the Players Table will enter that player ID in the next player field on the form.<br>
	When the form is submitted, the fields are verified and then		When the form is submitted, the fields are verified and then
	an AJAX call is made to the php/createGame.php program.<br>		an AJAX call is made to the php/createGame.php program.<br>
	The php/createGame.php program is documented on the [[~~Design Document~~ createGame\|createGame.php]] WIKI page.<br>		The php/createGame.php program is documented on the [[Design_Document_Server_Side_Coding_Details#createGame.php\|createGame.php]] WIKI page.<br>

	[[Category:Design]]		[[Category:Design]]

Rich at 22:51, 15 September 2014

2014-09-15T22:51:09Z

← Older revision		Revision as of 22:51, 15 September 2014
Line 7:		Line 7:
	The board18New.php page also uses the scripts/board18com.js file and some other open source JavaScript files.<br>		The board18New.php page also uses the scripts/board18com.js file and some other open source JavaScript files.<br>
	Style is supplied by the style/board18New.css and the style/board18com.css files.		Style is supplied by the style/board18New.css and the style/board18com.css files.



	{{WIKI Links for BOARD18 WEB Pages}}== The Available Game Box Table ==		{{WIKI Links for BOARD18 WEB Pages}}== The Available Game Box Table ==