Facebook Permissions

scope.php

<?php
	$scope = "";
	
	// From: https://developers.facebook.com/docs/authentication/permissions/
	
	/*********************
	* User and Friends Permissions
	* You can ask for the following permissions for users and friends in the scope parameter as part of the authentication process.
	* If you are using the Enhanced Auth Dialog, the following permissions are not user-revokable within the authentication flow.
	* If you request these permissions from the user as part of first-time authentication, the user must grant these permissions
	* in order to continue and authorize your application.
	*********************/
	
	// Provides access to the "About Me" section of the profile in the about property
	// $scope .= "user_about_me,";
	// $scope .= "friends_about_me,";
	
	// Provides access to the user's list of activities as the activities connection
	// $scope .= "user_activities,";
	// $scope .= "friends_activities,"; 
	
	// Provides access to the birthday with year as the birthday property
	// $scope .= "user_birthday,";
	// $scope .= "friends_birthday,";
	
	// Provides read access to the authorized user's check-ins or a friend's check-ins that the user can see.
	// This permission is superseded by user_status for new applications as of March, 2012.
	// $scope .= "user_checkins,";
	// $scope .= "friends_checkins,";
	
	// Provides access to education history as the education property
	// $scope .= "user_education_history,";
	// $scope .= "friends_education_history ,";
	
	// Provides access to the list of events the user is attending as the events connection
	// $scope .= "user_events,";
	// $scope .= "friends_events,";
	
	// Provides access to the list of groups the user is a member of as the groups connection
	// $scope .= "user_groups,";
	// $scope .= "friends_groups,";
	
	// Provides access to the user's hometown in the hometown property
	// $scope .= "user_hometown,";
	// $scope .= "friends_hometown,";
	
	// Provides access to the user's list of interests as the interests connection
	// $scope .= "user_interests,";
	// $scope .= "friends_interests,";
	
	// Provides access to the list of all of the pages the user has liked as the likes connection
	// $scope .= "user_likes,";
	// $scope .= "friends_likes,";
	
	// Provides access to the user's current location as the location property
	// $scope .= "user_location,";
	// $scope .= "friends_location,";
	
	// Provides access to the user's notes as the notes connection
	// $scope .= "user_notes,";
	// $scope .= "friends_notes,";
	
	// Provides access to the photos the user has uploaded, and photos the user has been tagged in
	// $scope .= "user_photos,";
	// $scope .= "friends_photos,";
	
	// Provides access to the questions the user or friend has asked
	// $scope .= "user_questions,";
	// $scope .= "friends_questions,";
	
	// Provides access to the user's family and personal relationships and relationship status
	// $scope .= "user_relationships,";
	// $scope .= "friends_relationships,";
	
	// Provides access to the user's relationship preferences
	// $scope .= "user_relationship_details,";
	// $scope .= "friends_relationship_details,";
	
	// Provides access to the user's religious and political affiliations
	// $scope .= "user_religion_politics,";
	// $scope .= "friends_religion_politics,";
	
	// Provides access to the user's status messages and checkins. Please see the documentation for the location_post table for
	// information on how this permission may affect retrieval of information about the locations associated with posts.
	// $scope .= "user_status,";
	// $scope .= "friends_status,";
	
	// Provides access to the videos the user has uploaded, and videos the user has been tagged in
	// $scope .= "user_videos,";
	// $scope .= "friends_videos,";
	
	// Provides access to the user's web site URL
	// $scope .= "user_website,";
	// $scope .= "friends_website,";
	
	// Provides access to work history as the work property
	// $scope .= "user_work_history,";
	// $scope .= "friends_work_history,";
	
	// Provides access to the user's primary email address in the email property. Do not spam users.
	// Your use of email must comply both with Facebook policies and with the CAN-SPAM Act.
	// $scope .= "email,";

	
	/*********************
	* Extended Permissions
	* If you are using the Enhanced Auth Dialog, extended permissions are presented on the second page
	* of the dialog and are individually user-revocable. If you request these permissions, the user can choose to not grant
	* one or more of them. Your application should not expect the user to always grant these permissions if requested.
	*********************/
	
	// Provides access to any friend lists the user created. All user's friends are provided as part of basic data,
	// this extended permission grants access to the lists of friends a user has created, and should only be
	// requested if your application utilizes lists of friends.
	// $scope .= "read_friendlists,";
	
	// Provides read access to the Insights data for pages, applications, and domains the user owns.
	// $scope .= "read_insights,";
	
	// Provides the ability to read from a user's Facebook Inbox.
	// $scope .= "read_mailbox,";
	
	// Provides read access to the user's friend requests
	// $scope .= "read_requests,";
	
	// Provides access to all the posts in the user's News Feed and enables your application to perform searches against the user's News Feed
	// $scope .= "read_stream,";
	
	// Provides applications that integrate with Facebook Chat the ability to log in users.
	// $scope .= "xmpp_login,";
	
	// Provides the ability to manage ads and call the Facebook Ads API on behalf of a user.
	// $scope .= "ads_management,";
	
	// Enables your application to create and modify events on the user's behalf
	// $scope .= "create_event,";
	
	// Enables your app to create and edit the user's friend lists.
	// $scope .= "manage_friendlists,";
	
	// Enables your app to read notifications and mark them as read.
	// $scope .= "manage_notifications,";
	
	// Provides access to the user's online/offline presence
	// $scope .= "user_online_presence,";
	
	// Provides access to the user's friend's online/offline presence
	// $scope .= "friends_online_presence,";
	
	// Enables your app to perform checkins on behalf of the user.
	// $scope .= "publish_checkins,";
	
	// Enables your app to post content, comments, and likes to a user's stream and to the streams of the user's friends.
	// With this permission, you can publish content to a user's feed at any time. However, please note that Facebook
	// recommends a user-initiated sharing model. Please read the Platform Policies to ensure you understand how to
	// properly use this permission. Note, you do not need to request the publish_stream permission in order to use
	// the Feed Dialog, the Requests Dialog or the Send Dialog.
	// $scope .= "publish_stream,";
	
	// Enables your application to RSVP to events on the user's behalf
	// $scope .= "rsvp_event,";

	/*********************
	* Open Graph Permissions
	* Open Graph permissions allow your app to publish actions to the Open Graph and also to retrieve actions published by
	* other applications. To request these permissions, you must enable the Enhanced Auth Dialog. The Open Graph permissions
	* all appear on the first screen of the auth dialog. As with User and Friend permissions, if you request these permissions,
	* the user must grant them before authorizing your app.
	*********************/

	// Allows your app to publish to the Open Graph using Built-in Actions, Achievements, Scores, or Custom Actions.
	// It also allows you to publish a Post object to a User's feed connection. Note: The user-prompt for this permission will
	// be displayed in the first screen of the Enhanced Auth Dialog and cannot be revoked as part of the authentication flow.
	// However, a user can later revoke this permission in their Account Settings. If you want to be notified if this happens,
	// you should subscribe to the permissions object within the Realtime API.
	// $scope .= "publish_actions,";

	// Allows you to retrieve the actions published by all applications using the built-in music.listens action.
	// $scope .= "user_actions.music,";
	// $scope .= "friends_actions.music,";

	// Allows you to retrieve the actions published by all applications using the built-in news.reads action.
	// $scope .= "user_actions.news,";
	// $scope .= "friends_actions.news,";
	
	// Allows you to retrieve the actions published by all applications using the built-in video.watches action.
	// $scope .= "user_actions.video,";
	// $scope .= "friends_actions.video,";
	
	// Allows you retrieve the actions published by another application as specified by the app namespace. For example, to
	// request the ability to retrieve the actions published by an app which has the namespace awesomeapp, prompt the user
	// for the users_actions:awesomeapp and/or friends_actions:awesomeapp permissions.
	// $scope .= "user_actions:APP_NAMESPACE,";
	// $scope .= "friends_actions:APP_NAMESPACE,";
	
	// Allows you post and retrieve game achievement activity.
	// $scope .= "user_games_activity,";
	// $scope .= "friends_games_activity,";

	/*********************
	* Page Permissions
	*********************/
	
	// Enables your application to retrieve access_tokens for Pages and Applications that the user administrates. The access
	// tokens can be queried by calling /me/accounts via the Graph API. This permission is only compatible with the Graph API, not the deprecated REST API.
	// $scope .= "manage_pages,";

	/*********************
	* Deprecated
	*********************/
	
	// Allows usage of the api without the user being logged in.
	// $scope .= "offline_access,";
	
	$scope = trim($scope, ',');
?>