.. include:: ../../Includes.txt



.. _Access-types:

Access types
^^^^^^^^^^^^

To manage access (rights) to private data severeal types of access are
defined. The definition depends on who is requesting, who is requested
and if the users are friends or not.

+------------------+----------------+-------------+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Requesting user  | Requested user | Are friends | Access type                  | Notes                                                                                                                                                                                     |
| (logged in user) |                |             |                              |                                                                                                                                                                                           |
+==================+================+=============+==============================+===========================================================================================================================================================================================+
| NULL             | NULL           | -           | ACCESS_PUBLIC                | Public, guest access, No logged in user.  No requested (target) user parameter. This type of access can be granted to plugins which are not user specific, e.g “list of 10 newest users”. |
+------------------+----------------+-------------+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| NULL             | John           | -           | ACCESS_NOBODY                | Public, guest access, no logged in user. Public, but user specific plugins.                                                                                                               |
+------------------+----------------+-------------+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Bill             | John           | NO          | ACCESS_OTHER                 | Bill is logged in, but he is not a friend with John                                                                                                                                       |
+------------------+----------------+-------------+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Bill             | John           | YES         | ACCESS_FRIEND                |                                                                                                                                                                                           |
+------------------+----------------+-------------+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| John             | John | NULL    | -           | Access granted by default.   | If requested user is not set, and we are logged in, then requestedUser = requestingUser – e.g. we are seeing our own profile                                                              |
+------------------+----------------+-------------+------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+