GameDB2 User Manual - Players
Description
Players are people who have been entered into the system so that they can
be attached to
session reports, game reviews, and other portions of the
system. Unlike
users, players have no login information and so have no
access to the system directly. However, for every user registered with the system,
there is a corresponding player record.
The main purpose of players in GameDB is to record who played, won, and lost various
Games in session reports. From this, GameDB generates statistics, such
as how many times a game has been played, how many wins, how many losses, most recent
win, and so on.
Players have an associated
Player Profile, which records their name,
email address, and other information. This information is accessible to all
users in the system.
Viewing the player list
The list of players that are currently registered with the system is available by clicking on
"Players" in the main GameDB menu. The list of players is displayed alphabetically,
and contains the following information:
Name
The name of this player, as derived from the Player Profile information. The player
name is a link which leads to the game play statistics for this player.
Session Reports
The next six columns are information that GameDB has collected for this player which derives in some
way from the Session Reports that are somehow associated with this user:
Written
The number of session reports that have been written by this player. When this number is not 0,
it is a link which takes you to the list of all session reports written by his player.
Games
The number of unique games that this player has played. When this number is
not 0, it is a link which takes you to the list of games that this player has played. This is
displayed as a standard game list view, with an extra column which indicates how
many times that game was played.
Plays
The complete number of games that this player has participated in. When this number is not 0, it is
a link which takes you to the list of session reports for games that this player has participated in.
Won
The complete number of games that this player has participated in and also won. When this number is not 0, it is
a link which takes you to the list of session reports for games that this player has won.
Lost
The complete number of games that this player has participated in and also lost. When this number is not 0, it is
a link which takes you to the list of session reports for games that this player has lost.
Win %
Using the information on the number of games this player has played, won and lost, this column displays
the percentage of the time that this player wins games.
Game Collection
The next six columns are information that GameDB has collected for this player which derives in some way
from the list of games that this player has listed as being a part of their collection of games:
Owned
This is the total number of games currently registered with GameDB which this player owns. When this value
is not 0, it is a link to a standard game list that lists all of the games owned by this player.
Loaned
This is the total number of games currently registered with GameDB which this player has out on loan to
someone else. This may be some other player, or an outside party. When this value is not 0, it is a link
to a standard game list that lists all of the games loaned out by this player.
Borrowed
This is the total number of games currently registered with GameDB which this player is currently borrowing
from another player in GameDB. When this value is not 0, it is a link to a standard game list that lists all
of the games that this player is borrowing from people.
Played
This is the total number of games currently registered with GameDB which this player owns and has played
at least once (that is, owned games for which there is at least one session report that
lists this player as a participant). When this value is not 0, it is a link to a standard game list that lists
all of the games that this player owns and has played.
Unplayed
This is the inverse of the previous column, and tells you the number of games that this player owns but has
not played yet. As with the played value, when not 0, it is a link to a standard game list that lists
all of the games that this player owns but has not played.
Play %
Using information on the number of games owned and the number of games played, this column contains a
statistics which indicates what percentage of their game collection this player has played so far.
Edit
Clicking this link allows you to view and edit the Player Profile attached to this player.
You will not see this link unless you yourself have permission to edit players.
Upgrade
Clicking this link allows you to upgrade a player to a user. In effect, this grants login permissions
to this player.
You will not see this link for players which already have a user attached to them, or if you do not have permission
to add users to the system.
Remove
This check box allows you to flag a player for removal from the system. To remove players, you must first select one or
more users by checking the check box next to their name, and then clicking on the "Remove" button at the bottom of the
form. You will be asked to confirm your intention to remove the specified players before the
removal takes place.
You will not see the check boxes or the Remove button unless you yourself have permission to remove players. Additionally,
you may not remove players that have a user record attached, or any player that is listed as a participant in at least
one session report.
Player profiles
Every
player registered with the system has attached profile information that describes
who they are and what their contact information is.
Since every
user in the system has an attached player, the information from
the Player profile is also used as part of the
User Profile. This allows users
to be referenced by their actual name instead of just their user name.
Player profile information is visible on the
Game Play Details page.
Player game play details
While the
player list displays statistics on the number of
games played, won and lost for
a
player, it may also be interesting to see an overview of what games were played, and how well the player
performed in each game. To display complete Game Play details for a player, click on their name in the Player List.
The Game Play details page contains information split out into three different sections:
Profile Information
The top section on the page displays all of the known user profile and player profile
information for this particular player. At a minimum, this will display the name of this player, but may also
include an email address and a homepage URL, if that information has been provided.
If this player also has a user attached, the user name of the player and the user name of the user that added this
player are also displayed.
Lastly, a count of session reports written by this player may also be displayed, if there have
been any. In this case, a link is created that allows you to view all such session reports.
Recent Play Information
The middle section of the page displays the most recently recorded win and loss for this player, as taken from
the session report list. This information may not be displayed if there is no recent win or loss
recorded for this player yet.
When presented, the name of the game is a link to the game details for the
game played, and the session date is a link to the session report details for the session report
that describes the win or loss.
Game Play Information
The bottom section of the page displays a complete breakdown of every game that this player has played,
as gathered from session reports including this player.
The list contains each game, sorted by name, and displays the number of times each game was played, won and lost.
The ratio of wins to losses is also displayed.
In this list, the name of the game is a link to the game details for the game, and each play, win or loss is
a link to the list of session reports where the player played, won or lost that particular game.
The last line in the total is a totals line, which displays the same play information as the
player list does for any given player.
Adding a new player
To add new
players to the system, display the
Player List by clicking
"Players" in the main menu, and then click the button labeled "Add a new Player" at the top of
the page.
The information specified becomes the
player profile for the newly added player, and is
used to distinguish them from other players in the system.
A new player is also automatically created whenever a new
user is added to the system.
New players may only be added by
users with the appropriate
permissions set.
Removing an existing player
To remove
Players from the system, display the
player list by clicking
"Players" in the main menu. From here you may select one or more players for removal by checking the
check box next to their record, and clicking on the "Remove" button at the bottom of the list. You will be
asked to confirm the operation before the removal takes place.
The removal process will erase all record of what games this player owns, and will mark any content
created by this player (for example,
session reports) as being created by the system.
Players cannot be removed if they are attached to an active
user or if they are listed as
the participant in at least one session report.
Players may only be removed by users with the appropriate
permissions set.
Upgrading a player
Player upgrading allows you to create and attach a new
user to a previously
created Player. You can do this to grant login privileges to a player, or to restore login privileges to
a user who has previously had them revoked.
To upgrade a player, view the
player list by clicking on "Players" in the main menu, and click
the "Upgrade" link for the player that you wish to upgrade. You will be asked to provide a user name and password
for the new user.
Players may only be upgraded by users with the appropriate
permissions set.
Editing player profile information
To edit the
player profile of
players in the system, display the
player list by clicking "Players" in the main menu. From here, you may click the "Edit"
link for a player to edit that player's profile.
The form that appears allows you to edit the
Player Profile for the player, and also their
User Profile, if you have the correct permissions.
Player profile information is visible on the
Game Play Details page.
Player Profile information may only be edited by users with the appropriate
permissions set. Regardless
of the permission settings, you may always edit your own Profile information.