mirror of
https://github.com/Karaka-Management/oms-Knowledgebase.git
synced 2026-01-11 09:28:40 +00:00
802 lines
25 KiB
PHP
802 lines
25 KiB
PHP
<?php
|
|
/**
|
|
* Jingga
|
|
*
|
|
* PHP Version 8.2
|
|
*
|
|
* @package Modules\Knowledgebase
|
|
* @copyright Dennis Eichhorn
|
|
* @license OMS License 2.2
|
|
* @version 1.0.0
|
|
* @link https://jingga.app
|
|
*/
|
|
declare(strict_types=1);
|
|
|
|
namespace Modules\Knowledgebase\Controller;
|
|
|
|
use Modules\Admin\Models\NullAccount;
|
|
use Modules\Editor\Models\EditorDocHistoryMapper;
|
|
use Modules\Knowledgebase\Models\NullWikiApp;
|
|
use Modules\Knowledgebase\Models\NullWikiCategory;
|
|
use Modules\Knowledgebase\Models\WikiApp;
|
|
use Modules\Knowledgebase\Models\WikiAppMapper;
|
|
use Modules\Knowledgebase\Models\WikiCategory;
|
|
use Modules\Knowledgebase\Models\WikiCategoryL11nMapper;
|
|
use Modules\Knowledgebase\Models\WikiCategoryMapper;
|
|
use Modules\Knowledgebase\Models\WikiDoc;
|
|
use Modules\Knowledgebase\Models\WikiDocHistory;
|
|
use Modules\Knowledgebase\Models\WikiDocMapper;
|
|
use Modules\Knowledgebase\Models\WikiStatus;
|
|
use phpOMS\Localization\BaseStringL11n;
|
|
use phpOMS\Localization\ISO639x1Enum;
|
|
use phpOMS\Message\Http\RequestStatusCode;
|
|
use phpOMS\Message\RequestAbstract;
|
|
use phpOMS\Message\ResponseAbstract;
|
|
use phpOMS\Utils\Parser\Markdown\Markdown;
|
|
|
|
/**
|
|
* Knowledgebase class.
|
|
*
|
|
* @package Modules\Knowledgebase
|
|
* @license OMS License 2.2
|
|
* @link https://jingga.app
|
|
* @since 1.0.0
|
|
*/
|
|
final class ApiController extends Controller
|
|
{
|
|
/**
|
|
* Api method to create a wiki entry
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @question Consider to use the Editor module for the content instead of handling
|
|
* the content separately in the wiki module.
|
|
* https://github.com/Karaka-Management/oms-Knowledgebase/issues/7
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiDocCreate(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
if (!empty($val = $this->validateWikiDocCreate($request))) {
|
|
$response->header->status = RequestStatusCode::R_400;
|
|
$this->createInvalidCreateResponse($request, $response, $val);
|
|
|
|
return;
|
|
}
|
|
|
|
$doc = $this->createWikiDocFromRequest($request, $response, $data);
|
|
$this->createModel($request->header->account, $doc, WikiDocMapper::class, 'doc', $request->getOrigin());
|
|
|
|
if (!empty($request->files)
|
|
|| !empty($request->getDataJson('media'))
|
|
) {
|
|
$this->createWikiMedia($doc, $request);
|
|
}
|
|
|
|
if ($doc->isVersioned) {
|
|
$history = $this->createHistory($doc);
|
|
$this->createModel($request->header->account, $history, EditorDocHistoryMapper::class, 'doc_history', $request->getOrigin());
|
|
}
|
|
|
|
$this->createStandardCreateResponse($request, $response, $doc);
|
|
}
|
|
|
|
/**
|
|
* Create media files for wiki document
|
|
*
|
|
* @param WikiDoc $doc Wiki document
|
|
* @param RequestAbstract $request Request incl. media do upload
|
|
*
|
|
* @return void
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function createWikiMedia(WikiDoc $doc, RequestAbstract $request) : void
|
|
{
|
|
$path = $this->createWikiDir($doc);
|
|
|
|
if (!empty($request->files)) {
|
|
$this->app->moduleManager->get('Media', 'Api')->uploadFiles(
|
|
names: [],
|
|
fileNames: [],
|
|
files: $request->files,
|
|
account: $request->header->account,
|
|
basePath: __DIR__ . '/../../../Modules/Media/Files' . $path,
|
|
virtualPath: $path,
|
|
rel: $doc->id,
|
|
mapper: WikiDocMapper::class,
|
|
field: 'files'
|
|
);
|
|
}
|
|
|
|
if (!empty($media = $request->getDataJson('media'))) {
|
|
$this->app->moduleManager->get('Media', 'Api')->addMediaToCollectionAndModel(
|
|
$request->header->account,
|
|
$media,
|
|
$doc->id,
|
|
WikiDocMapper::class,
|
|
'files',
|
|
$path
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Create media directory path
|
|
*
|
|
* @param WikiDoc $doc Doc
|
|
*
|
|
* @return string
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function createWikiDir(WikiDoc $doc) : string
|
|
{
|
|
return '/Modules/Knowledgebase/'
|
|
. ($doc->category?->id ?? '0') . '/'
|
|
. $doc->id;
|
|
}
|
|
|
|
/**
|
|
* Method to create a wiki entry from request.
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return WikiDoc
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function createWikiDocFromRequest(RequestAbstract $request, ResponseAbstract $response, $data = null) : WikiDoc
|
|
{
|
|
$doc = new WikiDoc();
|
|
$doc->createdBy = new NullAccount($request->header->account);
|
|
$doc->name = (string) $request->getData('title');
|
|
$doc->doc = Markdown::parse($request->getDataString('plain') ?? '');
|
|
$doc->docRaw = $request->getDataString('plain') ?? '';
|
|
$doc->isVersioned = $request->getDataBool('versioned') ?? false;
|
|
$doc->category = new NullWikiCategory($request->getDataInt('category') ?? 1);
|
|
$doc->app = new NullWikiApp($request->getDataInt('app') ?? 1);
|
|
$doc->version = $request->getDataString('version') ?? '';
|
|
$doc->language = ISO639x1Enum::tryFromValue($request->getDataString('language')) ?? $request->header->l11n->language;
|
|
$doc->status = WikiStatus::tryFromValue($request->getDataInt('status')) ?? WikiStatus::INACTIVE;
|
|
|
|
/*
|
|
if ($request->hasData('tags')) {
|
|
$doc->tags = $this->app->moduleManager->get('Tag', 'Api')->createTagsFromRequest($request);
|
|
}
|
|
*/
|
|
|
|
return $doc;
|
|
}
|
|
|
|
/**
|
|
* Create history from document
|
|
*
|
|
* @param WikiDoc $doc Document
|
|
*
|
|
* @return WikiDocHistory
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function createHistory(WikiDoc $doc) : WikiDocHistory
|
|
{
|
|
return WikiDocHistory::createFromDoc($doc);
|
|
}
|
|
|
|
/**
|
|
* Method to validate wiki entry creation from request
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return array<string, bool>
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function validateWikiDocCreate(RequestAbstract $request) : array
|
|
{
|
|
$val = [];
|
|
if (($val['title'] = !$request->hasData('title'))
|
|
|| ($val['plain'] = !$request->hasData('plain'))
|
|
|| ($val['status'] = (
|
|
$request->hasData('status')
|
|
&& !WikiStatus::isValidValue((int) $request->getData('status'))
|
|
))
|
|
) {
|
|
return $val;
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Validate category l11n create request
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return array<string, bool>
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function validateWikiCategoryL11nCreate(RequestAbstract $request) : array
|
|
{
|
|
$val = [];
|
|
if (($val['content'] = !$request->hasData('content'))
|
|
|| ($val['ref'] = !$request->hasData('ref'))
|
|
) {
|
|
return $val;
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Api method to create category localization
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiCategoryL11nCreate(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
if (!empty($val = $this->validateWikiCategoryL11nCreate($request))) {
|
|
$response->header->status = RequestStatusCode::R_400;
|
|
$this->createInvalidCreateResponse($request, $response, $val);
|
|
|
|
return;
|
|
}
|
|
|
|
$l11nWikiCategory = $this->createWikiCategoryL11nFromRequest($request);
|
|
$this->createModel($request->header->account, $l11nWikiCategory, WikiCategoryL11nMapper::class, 'wiki_category_l11n', $request->getOrigin());
|
|
$this->createStandardCreateResponse($request, $response, $l11nWikiCategory);
|
|
}
|
|
|
|
/**
|
|
* Method to create category localization from request.
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return BaseStringL11n
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function createWikiCategoryL11nFromRequest(RequestAbstract $request) : BaseStringL11n
|
|
{
|
|
$l11nWikiCategory = new BaseStringL11n();
|
|
$l11nWikiCategory->ref = $request->getDataInt('ref') ?? 0;
|
|
$l11nWikiCategory->language = ISO639x1Enum::tryFromValue($request->getDataString('language')) ?? $request->header->l11n->language;
|
|
$l11nWikiCategory->content = $request->getDataString('content') ?? '';
|
|
|
|
return $l11nWikiCategory;
|
|
}
|
|
|
|
/**
|
|
* Api method to get a doc
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiDocGet(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiDoc $doc */
|
|
$doc = WikiDocMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
$this->createStandardReturnResponse($request, $response, $doc);
|
|
}
|
|
|
|
/**
|
|
* Api method to create doc
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiDocUpdate(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiDoc $old */
|
|
$old = WikiDocMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
$new = $this->updateDocFromRequest($request, clone $old);
|
|
$this->updateModel($request->header->account, $old, $new, WikiDocMapper::class, 'doc', $request->getOrigin());
|
|
|
|
if ($new->isVersioned
|
|
&& ($old->docRaw !== $new->docRaw
|
|
|| $old->name !== $new->name
|
|
)
|
|
) {
|
|
$history = $this->createHistory($new);
|
|
$this->createModel($request->header->account, $history, EditorDocHistoryMapper::class, 'doc_history', $request->getOrigin());
|
|
}
|
|
|
|
$this->createStandardUpdateResponse($request, $response, $new);
|
|
}
|
|
|
|
/**
|
|
* Method to update doc from request.
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return WikiDoc
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function updateDocFromRequest(RequestAbstract $request, WikiDoc $new) : WikiDoc
|
|
{
|
|
$new->isVersioned = $request->getDataBool('versioned') ?? $new->isVersioned;
|
|
$new->name = $request->getDataString('title') ?? $new->name;
|
|
$new->docRaw = $request->getDataString('plain') ?? $new->docRaw;
|
|
$new->doc = Markdown::parse($request->getDataString('plain') ?? $new->docRaw);
|
|
$new->version = $request->getDataString('version') ?? $new->version;
|
|
|
|
return $new;
|
|
}
|
|
|
|
/**
|
|
* Api method to delete doc
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiDocDelete(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiDoc $doc */
|
|
$doc = WikiDocMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
|
|
$this->deleteModel($request->header->account, $doc, WikiDocMapper::class, 'doc', $request->getOrigin());
|
|
$this->createStandardDeleteResponse($request, $response, $doc);
|
|
}
|
|
|
|
/**
|
|
* Api method to create a wiki category
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiCategoryCreate(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
if (!empty($val = $this->validateWikiCategoryCreate($request))) {
|
|
$response->header->status = RequestStatusCode::R_400;
|
|
$this->createInvalidCreateResponse($request, $response, $val);
|
|
|
|
return;
|
|
}
|
|
|
|
$category = $this->createWikiCategoryFromRequest($request);
|
|
$this->createModel($request->header->account, $category, WikiCategoryMapper::class, 'category', $request->getOrigin());
|
|
$this->createStandardCreateResponse($request, $response, $category);
|
|
}
|
|
|
|
/**
|
|
* Method to create a wiki category from request.
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return WikiCategory
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function createWikiCategoryFromRequest(RequestAbstract $request) : WikiCategory
|
|
{
|
|
$category = new WikiCategory();
|
|
$category->app = new NullWikiApp($request->getDataInt('app') ?? 1);
|
|
$category->setL11n(
|
|
$request->getDataString('content') ?? '',
|
|
ISO639x1Enum::tryFromValue($request->getDataString('language')) ?? $request->header->l11n->language
|
|
);
|
|
|
|
if ($request->hasData('parent')) {
|
|
$category->parent = new NullWikiCategory((int) $request->getData('parent'));
|
|
}
|
|
|
|
return $category;
|
|
}
|
|
|
|
/**
|
|
* Method to validate wiki category creation from request
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return array<string, bool>
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function validateWikiCategoryCreate(RequestAbstract $request) : array
|
|
{
|
|
$val = [];
|
|
if (($val['content'] = !$request->hasData('content'))) {
|
|
return $val;
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Api method to get a category
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiCategoryGet(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiCategory $category */
|
|
$category = WikiCategoryMapper::get()
|
|
->with('name')
|
|
->where('id', $request->getDataInt('id') ?? 0)
|
|
->where('name/language', ISO639x1Enum::_EN)
|
|
->execute();
|
|
|
|
$this->createStandardReturnResponse($request, $response, $category);
|
|
}
|
|
|
|
/**
|
|
* Api method to create category
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiCategoryUpdate(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiCategory $old */
|
|
$old = WikiCategoryMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
$new = $this->updateCategoryFromRequest($request, clone $old);
|
|
|
|
$this->updateModel($request->header->account, $old, $new, WikiCategoryMapper::class, 'category', $request->getOrigin());
|
|
$this->createStandardUpdateResponse($request, $response, $new);
|
|
}
|
|
|
|
/**
|
|
* Method to update category from request.
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return WikiCategory
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function updateCategoryFromRequest(RequestAbstract $request, WikiCategory $new) : WikiCategory
|
|
{
|
|
$new->setL11n(
|
|
$request->getDataString('content') ?? $new->getL11n(),
|
|
ISO639x1Enum::tryFromValue($request->getDataString('language')) ?? $request->header->l11n->language
|
|
);
|
|
|
|
return $new;
|
|
}
|
|
|
|
/**
|
|
* Api method to delete category
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiCategoryDelete(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiCategory $category */
|
|
$category = WikiCategoryMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
|
|
$this->deleteModel($request->header->account, $category, WikiCategoryMapper::class, 'category', $request->getOrigin());
|
|
$this->createStandardDeleteResponse($request, $response, $category);
|
|
}
|
|
|
|
/**
|
|
* Api method to create a wiki app
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiAppCreate(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
if (!empty($val = $this->validateWikiAppCreate($request))) {
|
|
$response->header->status = RequestStatusCode::R_400;
|
|
$this->createInvalidCreateResponse($request, $response, $val);
|
|
|
|
return;
|
|
}
|
|
|
|
$app = $this->createWikiAppFromRequest($request);
|
|
$this->createModel($request->header->account, $app, WikiAppMapper::class, 'app', $request->getOrigin());
|
|
$this->createStandardCreateResponse($request, $response, $app);
|
|
}
|
|
|
|
/**
|
|
* Method to create a wiki app from request.
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return WikiApp
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function createWikiAppFromRequest(RequestAbstract $request) : WikiApp
|
|
{
|
|
$app = new WikiApp();
|
|
$app->name = (string) $request->getData('name');
|
|
$app->unit = $request->getDataInt('unit');
|
|
|
|
return $app;
|
|
}
|
|
|
|
/**
|
|
* Method to validate wiki app creation from request
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return array<string, bool>
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function validateWikiAppCreate(RequestAbstract $request) : array
|
|
{
|
|
$val = [];
|
|
if (($val['name'] = !$request->hasData('name'))) {
|
|
return $val;
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Api method to get a app
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiAppGet(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiApp $app */
|
|
$app = WikiAppMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
$this->createStandardReturnResponse($request, $response, $app);
|
|
}
|
|
|
|
/**
|
|
* Api method to create app
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiAppUpdate(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiApp $old */
|
|
$old = WikiAppMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
$new = $this->updateAppFromRequest($request, clone $old);
|
|
|
|
$this->updateModel($request->header->account, $old, $new, WikiAppMapper::class, 'app', $request->getOrigin());
|
|
$this->createStandardUpdateResponse($request, $response, $new);
|
|
}
|
|
|
|
/**
|
|
* Method to update app from request.
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return WikiApp
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function updateAppFromRequest(RequestAbstract $request, WikiApp $new) : WikiApp
|
|
{
|
|
$new->name = $request->getDataString('name') ?? $new->name;
|
|
|
|
return $new;
|
|
}
|
|
|
|
/**
|
|
* Api method to delete app
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiAppDelete(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
/** @var \Modules\Knowledgebase\Models\WikiApp $app */
|
|
$app = WikiAppMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
|
|
$this->deleteModel($request->header->account, $app, WikiAppMapper::class, 'app', $request->getOrigin());
|
|
$this->createStandardDeleteResponse($request, $response, $app);
|
|
}
|
|
|
|
/**
|
|
* Api method to update CategoryL11n
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiCategoryL11nUpdate(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
if (!empty($val = $this->validateCategoryL11nUpdate($request))) {
|
|
$response->header->status = RequestStatusCode::R_400;
|
|
$this->createInvalidUpdateResponse($request, $response, $val);
|
|
|
|
return;
|
|
}
|
|
|
|
/** @var BaseStringL11n $old */
|
|
$old = WikiCategoryL11nMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
$new = $this->updateCategoryL11nFromRequest($request, clone $old);
|
|
|
|
$this->updateModel($request->header->account, $old, $new, WikiCategoryL11nMapper::class, 'category_l11n', $request->getOrigin());
|
|
$this->createStandardUpdateResponse($request, $response, $new);
|
|
}
|
|
|
|
/**
|
|
* Method to update CategoryL11n from request.
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param BaseStringL11n $new Model to modify
|
|
*
|
|
* @return BaseStringL11n
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function updateCategoryL11nFromRequest(RequestAbstract $request, BaseStringL11n $new) : BaseStringL11n
|
|
{
|
|
$new->language = ISO639x1Enum::tryFromValue($request->getDataString('language')) ?? $new->language;
|
|
$new->content = $request->getDataString('content') ?? $new->content;
|
|
|
|
return $new;
|
|
}
|
|
|
|
/**
|
|
* Validate CategoryL11n update request
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return array<string, bool>
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function validateCategoryL11nUpdate(RequestAbstract $request) : array
|
|
{
|
|
$val = [];
|
|
if (($val['id'] = !$request->hasData('id'))
|
|
|| (($val['content'] = !$request->hasData('content'))
|
|
&& ($val['language'] = !$request->hasData('language')))
|
|
) {
|
|
return $val;
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Api method to delete CategoryL11n
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
* @param ResponseAbstract $response Response
|
|
* @param array $data Generic data
|
|
*
|
|
* @return void
|
|
*
|
|
* @api
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function apiWikiCategoryL11nDelete(RequestAbstract $request, ResponseAbstract $response, array $data = []) : void
|
|
{
|
|
if (!empty($val = $this->validateCategoryL11nDelete($request))) {
|
|
$response->header->status = RequestStatusCode::R_400;
|
|
$this->createInvalidDeleteResponse($request, $response, $val);
|
|
|
|
return;
|
|
}
|
|
|
|
/** @var BaseStringL11n $categoryL11n */
|
|
$categoryL11n = WikiCategoryL11nMapper::get()->where('id', $request->getDataInt('id') ?? 0)->execute();
|
|
$this->deleteModel($request->header->account, $categoryL11n, WikiCategoryL11nMapper::class, 'category_l11n', $request->getOrigin());
|
|
$this->createStandardDeleteResponse($request, $response, $categoryL11n);
|
|
}
|
|
|
|
/**
|
|
* Validate CategoryL11n delete request
|
|
*
|
|
* @param RequestAbstract $request Request
|
|
*
|
|
* @return array<string, bool>
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
private function validateCategoryL11nDelete(RequestAbstract $request) : array
|
|
{
|
|
$val = [];
|
|
if (($val['id'] = !$request->hasData('id'))) {
|
|
return $val;
|
|
}
|
|
|
|
return [];
|
|
}
|
|
}
|