/**
 *               _       _           
 *    __ _  __ _| |_ ___| |__   __ _ 
 *   / _` |/ _` | __/ __| '_ \ / _` |
 *  | (_| | (_| | || (__| | | | (_| |
 *   \__, |\__,_|\__\___|_| |_|\__,_|
 *    |___/    
 * 
 * @copyright	Copyright 2010 Netlog NV
 * @link		http://www.gatcha.com/downloads/gatcha_api_clientlib_php
 * @license		http://www.apache.org/licenses/LICENSE-2.0.html
 * 
 */
 
//
// v0.10α
//

New features:
* Support for the following Gatcha API Methods:
	container.user.activity.get (via Gatcha_ApiClient_Container class)
	container.user.globalscore.get (via Gatcha_ApiClient_Container class)
	container.faq.getQuestions (via Gatcha_ApiClient_Container class)
	container.faq.getCategories (via Gatcha_ApiClient_Container class)
	container.faq.getTags (via Gatcha_ApiClient_Container class)

Changes:
* Bugfix in Gatcha_ApiClient_Models_ContainerDirectoryGetGamesOptions for setPlatform function
 
//
// v0.09α
//

New features:
* Support for the following Gatcha API Methods:
	container.game.getRanksAndScore (via Gatcha_ApiClient_Container class)
	container.user.blockUser (via Gatcha_ApiClient_Container class)
	container.user.deleteUser (via Gatcha_ApiClient_Container class)

Changes:
* More robust include paths + autoload function 
* Updated following Gatcha API Methods to the new specs:
	container.game.getLeaderboard (via Gatcha_ApiClient_Container class)
* Support for optional sessionID param when posting new achievements or fetching previous achievements
 
//
// v0.08β
//

Changes:
* Gatcha_ApiClient_Models_LeaderboardEntry model

Bugfixes:
* game.game.getRelatedGames

//
// v0.08α
//

Changes:
* Support for the following Gatcha API Methods:
	container.game.getLeaderboard (via Gatcha_ApiClient_Container class)
* Refactored game.leaderboard.get for the new API specification

//
// v0.07α
//

New features:
* Support for the following Gatcha API Methods:
	gatcha.tools.minifyURL (via Gatcha_ApiClient_Gatcha class)
	game.game.getRelatedGames (via Gatcha_ApiClient_Game class)
	game.user.getFriends (via Gatcha_ApiClient_Game class)
* Descriptions for games: Gatcha_ApiClient_Models_Game->getDescription();
	
Changes:
* Added $pageSize parameter for Gatcha_ApiClient_Game->leaderboardGet()
 
//
// v0.06α
//

New features:
* Configure an optional callback to pre-process the HTTP request result.
  See configuration.inc.php 'getApiResultPreProcessorCallBack()'. 
 
Changes:
* Replaced param 'template' with 'title' and 'description' for 
  game.achievements.addUserReachedAchievement-call.
  Affected methods:
  - Gatcha_ApiClient_Game->achievementsAddUserReachedAchievement()
  - Gatcha_ApiClient_Models_GameAchievement constructor
* UID's returned for containers are now strings, not integers
 
//
// v0.05α
//

Changes:
* Gatcha_ApiClient_Container->directoryGetGamesCount function 
  parameters refactored. Now has helper classes. Expects:
   - @param Gatcha_ApiClient_Models_ContainerDirectoryGetGamesOptions 
     $options
* Gatcha_ApiClient_Container->directoryGetGames function parameters 
  refactored. Now has helper classes. Expects:
   - @param Gatcha_ApiClient_Models_ContainerDirectoryGetGamesOptions 
     $options
   - @param Gatcha_ApiClient_Tools_Pager $pager
   - @param Gatcha_ApiClient_Models_ContainerDirectoryGetGamesSorter $sorter
 
//
// v0.04α
//

New features:
* Support for the following Gatcha API Methods:
	container.game.getRelatedGames
	game.persistentStorage.put
	game.persistentStorage.get
	game.persistentStorage.delete
	
Changes:
* Support for "only_featured" argument for:
	container.directory.getGamesCount
	container.directory.getGames
  (Mind: Argument order of functions directoryGetGamesCount and
  directoryGetGames in class Gatcha_ApiClient_Container is changed!)
	
