/** Datei: plugins/calendars/library/ARUNOX/Plugins/Calendars/Tasks/Assignments/API/v1/Routes.php **/ * @copyright 2025 ARUNOX * @version 1.1.0 * * @since 1.0.0 File is created */ namespace ARUNOX\Plugins\Calendars\Tasks\Assignments\API\v1; use ARUNOX\Core\Hooks; use ARUNOX\Core\Router; use ARUNOX\Plugins\REST; class Routes { public static function register() : void { /* ### MAIN ROUTES ############################## # */ Router::addAll( Controller::class ); } } /** Datei: plugins/calendars/library/ARUNOX/Plugins/Calendars/Tasks/Assignments/API/v1/Controller.php **/ * @copyright 2025 ARUNOX * @version 1.1.0 * * @since 1.0.0 File is created */ namespace ARUNOX\Plugins\Calendars\Tasks\Assignments\API\v1; use ARUNOX\HTTP; use ARUNOX\API\PHP; use ARUNOX\Core\Hooks; use ARUNOX\Plugins\REST; use ARUNOX\Plugins\Users; use ARUNOX\Plugins\Calendars; use ARUNOX\API\BaseController; use ARUNOX\Database\BaseEntity; #[PHP\Attributes\Controller\Label( "Zuweisung", "Zuweisungen" )] #[PHP\Attributes\Controller\Route( "assignments", Calendars\Tasks\API\v1\Controller::class )] #[PHP\Attributes\Database\Definitions\Model( Calendars\Tasks\Assignments\Model::class )] class Controller extends BaseController { /* ### PUBLIC GET FUNCTIONS ##################################### # */ /** * @api * @method GET * * @route.path /calendars/tasks/{origin}/assignments * @route.description Listet alle Logeinträge */ public static function getByOriginPrepared( string $origin ) : array { return parent::getByOriginPrepared( $origin ); } /** * @api * @method GET * * @route.path /calendars/tasks/assignments/{hashid} * @route.description Gibt einen einzelnen Logeintrag anhand der ID zurück */ public static function getPrepared( string $hashid ) : BaseEntity | HTTP\Response { return parent::getPrepared( $hashid ); } /* ### PUBLIC SAVE FUNCTIONS #################################### # */ /** * @api * @method POST * * @route.path /calendars/tasks/{origin}/assignments * @route.description Erstellt einen neuen Teilnehmer */ public static function createByOriginPrepared( string $origin, array $data ) : HTTP\Response { return parent::createByOriginPrepared( $origin, $data ); } /** * @api * @method DELETE * * @route.path /calendars/tasks/assignments/{hashid} * @route.description Löscht ein Logeintrag anhand der ID */ public static function deletePrepared( string $hashid ) : HTTP\Response { return parent::deletePrepared( $hashid ); } /** * @api * @method PATCH * * @route.path /calendars/tasks/assignments/{hashid}/status * @route.description Wechselt den Status (aktiv/inaktiv) eines Kalenders */ public static function toggleStatusPrepared( string $hashid ) : HTTP\Response { return parent::toggleStatusPrepared( $hashid ); } /* ### PUBLIC VALIDATE FUNCTIONS ################################ # */ /* ### PUBLIC REST RESPONSE FUNCTIONS ########################### # */ /** * @internal rest * @method GET * * @route.path /calendars/tasks/assignments/{hashid} * @route.description REST-Konfiguration für Detailansicht eines Logeintrags */ public static function restResponseLog( string $hashid ) : HTTP\Response { $entry = Calendars\Tasks\Assignments\Model::get( $hashid )->origin; $route = Calendars\Tasks\API\v1\Controller::getRoute( $entry->hashid, "#assignments" ); REST\Response::redirect( $route ); return REST\Response::jsonResponse(); } /** * @internal rest * @method POST * * @route.path /calendars/tasks/{origin}/assignments * @route.description REST-Antwort nach dem Erstellen eines Kalenders */ public static function restResponseCreate( string $origin, array $data ) : HTTP\Response { $result = static::createByOriginPrepared( $origin, $data ); if( $result->isStatus( 200 ) ) { REST\Response::closeModals(); REST\Response::redirect( "/calendars/tasks/{$origin}#assignments" ); } return static::restResponse( $result ); } /** * @internal rest * @method DELETE * * @route.path /calendars/tasks/assignments/{hashid} * @route.description REST-Antwort nach dem Löschen eines Logeintrag */ public static function restResponseDelete( string $hashid ) : HTTP\Response { REST\Response::closeModals(); $current = Calendars\Tasks\Assignments\Model::get( $hashid ); $origin = Calendars\Tasks\Model::get( $current->origin_id ); $result = static::deletePrepared( $hashid ); if( $result->isStatus( 200 ) ) { REST\Response::addClick( [ "data/table/row", $origin->hashid ], "assignments" ); } return static::restResponse( $result ); } /** * @internal rest * @method PATCH * * @route.path /calendars/tasks/assignments/{hashid}/status * @route.description REST-Antwort zur Status-Umschaltung eines Kalenders */ public static function restResponseToggleStatusPrepared( string $hashid ) : HTTP\Response { return parent::restResponseToggleStatusPrepared( $hashid ); } /* ### PUBLIC REST CONFIG FUNCTIONS ############################# # */ /** * @internal rest * @method GET * * @route.path /calendars/tasks/{origin}/assignments/create * @route.description REST-Konfiguration für das Erstellen eines Teilnehmers (Formular) */ public static function restConfigCreate( string $origin ) : REST\Generator\Base\BaseGenerator { $exclude = Calendars\Tasks\Assignments\Model::getByOrigin( $origin , "target_hid" ); return REST\Response::addModal( "details", static::getSingular( "%t hinzufügen" ) ) ->get() ->setAction( "/calendars/tasks/{$origin}/assignments", "POST" ) ->addButton(...Hooks::filter( "rest.generator::button.type->submit", [], "Hinzufügen", "calendars/tasks/assignments" )) ->addField(...Hooks::filter( "rest.generator::control.type->select", [ "options" => Users\Model::getAsOptions( "username", "hashid", $exclude ), ], "target_hid", TRUE, TRUE, "calendars/tasks/assignments" )) ; } /** * @internal rest * @method GET * * @route.path /calendars/tasks/assignments/{hashid}/delete * @route.description REST-Konfiguration für die Lösch-Bestätigung eines Logeintrags */ public static function restConfigDeletePrepared( string $hashid ) : REST\Generator\Base\BaseGenerator { return REST\Response::addModal( "details", static::getSingular( "%t löschen" ) ) ->setSize( REST\Wrapper\Modal\Size::sm ) ->get() ->setAction( "/calendars/tasks/assignments/{$hashid}", "DELETE" ) ->addText( "Möchtest du wirklich den Datensatz (#{$hashid}) löschen? " ) ->addButton(...Hooks::filter( "rest.generator::button.type->cancel", [], NULL, "calendars/tasks/assignments" )) ->addButton(...Hooks::filter( "rest.generator::button.type->delete", [], NULL, "calendars/tasks/assignments" )); } /* ### PUBLIC REST EXTENSION FUNCTIONS ########################## # */ public static function restConfigTable( string $origin ) : REST\Generator\Base\BaseGenerator { $exclude = Calendars\Tasks\Assignments\Model::getByOrigin( $origin , "target_hid" ); $options = Users\Model::getAsOptions( "username", "hashid", $exclude ); $rest = REST\Generator\Data\Table::create() ->setApi( "/calendars/tasks/{$origin}/assignments" ) ->setOrder( "date_create", "desc" ) ->setSearch( TRUE ) ; if( !empty( $options ) ) { $rest->addButton(...Hooks::filter( "rest.generator::button.name->create", [], "calendars/tasks/{$origin}/assignments" )); } $rest->addColumn(...Hooks::filter( "rest.generator::column.type->status", [ "options" => Calendars\Tasks\Assignments\Status::getAll(), ], "status", [], "calendars/tasks/assignments", "hashid" )) ->addColumn(...Hooks::filter( "rest.generator::column.type->text", [ "label" => "Name", ], "target.username", TRUE, TRUE, TRUE, "calendars/tasks/assignments" )) ->addColumn(...Hooks::filter( "rest.generator::column.type->datetime", [ "label" => "Zugewiesen am", ], "date_create", TRUE, FALSE, TRUE, "calendars/tasks/assignments" )) ->addColumn(...Hooks::filter( "rest.generator::column.type->datetime", [ "label" => "Erledigt am", ], "date_done", TRUE, FALSE, TRUE, "calendars/tasks/assignments" )) ->addColumn(...Hooks::filter( "rest.generator::column.type->text", [ "label" => "Aufgabe", ], "task", TRUE, FALSE, TRUE, "calendars/tasks/assignments" )) ->addColumn(...Hooks::filter( "rest.generator::column.type->actions", [], [], FALSE, "calendars/tasks/assignments" ))->get() ->addButton(...Hooks::filter( "rest.generator::action.name->delete", [], "calendars/tasks/assignments", "hashid" )) ; return $rest; } }