149 lines
4.1 KiB
PHP
149 lines
4.1 KiB
PHP
<?php
|
|
/**
|
|
* @package Joomla.Platform
|
|
* @subpackage Facebook
|
|
*
|
|
* @copyright Copyright (C) 2005 - 2012 Open Source Matters, Inc. All rights reserved.
|
|
* @license GNU General Public License version 2 or later; see LICENSE
|
|
*/
|
|
|
|
|
|
defined('JPATH_PLATFORM') or die();
|
|
|
|
|
|
/**
|
|
* Facebook API Post class for the Joomla Platform.
|
|
*
|
|
* @package Joomla.Platform
|
|
* @subpackage Facebook
|
|
*
|
|
* @see http://developers.facebook.com/docs/reference/api/post/
|
|
* @since 13.1
|
|
*/
|
|
class JFacebookPost extends JFacebookObject
|
|
{
|
|
/**
|
|
* Method to get a post. Requires authentication and read_stream permission for all data.
|
|
*
|
|
* @param string $post The post id.
|
|
*
|
|
* @return mixed The decoded JSON response or false if the client is not authenticated.
|
|
*
|
|
* @since 13.1
|
|
*/
|
|
public function getPost($post)
|
|
{
|
|
return $this->get($post);
|
|
}
|
|
|
|
/**
|
|
* Method to delete a post if it was created by this application. Requires authentication and publish_stream permission
|
|
*
|
|
* @param string $post The post id.
|
|
*
|
|
* @return boolean Returns true if successful, and false otherwise.
|
|
*
|
|
* @since 13.1
|
|
*/
|
|
public function deletePost($post)
|
|
{
|
|
return $this->deleteConnection($post);
|
|
}
|
|
|
|
/**
|
|
* Method to get a post's comments. Requires authentication and read_stream permission.
|
|
*
|
|
* @param string $post The post id.
|
|
* @param integer $limit The number of objects per page.
|
|
* @param integer $offset The object's number on the page.
|
|
* @param string $until A unix timestamp or any date accepted by strtotime.
|
|
* @param string $since A unix timestamp or any date accepted by strtotime.
|
|
*
|
|
* @return mixed The decoded JSON response or false if the client is not authenticated.
|
|
*
|
|
* @since 13.1
|
|
*/
|
|
public function getComments($post, $limit = 0, $offset = 0, $until = null, $since = null)
|
|
{
|
|
return $this->getConnection($post, 'comments', '', $limit, $offset, $until, $since);
|
|
}
|
|
|
|
/**
|
|
* Method to comment on a post. Requires authentication and publish_stream permission
|
|
*
|
|
* @param string $post The post id.
|
|
* @param string $message The comment's text.
|
|
*
|
|
* @return mixed The decoded JSON response or false if the client is not authenticated.
|
|
*
|
|
* @since 13.1
|
|
*/
|
|
public function createComment($post, $message)
|
|
{
|
|
// Set POST request parameters.
|
|
$data['message'] = $message;
|
|
|
|
return $this->createConnection($post, 'comments', $data);
|
|
}
|
|
|
|
/**
|
|
* Method to delete a comment. Requires authentication and publish_stream permission
|
|
*
|
|
* @param string $comment The comment's id.
|
|
*
|
|
* @return boolean Returns true if successful, and false otherwise.
|
|
*
|
|
* @since 13.1
|
|
*/
|
|
public function deleteComment($comment)
|
|
{
|
|
return $this->deleteConnection($comment);
|
|
}
|
|
|
|
/**
|
|
* Method to get post's likes. Requires authentication and read_stream permission.
|
|
*
|
|
* @param string $post The post id.
|
|
* @param integer $limit The number of objects per page.
|
|
* @param integer $offset The object's number on the page.
|
|
* @param string $until A unix timestamp or any date accepted by strtotime.
|
|
* @param string $since A unix timestamp or any date accepted by strtotime.
|
|
*
|
|
* @return mixed The decoded JSON response or false if the client is not authenticated.
|
|
*
|
|
* @since 13.1
|
|
*/
|
|
public function getLikes($post, $limit = 0, $offset = 0, $until = null, $since = null)
|
|
{
|
|
return $this->getConnection($post, 'likes', '', $limit, $offset, $until, $since);
|
|
}
|
|
|
|
/**
|
|
* Method to like a post. Requires authentication and publish_stream permission
|
|
*
|
|
* @param string $post The post id.
|
|
*
|
|
* @return boolean Returns true if successful, and false otherwise.
|
|
*
|
|
* @since 13.1
|
|
*/
|
|
public function createLike($post)
|
|
{
|
|
return $this->createConnection($post, 'likes');
|
|
}
|
|
|
|
/**
|
|
* Method to unlike a post. Requires authentication and publish_stream permission
|
|
*
|
|
* @param string $post The post id.
|
|
*
|
|
* @return boolean Returns true if successful, and false otherwise.
|
|
*
|
|
* @since 13.1
|
|
*/
|
|
public function deleteLike($post)
|
|
{
|
|
return $this->deleteConnection($post, 'likes');
|
|
}
|
|
}
|