Bugfixes:
* game.leaderboard.get method requires a uid param
	
 
//
// v0.03α
//
 
New features:
* Support for the following Gatcha API Methods (all namespaces of the 
  Container API):
	container.directory.getGamePlays
	container.game.getGameIDByURLName
	container.user.rateGameVersion
	container.user.canRateGameVersion
	container.user.getBestGames
		
Changes:
* Support for "playmode" argument for container.directory.getGamesCount 
  and container.directory.getGames (changed function argument order of 
  Gatcha_ApiClient_Container->directoryGetGamesCount() and 
  Gatcha_ApiClient_Container->directoryGetGames())  
* Made Gatcha_ApiClient_Container/Game/Gatcha->gatchaAuthGetTicket() 
  public, so you can fetch ticket (to store for later calls)
* Added helper constants Gatcha_ApiClient_Param for gender specific 
  game sorting on popularity and gameplay period "NOW"
* "container.directory.getGames" and "container.directory.getGamesCount": 
  support for passing $status/$platform/$language/$categoryID/$ratingLevel 
  arguments as arrays
* "container.user.getLikedGames" and "container.user.getLikedGamesCount": 
  support for passing $categoryID/$status arguments as arrays
* Support for optional $categoryid and $status optional params of 
  "container.user.getLikedGames" and "container.user.getLikedGamesCount" 
  API methods

Bugfixes:
* Gatcha_ApiClient_Models_Game now also has the categories data + getters	
 
//
// v0.02α
//

New features:
* Support for the following Gatcha API Methods (all namespaces of 
  the Game API):
	game.env.getServerTime
	game.env.postError
	game.env.canLoadGame
	game.leaderboard.get
	game.i18n.getTranslations
	game.i18n.getWrapperTranslations
	game.singleplayerSession.start
	game.singleplayerSession.logData
	game.singleplayerSession.updateHighScore
	game.singleplayerSession.end
	game.multiplayerSession.start
	game.multiplayerSession.logData
	game.multiplayerSession.updateRating
	game.multiplayerSession.end
	game.achievements.addUserReachedAchievement
	game.achievements.didUserReachAchievement
	game.achievements.getAchievementsByUserCount
	game.achievements.getAchievementsByUser
	game.achievements.getUsersByAchievementCount
	game.achievements.getUsersByAchievement
* Most Gatcha API methods now require a 'requestid' param which 
  is an incrementing integer. (Security measure to make sure 
  requests arrive in the correct order.) This param is added by 
  the client library.

Changes:
* Configuring this library is done a little different. (Via 
  function calls instead of class constants, to be able to do 
  runtime configuration.) 
  See ".configuration.inc.example.php"
* Improved documentation (@throws hints / a few fixes and 
  improvements).

Bugfixes:
* Replace '/' with DIRECTORY_SEPERATOR constant.
* A few classes weren't renamed with the new Gatcha_ApiClient_* 
  prefix yet.
 
//
// v0.01rc2
//

New Features:
* Support for passing app id, secret and version via constructor 
  params (config defaults are fallback), to allow using the api 
  for multiple applications.
* Class + function documentation added in "/docs"-folder. 
  (Generated from phpDoc, with phpDoctor)

Changes:
* Gatcha_Api classes + prefixes renamed to Gatcha_ApiClient
* .configuration.inc.php renamed to configuration.inc.php
* $language params (in Gatcha_ApiClient and constructors of 
  Gatcha_ApiClient_Container, Gatcha_ApiClient_Game and 
  Gatcha_ApiClient_Gatcha) moved to function params of relevant 
  functions

Bugfixes:
* Gatcha_ApiClient_Gatcha->authGetAvailableMethods() fixed

//
// v0.01rc1
//

Features:
* Support for the following Gatcha API Methods:
	- gatcha.auth.getTicket	
	- container.directory.getGamesCount
	- container.directory.getGames
	- container.directory.getCategoriesCount
	- container.directory.getCategories
	- container.directory.getGamePlaysCount
	- container.game.getGame
	- container.user.getLikedGamesCount
	- container.user.getLikedGames
	- container.user.likeGame
	- container.user.unlikeGame
	- container.user.likesGame