first commit

2020-01-02 22:20:31 +07:00
commit 10eb3340ad
5753 changed files with 631345 additions and 0 deletions
--- a/libraries/joomla/twitter/favorites.php
+++ b/libraries/joomla/twitter/favorites.php
@ -0,0 +1,134 @@
+<?php
+/**
+ * @package     Joomla.Platform
+ * @subpackage  Twitter
+ *
+ * @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();
+
+/**
+ * Twitter API Favorites class for the Joomla Platform.
+ *
+ * @package     Joomla.Platform
+ * @subpackage  Twitter
+ * @since       12.3
+ */
+class JTwitterFavorites extends JTwitterObject
+{
+	/**
+	 * Method to get the most recent favorite statuses for the authenticating or specified user.
+	 *
+	 * @param   mixed    $user      Either an integer containing the user ID or a string containing the screen name.
+	 * @param   integer  $count     Specifies the number of tweets to try and retrieve, up to a maximum of 200.  Retweets are always included
+	 *                              in the count, so it is always suggested to set $include_rts to true
+	 * @param   integer  $since_id  Returns results with an ID greater than (that is, more recent than) the specified ID.
+	 * @param   integer  $max_id    Returns results with an ID less than (that is, older than) the specified ID.
+	 * @param   boolean  $entities  When set to true,  each tweet will include a node called "entities,". This node offers a variety
+	 * 								of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags.
+	 *
+	 * @return  array  The decoded JSON response
+	 *
+	 * @since   12.3
+	 */
+	public function getFavorites($user = null, $count = 20, $since_id = 0, $max_id = 0, $entities = null)
+	{
+		// Check the rate limit for remaining hits
+		$this->checkRateLimit('favorites', 'list');
+
+		// Set the API path.
+		$path = '/favorites/list.json';
+
+		// Determine which type of data was passed for $user
+		if (is_numeric($user))
+		{
+			$data['user_id'] = $user;
+		}
+		elseif (is_string($user))
+		{
+			$data['screen_name'] = $user;
+		}
+
+		// Set the count string
+		$data['count'] = $count;
+
+		// Check if since_id is specified.
+		if ($since_id > 0)
+		{
+			$data['since_id'] = $since_id;
+		}
+
+		// Check if max_id is specified.
+		if ($max_id > 0)
+		{
+			$data['max_id'] = $max_id;
+		}
+
+		// Check if entities is specified.
+		if (!is_null($entities))
+		{
+			$data['include_entities'] = $entities;
+		}
+
+		// Send the request.
+		return $this->sendRequest($path, 'GET', $data);
+	}
+
+	/**
+	 * Method to favorite the status specified in the ID parameter as the authenticating user
+	 *
+	 * @param   integer  $id        The numerical ID of the desired status.
+	 * @param   boolean  $entities  When set to true,  each tweet will include a node called "entities,". This node offers a variety
+	 * 								of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags.
+	 *
+	 * @return  array  The decoded JSON response
+	 *
+	 * @since   12.3
+	 */
+	public function createFavorites($id, $entities = null)
+	{
+		// Set the API path.
+		$path = '/favorites/create.json';
+
+		$data['id'] = $id;
+
+		// Check if entities is specified.
+		if (!is_null($entities))
+		{
+			$data['include_entities'] = $entities;
+		}
+
+		// Send the request.
+		return $this->sendRequest($path, 'POST', $data);
+	}
+
+	/**
+	 * Method to un-favorites the status specified in the ID parameter as the authenticating user.
+	 *
+	 * @param   integer  $id        The numerical ID of the desired status.
+	 * @param   boolean  $entities  When set to true,  each tweet will include a node called "entities,". This node offers a variety
+	 * 								of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags.
+	 *
+	 * @return  array  The decoded JSON response
+	 *
+	 * @since   12.3
+	 */
+	public function deleteFavorites($id, $entities = null)
+	{
+		// Set the API path.
+		$path = '/favorites/destroy.json';
+
+		$data['id'] = $id;
+
+		// Check if entities is specified.
+		if (!is_null($entities))
+		{
+			$data['include_entities'] = $entities;
+		}
+
+		// Send the request.
+		return $this->sendRequest($path, 'POST', $data);
+	}
+}