Auto docblock fixes.

This commit is contained in:
Dennis Eichhorn 2023-05-25 07:48:47 +00:00
parent 833cc7abe6
commit 819734daca
11 changed files with 78 additions and 79 deletions

32
Controller/FileUploaderTrait.php Executable file → Normal file
View File

@ -19,7 +19,7 @@ use phpOMS\Message\RequestAbstract;
use phpOMS\Message\ResponseAbstract;
/**
* Options trait.
* Trait for setting up file upload functionality.
*
* @package Modules\Media\Controller
* @license OMS License 2.0
@ -28,21 +28,21 @@ use phpOMS\Message\ResponseAbstract;
*/
trait FileUploaderTrait
{
/**
/**
* Setup file uploader.
*
* @param RequestAbstract $request Request
* @param ResponseAbstract $response Response
* @param mixed $data Misc. data
*
* @return void
*
* @since 1.0.0
*
* @param RequestAbstract $request Request
* @param ResponseAbstract $response Response
* @param mixed $data Misc. data
*
* @return void
*
* @since 1.0.0
* @codeCoverageIgnore
*/
public static function setUpFileUploaderTrait(RequestAbstract $request, ResponseAbstract $response, $data = null) : void
{
$head = $response->get('Content')->getData('head');
$head->addAsset(AssetType::JS, '/Modules/Media/Controller.js', ['type' => 'module']);
}
*/
public static function setUpFileUploaderTrait(RequestAbstract $request, ResponseAbstract $response, $data = null) : void
{
$head = $response->get('Content')->getData('head');
$head->addAsset(AssetType::JS, '/Modules/Media/Controller.js', ['type' => 'module']);
}
}

2
Models/MediaClass.php Executable file → Normal file
View File

@ -15,7 +15,7 @@ declare(strict_types=1);
namespace Modules\Media\Models;
/**
* Media class.
* Represents the type/class of media in the application.
*
* @package Modules\Media\Models
* @license OMS License 2.0

16
Models/MediaContent.php Executable file → Normal file
View File

@ -15,7 +15,7 @@ declare(strict_types=1);
namespace Modules\Media\Models;
/**
* Media class.
* Media content class.
*
* @package Modules\Media\Models
* @license OMS License 2.0
@ -32,17 +32,13 @@ class MediaContent implements \JsonSerializable
*/
public int $id = 0;
public string $content = '';
/**
* @return int
* Content of the media.
*
* @var string
* @since 1.0.0
*/
public function getId() : int
{
return $this->id;
}
public string $content = '';
/**
* {@inheritdoc}
@ -50,8 +46,8 @@ class MediaContent implements \JsonSerializable
public function toArray() : array
{
return [
'id' => $this->id,
'content' => $this->content,
'id' => $this->id,
'content' => $this->content,
];
}

2
Models/MediaStatus.php Executable file → Normal file
View File

@ -15,7 +15,7 @@ declare(strict_types=1);
namespace Modules\Media\Models;
/**
* Media class.
* Media status enum.
*
* @package Modules\Media\Models
* @license OMS License 2.0

2
Models/NullCollection.php Executable file → Normal file
View File

@ -15,7 +15,7 @@ declare(strict_types=1);
namespace Modules\Media\Models;
/**
* Media class.
* NullCollection class.
*
* @package Modules\Media\Models
* @license OMS License 2.0

38
Models/NullMedia.php Executable file → Normal file
View File

@ -15,7 +15,7 @@ declare(strict_types=1);
namespace Modules\Media\Models;
/**
* Media class.
* NullMedia class represents a null object of the Media class.
*
* @package Modules\Media\Models
* @license OMS License 2.0
@ -24,24 +24,24 @@ namespace Modules\Media\Models;
*/
final class NullMedia extends Media
{
/**
* Constructor
*
* @param int $id Model id
*
* @since 1.0.0
*/
public function __construct(int $id = 0)
{
$this->id = $id;
parent::__construct();
}
/**
* Constructor.
*
* @param int $id Model id
*
* @since 1.0.0
*/
public function __construct(int $id = 0)
{
$this->id = $id;
parent::__construct();
}
/**
* {@inheritdoc}
*/
/**
* {@inheritdoc}
*/
public function jsonSerialize() : mixed
{
return ['id' => $this->id];
}
{
return ['id' => $this->id];
}
}

33
Models/NullMediaContent.php Executable file → Normal file
View File

@ -15,7 +15,8 @@ declare(strict_types=1);
namespace Modules\Media\Models;
/**
* Media class.
* Class NullMediaContent
* Represents null media content.
*
* @package Modules\Media\Models
* @license OMS License 2.0
@ -24,23 +25,23 @@ namespace Modules\Media\Models;
*/
final class NullMediaContent extends MediaContent
{
/**
/**
* Constructor
*
*
* @param int $id Model id
*
* @since 1.0.0
*/
public function __construct(int $id = 0)
{
$this->id = $id;
}
*
* @since 1.0.0
*/
public function __construct(int $id = 0)
{
$this->id = $id;
}
/**
/**
* {@inheritdoc}
*/
public function jsonSerialize() : mixed
{
return ['id' => $this->id];
}
*/
public function jsonSerialize() : mixed
{
return ['id' => $this->id];
}
}

2
Models/NullMediaType.php Executable file → Normal file
View File

@ -15,7 +15,7 @@ declare(strict_types=1);
namespace Modules\Media\Models;
/**
* Media type class.
* Null media type class.
*
* @package Modules\Media\Models
* @license OMS License 2.0

30
Models/Reference.php Executable file → Normal file
View File

@ -17,6 +17,8 @@ namespace Modules\Media\Models;
/**
* Reference class.
*
* This class represents a reference to a media file. It extends the Media class.
*
* @package Modules\Media\Models
* @license OMS License 2.0
* @link https://jingga.app
@ -24,19 +26,19 @@ namespace Modules\Media\Models;
*/
class Reference extends Media
{
/**
* Extension name.
*
* @var string
* @since 1.0.0
*/
public string $extension = 'reference';
/**
* The file extension of the reference file.
*
* @var string
* @since 1.0.0
*/
public string $extension = 'reference';
/**
* Is reference.
*
* @var int
* @since 1.0.0
*/
public int $class = MediaClass::REFERENCE;
/**
* The media class of the reference.
*
* @var int
* @since 1.0.0
*/
public int $class = MediaClass::REFERENCE;
}

0
Models/ReferenceMapper.php Executable file → Normal file
View File

0
Models/UploadStatus.php Executable file → Normal file
View File