Players actions: yourgamename.action.php - Гісторыя версій

Victoria La: /* Example pass array of Id's */

2020-08-17T00:17:02Z

Example pass array of Id's

← Папярэдн. версія		Версія ад 00:17, 17 жніўня 2020
Радок 105:		Радок 105:
	$card_ids = array();		$card_ids = array();
	else		else
	$card_ids = explode( ';', $card_ids_raw );		$card_ids = explode( ' ', $card_ids_raw );

	$this->game->playCards( $card_ids );		$this->game->playCards( $card_ids );

Victoria La на 00:14, 17 жніўня 2020

2020-08-17T00:14:43Z

@@ Радок 80: / Радок 80: @@
          if( substr( $card_ids_raw, -1 ) == ';' )
              $card_ids_raw = substr( $card_ids_raw, 0, -1 );
          if( $card_ids_raw == '' )
              $card_ids = array();

Cpasbanal: Add the fact you cannot retrieve data from an ajax call (even if callback exists which is wierd somehow)

2020-07-02T19:51:08Z

Add the fact you cannot retrieve data from an ajax call (even if callback exists which is wierd somehow)

← Папярэдн. версія		Версія ад 19:51, 2 ліпеня 2020
Радок 89:		Радок 89:
	}		}
	</pre>		</pre>

			== Retrieving data from ajax call ==

			Note that this is not possible to return any result from a player action: it should return nothing (action went fine) or an exception (action unsuccessful).

			The typical way to implement this is using games states with game state arguments. Eventually, use player notifications.

Bdrieu на 17:20, 10 мая 2020

2020-05-10T17:20:04Z

← Папярэдн. версія		Версія ад 17:20, 10 мая 2020
Радок 53:		Радок 53:
	'AT_alphanum' for a string with 0-9a-zA-Z_ and space		'AT_alphanum' for a string with 0-9a-zA-Z_ and space
	'AT_numberlist' for a list of numbers separated with "," or ";" (example: 1,4;2,3;-1,2).		'AT_numberlist' for a list of numbers separated with "," or ";" (example: 1,4;2,3;-1,2).
			'AT_base64' for a base64-encoded string.
	* mandatory: specify "true" if the argument is mandatory.		* mandatory: specify "true" if the argument is mandatory.
	* default: if mandatory=false, you can specify here a default value in case the argument is not present.		* default: if mandatory=false, you can specify here a default value in case the argument is not present.

Tutchek: Added navigation

2020-04-15T21:03:06Z

Added navigation

← Папярэдн. версія		Версія ад 21:03, 15 красавіка 2020
Радок 1:		Радок 1:
			{{Studio_Framework_Navigation}}

	== Purpose of this file ==		== Purpose of this file ==

Amadannabriona: /* Useful tip: retrieve a list of numbers */

2018-09-16T16:46:35Z

Useful tip: retrieve a list of numbers

← Папярэдн. версія		Версія ад 16:46, 16 верасня 2018
Радок 66:		Радок 66:
	== Useful tip: retrieve a list of numbers ==		== Useful tip: retrieve a list of numbers ==

	If your Javascript sends a list of integers separated by ";" (ex: "1;2;3;4") as an argument, you can transform them in a PHP array with the following:		If your Javascript sends a list of integers separated by ";" (example: "1;2;3;4") as an argument, you can transform them into a PHP array with the following:

	<pre>		<pre>

Amadannabriona: /* Methods to use in action methods */

2018-09-16T16:45:42Z

Methods to use in action methods

← Папярэдн. версія		Версія ад 16:45, 16 верасня 2018
Радок 27:		Радок 27:
	== Methods to use in action methods ==		== Methods to use in action methods ==

	'''function setAjaxMode'''		'''function setAjaxMode()'''

	Must be ~~use~~ at the beginning of each action method.		Must be used at the beginning of each action method.

	'''function ajaxResponse'''		'''function ajaxResponse()'''

	Must be ~~use~~ at the end of each action method.		Must be used at the end of each action method.

	'''function getArg( $argName, $argType, $mandatory=false, $default=NULL, $argTypeDetails=array(), $bCanFail=false )'''		'''function getArg( $argName, $argType, $mandatory=false, $default=NULL, $argTypeDetails=array(), $bCanFail=false )'''

	This method must be used to retrieve the arguments sent with your AJAX query.		This method must be used to retrieve the arguments sent with your AJAX query.
	You must ~~NOT~~ use "_GET", "_POST" or equivalent PHP variables to do this, as it is unsafe.
	This method ~~use~~ the following arguments:		You must ''not'' use "_GET", "_POST" or equivalent PHP variables to do this, as it is unsafe.

			This method uses the following arguments:

	* argName: the name of the argument to retrieve.		* argName: the name of the argument to retrieve.
	* argType: the type of the argument. You should use one of the following:		* argType: the type of the argument. You should use one of the following:
