Version 4.7.0

applications/forums/api/posts.php

@@ -112,7 +112,43 @@ class _posts extends \IPS\Content\Api\CommentController
 			throw new \IPS\Api\Exception( 'INVALID_ID', '1F295/4', 404 );
 		}
 	}
-	
+
+	/**
+	 * POST /forums/posts/{id}/react
+	 * Add a reaction
+	 *
+	 * @param		int		$id			ID Number
+	 * @apiparam	int		id			ID of the reaction to add
+	 * @apiparam	int     author      ID of the member reacting
+	 * @return		\IPS\forums\Topic\Post
+	 * @throws		1S425/2		NO_REACTION	The reaction ID does not exist
+	 * @throws		1S425/3		NO_AUTHOR	The author ID does not exist
+	 * @throws		1S425/4		REACT_ERROR	Error adding the reaction
+	 * @throws		1S425/5		INVALID_ID	Object ID does not exist
+	 * @note		If the author has already reacted to this content, any existing reaction will be removed first
+	 */
+	public function POSTitem_react( $id )
+	{
+		return $this->_reactAdd( $id );
+	}
+
+	/**
+	 * DELETE /forums/posts/{id}/react
+	 * Delete a reaction
+	 *
+	 * @param		int		$id			ID Number
+	 * @apiparam	int     author      ID of the member who reacted
+	 * @return		\IPS\forums\Topic\Post
+	 * @throws		1S425/6		NO_AUTHOR	The author ID does not exist
+	 * @throws		1S425/7		REACT_ERROR	Error adding the reaction
+	 * @throws		1S425/8		INVALID_ID	Object ID does not exist
+	 * @note		If the author has already reacted to this content, any existing reaction will be removed first
+	 */
+	public function DELETEitem_react( $id )
+	{
+		return $this->_reactRemove( $id );
+	}
+
 	/**
 	 * POST /forums/posts
 	 * Create a post
@@ -125,10 +161,12 @@ class _posts extends \IPS\Content\Api\CommentController
 	 * @apiparam	datetime	date				The date/time that should be used for the topic/post post date. If not provided, will use the current date/time. Ignored for requests using an OAuth Access Token for a particular member
 	 * @apiparam	string		ip_address			The IP address that should be stored for the topic/post. If not provided, will use the IP address from the API request. Ignored for requests using an OAuth Access Token for a particular member
 	 * @apiparam	int			hidden				0 = unhidden; 1 = hidden, pending moderator approval; -1 = hidden (as if hidden by a moderator)
+	 * @apiparam	bool		anonymous		If 1, the item will be posted anonymously.
 	 * @throws		1F295/1		NO_TOPIC	The topic ID does not exist
 	 * @throws		1F295/2		NO_AUTHOR	The author ID does not exist
 	 * @throws		1F295/3		NO_POST		No post was supplied
 	 * @throws		2F294/A		NO_PERMISSION	The authorized user does not have permission to reply to that topic
+	 * @throws		3F295/C		NO_ANON_PERMISSION	The topic is set for anonymous posting, but the author does not have permission to post anonymously
 	 * @return		\IPS\forums\Topic\Post
 	 */
 	public function POSTindex()
@@ -164,8 +202,24 @@ class _posts extends \IPS\Content\Api\CommentController
 			}
 			else
 			{
-				$author = new \IPS\Member;
-				$author->name = \IPS\Request::i()->author_name;
+				if ( \IPS\Request::i()->author === 0 ) 
+				{
+					$author = new \IPS\Member;
+					$author->name = \IPS\Request::i()->author_name;
+				}
+				else 
+				{
+					throw new \IPS\Api\Exception( 'NO_AUTHOR', '1F295/2', 400 );
+				}
+			}
+		}
+
+		/* Check anonymous posting */
+		if ( isset( \IPS\Request::i()->anonymous ) and $author->member_id )
+		{
+			if ( ! $topic->container()->canPostAnonymously( 0, $author ) )
+			{
+				throw new \IPS\Api\Exception( 'NO_ANON_PERMISSION', '3F295/C', 403 );
 			}
 		}
 		
@@ -189,6 +243,7 @@ class _posts extends \IPS\Content\Api\CommentController
 	 * @apiparam	string		author_name		If author is 0, the guest name that should be used
 	 * @apiparam	string		post			The post content as HTML (e.g. "<p>This is a post.</p>"). Will be sanatized for requests using an OAuth Access Token for a particular member; will be saved unaltered for requests made using an API Key or the Client Credentials Grant Type. 
 	 * @apiparam	int			hidden			1/0 indicating if the topic should be hidden
+	 * @apiparam	bool		anonymous		If 1, the item will be posted anonymously.
 	 * @throws		2F295/6		INVALID_ID					The post ID does not exist or the authorized user does not have permission to view it
 	 * @throws		2F295/7		NO_AUTHOR					The author ID does not exist
 	 * @throws		1F295/8		CANNOT_HIDE_FIRST_POST		You cannot hide or unhide the first post in a topic. Hide/unhide the topic itself instead.
@@ -273,4 +328,21 @@ class _posts extends \IPS\Content\Api\CommentController
 			throw new \IPS\Api\Exception( 'INVALID_ID', '1F295/5', 404 );
 		}
 	}
+
+	/**
+	 * POST /forums/posts/{id}/report
+	 * Reports a post
+	 *
+	 * @param		int		$id			ID Number
+	 * @apiparam	int     author      ID of the member reporting
+	 * @apiparam	int     report_type Report type (0 is default and is for letting CMGR team know, more options via core_automatic_moderation_types)
+	 * @apiparam	string  message  	Optional message
+	 * @return		\IPS\forums\Topic\Post
+	 * @throws		1S425/B		NO_AUTHOR			The author ID does not exist
+	 * @throws		1S425/C		REPORTED_ALREADY	The member has reported this item in the past 24 hours
+	 */
+	public function POSTitem_report( $id )
+	{
+		return $this->_report( $id );
+	}
 }