Method to create an album for a user. Requires authentication and publish_stream permission.
mixed
createAlbum
(mixed $user, string $name, [string $description = null], [json $privacy = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$name: Album name.
-
string
$description: Album description.
-
json
$privacy: A JSON-encoded object that defines the privacy setting for the album.
Method to create a checkin for a user. Requires authentication and publish_checkins permission.
mixed
createCheckin
(mixed $user, string $place, string $coordinates, [string $tags = null], [string $message = null], [string $link = null], [string $picture = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$place: Id of the Place Page.
-
string
$coordinates: A JSON-encoded string containing latitute and longitude.
-
string
$tags: Comma separated list of USER_IDs.
-
string
$message: A message to add to the checkin.
-
string
$link: A link to add to the checkin.
-
string
$picture: A picture to add to the checkin.
Method to create an event for a user. Requires authentication create_event permission.
mixed
createEvent
(mixed $user, string $name, string $start_time, [string $end_time = null], [string $description = null], [string $location = null], [string $location_id = null], [string $privacy_type = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$name: Event name.
-
string
$start_time: Event start time as UNIX timestamp.
-
string
$end_time: Event end time as UNIX timestamp.
-
string
$description: Event description.
-
string
$location: Event location.
-
string
$location_id: Facebook Place ID of the place the Event is taking place.
-
string
$privacy_type: Event privacy setting, a string containing 'OPEN' (default), 'CLOSED', or 'SECRET'.
Method to post a link on user's feed. Requires authentication and publish_stream permission.
mixed
createLink
(mixed $user, string $link, [strin $message = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$link: Link URL.
-
strin
$message: Link message.
Method to create a note on the behalf of the user.
Requires authentication and publish_stream permission, user_groups or friends_groups permission.
mixed
createNote
(mixed $user, string $subject, string $message)
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$subject: The subject of the note.
-
string
$message: Note content.
Method to post a photo on user's wall. Requires authentication and publish_stream permission, user_groups or friends_groups permission.
mixed
createPhoto
(mixed $user, string $source, [string $message = null], [string $place = null], [boolean $no_story = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$source: Path to photo.
-
string
$message: Photo description.
-
string
$place: Facebook ID of the place associated with the photo.
-
boolean
$no_story: If set to 1, optionally suppresses the feed story that is automatically generated on a user’s profile when they upload a photo using your application.
Method to post on a user's wall. Message or link parameter is required. Requires authentication and publish_stream permission.
mixed
createPost
(mixed $user, [string $message = null], [string $link = null], [string $picture = null], [string $name = null], [string $caption = null], [string $description = null], [array $actions = null], [string $place = null], [string $tags = null], [string $privacy = null], [string $object_attachment = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$message: Post message.
-
string
$link: Post URL.
-
string
$picture: Post thumbnail image (can only be used if link is specified)
-
string
$name: Post name (can only be used if link is specified).
-
string
$caption: Post caption (can only be used if link is specified).
-
string
$description: Post description (can only be used if link is specified).
-
array
$actions: Post actions array of objects containing name and link.
-
string
$place: Facebook Page ID of the location associated with this Post.
-
string
$tags: Comma-separated list of Facebook IDs of people tagged in this Post. For example: 1207059,701732. You cannot specify this field without also specifying a place.
-
string
$privacy: Post privacy settings (can only be specified if the Timeline being posted on belongs to the User creating the Post).
-
string
$object_attachment: Facebook ID for an existing picture in the User's photo albums to use as the thumbnail image. The User must be the owner of the photo, and the photo cannot be part of a message attachment.
Method to post a status message on behalf of the user. Requires authentication publish_stream permission.
mixed
createStatus
(mixed $user, string $message)
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$message: Status message content.
Method to post a video on behalf of the user. Requires authentication and publish_stream permission.
mixed
createVideo
(mixed $user, string $source, [string $title = null], [string $description = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$source: Path to video.
-
string
$title: Video title.
-
string
$description: Video description.
Method to delete an event. Note: you can only delete the event if it was created by the same app. Requires authentication create_event permission.
boolean
deleteEvent
(string $event)
Method to delete a link. Requires authentication and publish_stream permission.
boolean
deleteLink
(mixed $link)
-
mixed
$link: The Link ID.
Method to revoke a specific permission on behalf of a user. Requires authentication.
mixed
deletePermission
(mixed $user, [string $permission = ''])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$permission: The permission to revoke. If none specified, then this will de-authorize the application completely.
Method to delete a post. Note: you can only delete the post if it was created by the current user. Requires authentication
mixed
deletePost
(string $post)
-
string
$post: The Post ID.
Method to delete a status. Note: you can only delete the post if it was created by the current user.
Requires authentication publish_stream permission.
mixed
deleteStatus
(string $status)
-
string
$status: The Status ID.
Method to edit an event. Requires authentication create_event permission.
mixed
editEvent
(mixed $event, [string $name = null], [string $start_time = null], [string $end_time = null], [string $description = null], [string $location = null], [string $location_id = null], [string $privacy_type = null])
-
mixed
$event: Event ID.
-
string
$name: Event name.
-
string
$start_time: Event start time as UNIX timestamp.
-
string
$end_time: Event end time as UNIX timestamp.
-
string
$description: Event description.
-
string
$location: Event location.
-
string
$location_id: Facebook Place ID of the place the Event is taking place.
-
string
$privacy_type: Event privacy setting, a string containing 'OPEN' (default), 'CLOSED', or 'SECRET'.
Method to get the activities listed on the user's profile. Requires authentication and user_activities or friends_activities permission.
mixed
getActivities
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's albums. Requires authentication and user_photos or friends_photos permission.
mixed
getAlbums
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the books listed on the user's profile. Requires authentication and user_likes or friends_likes permission.
mixed
getBooks
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's checkins. Requires authentication and user_checkins or friends_checkins permission
mixed
getCheckins
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the current user's events. Requires authentication and user_events or friends_events permission.
mixed
getEvents
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's family relationships. Requires authentication and user_relationships permission..
mixed
getFamily
(mixed $user, [integer $limit = 0], [integer $offset = 0])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
Method to get the user's wall. Requires authentication and read_stream permission.
mixed
getFeed
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's friend lists. Requires authentication and read_friendlists permission.
mixed
getFriendLists
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's incoming friend requests. Requires authentication and read_requests permission.
mixed
getFriendRequests
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the specified user's friends. Requires authentication.
mixed
getFriends
(mixed $user, [integer $limit = 0], [integer $offset = 0])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
Method to get the groups that the user belongs to. Requires authentication and user_groups or friends_groups permission.
mixed
getGroups
(mixed $user, [integer $limit = 0], [integer $offset = 0])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
Method to get the user's news feed. Requires authentication and read_stream permission.
mixed
getHome
(mixed $user, [string $filter = null], [boolean $location = false], [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$filter: User's stream filter.
-
boolean
$location: Retreive only posts with a location attached.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the interests listed on the user's profile. Requires authentication.
mixed
getInterests
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's likes. Requires authentication and user_likes or friends_likes permission.
mixed
getLikes
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's posted links. Requires authentication and user_groups or friends_groups permission.
mixed
getLinks
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the movies listed on the user's profile. Requires authentication and user_likes or friends_likes permission.
mixed
getMovies
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the music listed on the user's profile. Requires authentication user_likes or friends_likes permission.
mixed
getMusic
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get mutual friends of one user and the current user. Requires authentication.
mixed
getMutualFriends
(mixed $current_user, mixed $user, [integer $limit = 0], [integer $offset = 0])
-
mixed
$current_user: Either an integer containing the user ID or a string containing the username for the current user.
-
mixed
$user: Either an integer containing the user ID or a string containing the username for the user.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
Method to get the user's notes. Requires authentication and user_groups or friends_groups permission.
mixed
getNotes
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's notifications. Requires authentication and manage_notifications permission.
mixed
getNotifications
(mixed $user, [boolean $read = null], [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
boolean
$read: Enables you to see notifications that the user has already read.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's permissions. Requires authentication.
mixed
getPermissions
(mixed $user, [integer $limit = 0], [integer $offset = 0])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
Method to get the user's photos. Requires authentication and user_groups or friends_groups permission.
mixed
getPhotos
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's profile picture. Requires authentication.
string
getPicture
(mixed $user, [boolean $redirect = true], [string $type = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
boolean
$redirect: If false this will return the URL of the profile picture without a 302 redirect.
-
string
$type: To request a different photo use square | small | normal | large.
Method to get the user's posts. Requires authentication and read_stream permission for non-public posts.
mixed
getPosts
(mixed $user, [boolean $location = false], [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
boolean
$location: Retreive only posts with a location attached.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the user's statuses. Requires authentication read_stream permission.
mixed
getStatuses
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the people the user is subscribed to. Requires authentication and user_subscriptions or friends_subscriptions permission.
mixed
getSubscribedTo
(mixed $user, [integer $limit = 0], [integer $offset = 0])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
Method to get the user's subscribers. Requires authentication and user_subscriptions or friends_subscriptions permission.
mixed
getSubscribers
(mixed $user, [integer $limit = 0], [integer $offset = 0])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
Method to get the posts the user has been tagged in. Requires authentication and user_videos or friends_videos permission.
mixed
getTagged
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the television listed on the user's profile. Requires authentication and user_likes or friends_likes permission.
mixed
getTelevision
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to get the specified user's details. Authentication is required only for some fields.
mixed
getUser
(mixed $user)
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
Method to get the videos the user has been tagged in. Requires authentication and user_videos or friends_videos permission.
mixed
getVideos
(mixed $user, [integer $limit = 0], [integer $offset = 0], [string $until = null], [string $since = null])
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
integer
$limit: The number of objects per page.
-
integer
$offset: The object's number on the page.
-
string
$until: A unix timestamp or any date accepted by strtotime.
-
string
$since: A unix timestamp or any date accepted by strtotime.
Method to see if a user is a friend of the current user. Requires authentication.
mixed
hasFriend
(mixed $current_user, mixed $user)
-
mixed
$current_user: Either an integer containing the user ID or a string containing the username for the current user.
-
mixed
$user: Either an integer containing the user ID or a string containing the username for the user.
Method to see if a user likes a specific Page. Requires authentication.
mixed
likesPage
(mixed $user, string $page)
-
mixed
$user: Either an integer containing the user ID or a string containing the username.
-
string
$page: Facebook ID of the Page.
Method to mark a notification as read. Requires authentication and manage_notifications permission.
boolean
updateNotification
(string $notification)
-
string
$notification: The notification id.
Inherited Methods
Inherited From JFacebookObject
JFacebookObject::__construct()
JFacebookObject::createConnection()
JFacebookObject::deleteConnection()
JFacebookObject::fetchUrl()
JFacebookObject::get()
JFacebookObject::getConnection()
JFacebookObject::getOAuth()
JFacebookObject::sendRequest()
JFacebookObject::setOAuth()