Радок 46:		Радок 49:
	'AT_float' for a float		'AT_float' for a float
	'AT_bool' for 1/0/true/false		'AT_bool' for 1/0/true/false
	'AT_enum' for an enumeration (argTypeDetails ~~list~~ the possible values as an array)		'AT_enum' for an enumeration (argTypeDetails lists the possible values as an array)
	'AT_alphanum' for a string with 0-9a-zA-Z_ and space		'AT_alphanum' for a string with 0-9a-zA-Z_ and space
	'AT_numberlist' for a list of ~~several~~ numbers separated with "," or ";" (~~ex: exemple~~: 1,4;2,3;-1,2).		'AT_numberlist' for a list of numbers separated with "," or ";" (example: 1,4;2,3;-1,2).
	* mandatory: specify "true" if the argument is mandatory.		* mandatory: specify "true" if the argument is mandatory.
	* default: if mandatory=false, you can specify here a default value in case the argument is not present.		* default: if mandatory=false, you can specify here a default value in case the argument is not present.
Радок 57:		Радок 60:
	'''function isArg( $argName )'''		'''function isArg( $argName )'''

	This is a useful method when you only want to check if an argument is present or not present in your AJAX request (and don't care of the value.		This is a useful method when you only want to check if an argument is present or not present in your AJAX request (and don't care about the value).

	It returns "true" or "false" whether "argName" has been specified as an argument of the AJAX request or not.		It returns "true" or "false" according to whether "argName" has been specified as an argument of the AJAX request or not.

	== Useful tip: retrieve a list of numbers ==		== Useful tip: retrieve a list of numbers ==

Amadannabriona: /* Purpose of this file */

2018-09-16T16:41:36Z

Purpose of this file

← Папярэдн. версія		Версія ад 16:41, 16 верасня 2018
Радок 2:		Радок 2:
	== Purpose of this file ==		== Purpose of this file ==

	With this file, you define all the ~~players~~ entry points (~~ie:~~ possible game actions) of your game.		With this file, you define all the player entry points (i.e., possible game actions) for your game.

	This file is a sort of "bridge" between the AJAX calls you ~~are doing~~ from ~~your~~ Javascript client side, and your main PHP code in "yourgame.game.php".		This file is a sort of "bridge" between the AJAX calls you perform from the Javascript client side, and your main PHP code in "yourgame.game.php".

	The role of the methods defined in this file is to filter the arguments, ~~eventually to~~ format them a ~~little~~ bit, and then to call a corresponding PHP method from your main game logic ("yourgame.game.php" file).		The role of the methods defined in this file is to filter the arguments, format them a bit, and then call a corresponding PHP method from your main game logic ("yourgame.game.php" file).

	Methods in this file ~~must~~ be short: no game logic must be introduced here.		Methods in this file should be short: no game logic must be introduced here.

	== Example of typical action method ==		== Example of typical action method ==

Christopheryoder: /* Useful tip: retrieve a list of number */

2015-02-05T19:31:52Z

Useful tip: retrieve a list of number

← Папярэдн. версія		Версія ад 19:31, 5 лютага 2015
Радок 61:		Радок 61:
	It returns "true" or "false" whether "argName" has been specified as an argument of the AJAX request or not.		It returns "true" or "false" whether "argName" has been specified as an argument of the AJAX request or not.

	== Useful tip: retrieve a list of ~~number~~ ==		== Useful tip: retrieve a list of numbers ==

	If your Javascript ~~send~~ a list of ~~integer~~ separated by ";" (ex: "1;2;3;4") as an argument, you can transform them in a PHP array with the following:		If your Javascript sends a list of integers separated by ";" (ex: "1;2;3;4") as an argument, you can transform them in a PHP array with the following:

	<pre>		<pre>

Sourisdudesert: /* Methods to use in action methods */

2013-01-11T15:07:01Z

Methods to use in action methods

← Папярэдн. версія		Версія ад 15:07, 11 студзеня 2013
Радок 60:		Радок 60:

	It returns "true" or "false" whether "argName" has been specified as an argument of the AJAX request or not.		It returns "true" or "false" whether "argName" has been specified as an argument of the AJAX request or not.

			== Useful tip: retrieve a list of number ==

			If your Javascript send a list of integer separated by ";" (ex: "1;2;3;4") as an argument, you can transform them in a PHP array with the following:

			<pre>
			public function playCards()
			{
			self::setAjaxMode();

			$card_ids_raw = self::getArg( "card_ids", AT_numberlist, true );

			// Removing last ';' if exists
			if( substr( $card_ids_raw, -1 ) == ';' )
			$card_ids_raw = substr( $card_ids_raw, 0, -1 );
			if( $card_ids_raw == '' )
			$card_ids = array();
			else
			$card_ids = explode( ';', $card_ids_raw );

			$this->game->playCards( $card_ids );
			self::ajaxResponse( );
			}
			</pre>