154 lines
4.3 KiB
PHP
154 lines
4.3 KiB
PHP
<?php
|
|
/**
|
|
* @brief Download categories API
|
|
* @author <a href='https://www.invisioncommunity.com'>Invision Power Services, Inc.</a>
|
|
* @copyright (c) Invision Power Services, Inc.
|
|
* @license https://www.invisioncommunity.com/legal/standards/
|
|
* @package Invision Community
|
|
* @subpackage Downloads
|
|
* @since 3 Apr 2017
|
|
*/
|
|
|
|
namespace IPS\downloads\api;
|
|
|
|
/* To prevent PHP errors (extending class does not exist) revealing path */
|
|
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
|
|
{
|
|
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
|
|
exit;
|
|
}
|
|
|
|
/**
|
|
* @brief Downloads Category API
|
|
*/
|
|
class _categories extends \IPS\Node\Api\NodeController
|
|
{
|
|
/**
|
|
* Class
|
|
*/
|
|
protected $class = 'IPS\downloads\Category';
|
|
|
|
/**
|
|
* GET /downloads/category
|
|
* Get list of categories
|
|
*
|
|
* @return \IPS\Api\PaginatedResponse<IPS\downloads\Category>
|
|
*/
|
|
public function GETindex()
|
|
{
|
|
/* Return */
|
|
return $this->_list();
|
|
}
|
|
|
|
/**
|
|
* GET /downloads/category/{id}
|
|
* Get specific category
|
|
*
|
|
* @param int $id ID Number
|
|
*
|
|
* @return \IPS\Api\PaginatedResponse<IPS\downloads\Category>
|
|
*/
|
|
public function GETitem( $id )
|
|
{
|
|
/* Return */
|
|
return $this->_view( $id );
|
|
}
|
|
|
|
/**
|
|
* POST /downloads/category
|
|
* Create a category
|
|
*
|
|
* @apiparam int|null parent The ID number of the parent the category should be created in. NULL for root.
|
|
* @apiparam int moderation Files must be approved?
|
|
* @apiparam int moderation_edits New versions must be re-approved?
|
|
* @apiparam int allowss Allow screenshots?
|
|
* @apiparam int reqss Require screenshots?
|
|
* @apiparam int comments Allow comments?
|
|
* @apiparam int comments_moderation Comments must be approved?
|
|
* @apiparam int reviews Allow reviews?
|
|
* @apiparam int reviews_mod Reviews must be approved?
|
|
* @apiparam int reviews_download Files must be downloaded before a review can be left?
|
|
*
|
|
* @return \IPS\downloads\Category
|
|
*/
|
|
public function POSTindex()
|
|
{
|
|
return new \IPS\Api\Response( 201, $this->_create()->apiOutput( $this->member ) );
|
|
}
|
|
|
|
/**
|
|
* POST /downloads/category/{id}
|
|
* Edit a category
|
|
*
|
|
* @apiparam int|null parent The ID number of the parent the category should be created in. NULL for root.
|
|
* @apiparam int moderation Files must be approved?
|
|
* @apiparam int moderation_edits New versions must be re-approved?
|
|
* @apiparam int allowss Allow screenshots?
|
|
* @apiparam int reqss Require screenshots?
|
|
* @apiparam int comments Allow comments?
|
|
* @apiparam int comments_moderation Comments must be approved?
|
|
* @apiparam int reviews Allow reviews?
|
|
* @apiparam int reviews_mod Reviews must be approved?
|
|
* @apiparam int reviews_download Files must be downloaded before a review can be left?
|
|
*
|
|
* @return \IPS\downloads\Category
|
|
*/
|
|
public function POSTitem( $id )
|
|
{
|
|
$class = $this->class;
|
|
$category = $class::load( $id );
|
|
|
|
return new \IPS\Api\Response( 201, $this->_createOrUpdate( $category )->apiOutput( $this->member ) );
|
|
}
|
|
|
|
/**
|
|
* DELETE /downloads/category/{id}
|
|
* Delete a category
|
|
*
|
|
* @param int $id ID Number
|
|
* @return void
|
|
*/
|
|
public function DELETEitem( $id )
|
|
{
|
|
return $this->_delete( $id );
|
|
}
|
|
|
|
/**
|
|
* Create or update node
|
|
*
|
|
* @param \IPS\node\Model $category The node
|
|
* @return \IPS\node\Model
|
|
*/
|
|
protected function _createOrUpdate( \IPS\node\Model $category )
|
|
{
|
|
if ( !\IPS\Request::i()->title )
|
|
{
|
|
throw new \IPS\Api\Exception( 'NO_TITLE', '', 400 );
|
|
}
|
|
|
|
foreach ( array( 'title' => "downloads_category_{$category->id}", 'description' => "downloads_category_{$category->id}_desc" ) as $fieldKey => $langKey )
|
|
{
|
|
if ( isset( \IPS\Request::i()->$fieldKey ) )
|
|
{
|
|
\IPS\Lang::saveCustom( 'downloads', $langKey, \IPS\Request::i()->$fieldKey );
|
|
|
|
if ( $fieldKey === 'title' )
|
|
{
|
|
$category->name_furl = \IPS\Http\Url\Friendly::seoTitle( \IPS\Request::i()->$fieldKey );
|
|
}
|
|
}
|
|
}
|
|
|
|
$category->parent = (int) \IPS\Request::i()->parent?: 0;
|
|
|
|
foreach ( array( 'moderation', 'moderation_edits', 'allowss', 'reqss', 'comments', 'comment_moderation', 'reviews', 'reviews_mod', 'reviews_download' ) as $k )
|
|
{
|
|
if ( isset( \IPS\Request::i()->$k ) )
|
|
{
|
|
$category->bitoptions[ $k ] = \IPS\Request::i()->$k;
|
|
}
|
|
}
|
|
|
|
return parent::_createOrUpdate( $category );
|
|
}
|
|
} |