From 5b67b92f73529cfeb10caf62f05d1c1e35b66c2c Mon Sep 17 00:00:00 2001 From: =?utf8?q?Julius=20H=C3=A4rtl?= Date: Tue, 3 Jan 2023 17:29:13 +0100 Subject: [PATCH] chore(OCP): Remove deprecated dashboard interfaces and classes MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Julius Härtl --- lib/composer/composer/autoload_classmap.php | 11 - lib/composer/composer/autoload_static.php | 11 - lib/private/Dashboard/DashboardManager.php | 139 -------- lib/private/Server.php | 4 +- .../DashboardAppNotAvailableException.php | 35 -- lib/public/Dashboard/IDashboardManager.php | 136 -------- lib/public/Dashboard/IDashboardWidget.php | 148 -------- lib/public/Dashboard/Model/IWidgetConfig.php | 127 ------- lib/public/Dashboard/Model/IWidgetRequest.php | 137 -------- lib/public/Dashboard/Model/WidgetSetting.php | 243 ------------- lib/public/Dashboard/Model/WidgetSetup.php | 274 --------------- lib/public/Dashboard/Model/WidgetTemplate.php | 326 ------------------ .../Dashboard/Service/IEventsService.php | 89 ----- .../Dashboard/Service/IWidgetsService.php | 56 --- 14 files changed, 1 insertion(+), 1735 deletions(-) delete mode 100644 lib/private/Dashboard/DashboardManager.php delete mode 100644 lib/public/Dashboard/Exceptions/DashboardAppNotAvailableException.php delete mode 100644 lib/public/Dashboard/IDashboardManager.php delete mode 100644 lib/public/Dashboard/IDashboardWidget.php delete mode 100644 lib/public/Dashboard/Model/IWidgetConfig.php delete mode 100644 lib/public/Dashboard/Model/IWidgetRequest.php delete mode 100644 lib/public/Dashboard/Model/WidgetSetting.php delete mode 100644 lib/public/Dashboard/Model/WidgetSetup.php delete mode 100644 lib/public/Dashboard/Model/WidgetTemplate.php delete mode 100644 lib/public/Dashboard/Service/IEventsService.php delete mode 100644 lib/public/Dashboard/Service/IWidgetsService.php diff --git a/lib/composer/composer/autoload_classmap.php b/lib/composer/composer/autoload_classmap.php index 08a871e8466..0fcbbf101d8 100644 --- a/lib/composer/composer/autoload_classmap.php +++ b/lib/composer/composer/autoload_classmap.php @@ -193,27 +193,17 @@ return array( 'OCP\\DB\\QueryBuilder\\IQueryBuilder' => $baseDir . '/lib/public/DB/QueryBuilder/IQueryBuilder.php', 'OCP\\DB\\QueryBuilder\\IQueryFunction' => $baseDir . '/lib/public/DB/QueryBuilder/IQueryFunction.php', 'OCP\\DB\\Types' => $baseDir . '/lib/public/DB/Types.php', - 'OCP\\Dashboard\\Exceptions\\DashboardAppNotAvailableException' => $baseDir . '/lib/public/Dashboard/Exceptions/DashboardAppNotAvailableException.php', 'OCP\\Dashboard\\IAPIWidget' => $baseDir . '/lib/public/Dashboard/IAPIWidget.php', 'OCP\\Dashboard\\IButtonWidget' => $baseDir . '/lib/public/Dashboard/IButtonWidget.php', 'OCP\\Dashboard\\IConditionalWidget' => $baseDir . '/lib/public/Dashboard/IConditionalWidget.php', - 'OCP\\Dashboard\\IDashboardManager' => $baseDir . '/lib/public/Dashboard/IDashboardManager.php', - 'OCP\\Dashboard\\IDashboardWidget' => $baseDir . '/lib/public/Dashboard/IDashboardWidget.php', 'OCP\\Dashboard\\IIconWidget' => $baseDir . '/lib/public/Dashboard/IIconWidget.php', 'OCP\\Dashboard\\IManager' => $baseDir . '/lib/public/Dashboard/IManager.php', 'OCP\\Dashboard\\IOptionWidget' => $baseDir . '/lib/public/Dashboard/IOptionWidget.php', 'OCP\\Dashboard\\IWidget' => $baseDir . '/lib/public/Dashboard/IWidget.php', - 'OCP\\Dashboard\\Model\\IWidgetConfig' => $baseDir . '/lib/public/Dashboard/Model/IWidgetConfig.php', - 'OCP\\Dashboard\\Model\\IWidgetRequest' => $baseDir . '/lib/public/Dashboard/Model/IWidgetRequest.php', 'OCP\\Dashboard\\Model\\WidgetButton' => $baseDir . '/lib/public/Dashboard/Model/WidgetButton.php', 'OCP\\Dashboard\\Model\\WidgetItem' => $baseDir . '/lib/public/Dashboard/Model/WidgetItem.php', 'OCP\\Dashboard\\Model\\WidgetOptions' => $baseDir . '/lib/public/Dashboard/Model/WidgetOptions.php', - 'OCP\\Dashboard\\Model\\WidgetSetting' => $baseDir . '/lib/public/Dashboard/Model/WidgetSetting.php', - 'OCP\\Dashboard\\Model\\WidgetSetup' => $baseDir . '/lib/public/Dashboard/Model/WidgetSetup.php', - 'OCP\\Dashboard\\Model\\WidgetTemplate' => $baseDir . '/lib/public/Dashboard/Model/WidgetTemplate.php', 'OCP\\Dashboard\\RegisterWidgetEvent' => $baseDir . '/lib/public/Dashboard/RegisterWidgetEvent.php', - 'OCP\\Dashboard\\Service\\IEventsService' => $baseDir . '/lib/public/Dashboard/Service/IEventsService.php', - 'OCP\\Dashboard\\Service\\IWidgetsService' => $baseDir . '/lib/public/Dashboard/Service/IWidgetsService.php', 'OCP\\DataCollector\\AbstractDataCollector' => $baseDir . '/lib/public/DataCollector/AbstractDataCollector.php', 'OCP\\DataCollector\\IDataCollector' => $baseDir . '/lib/public/DataCollector/IDataCollector.php', 'OCP\\Defaults' => $baseDir . '/lib/public/Defaults.php', @@ -1125,7 +1115,6 @@ return array( 'OC\\DB\\SQLiteSessionInit' => $baseDir . '/lib/private/DB/SQLiteSessionInit.php', 'OC\\DB\\SchemaWrapper' => $baseDir . '/lib/private/DB/SchemaWrapper.php', 'OC\\DB\\SetTransactionIsolationLevel' => $baseDir . '/lib/private/DB/SetTransactionIsolationLevel.php', - 'OC\\Dashboard\\DashboardManager' => $baseDir . '/lib/private/Dashboard/DashboardManager.php', 'OC\\Dashboard\\Manager' => $baseDir . '/lib/private/Dashboard/Manager.php', 'OC\\DatabaseException' => $baseDir . '/lib/private/DatabaseException.php', 'OC\\DatabaseSetupException' => $baseDir . '/lib/private/DatabaseSetupException.php', diff --git a/lib/composer/composer/autoload_static.php b/lib/composer/composer/autoload_static.php index eec226c9a6e..f5730376366 100644 --- a/lib/composer/composer/autoload_static.php +++ b/lib/composer/composer/autoload_static.php @@ -226,27 +226,17 @@ class ComposerStaticInit749170dad3f5e7f9ca158f5a9f04f6a2 'OCP\\DB\\QueryBuilder\\IQueryBuilder' => __DIR__ . '/../../..' . '/lib/public/DB/QueryBuilder/IQueryBuilder.php', 'OCP\\DB\\QueryBuilder\\IQueryFunction' => __DIR__ . '/../../..' . '/lib/public/DB/QueryBuilder/IQueryFunction.php', 'OCP\\DB\\Types' => __DIR__ . '/../../..' . '/lib/public/DB/Types.php', - 'OCP\\Dashboard\\Exceptions\\DashboardAppNotAvailableException' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Exceptions/DashboardAppNotAvailableException.php', 'OCP\\Dashboard\\IAPIWidget' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IAPIWidget.php', 'OCP\\Dashboard\\IButtonWidget' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IButtonWidget.php', 'OCP\\Dashboard\\IConditionalWidget' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IConditionalWidget.php', - 'OCP\\Dashboard\\IDashboardManager' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IDashboardManager.php', - 'OCP\\Dashboard\\IDashboardWidget' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IDashboardWidget.php', 'OCP\\Dashboard\\IIconWidget' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IIconWidget.php', 'OCP\\Dashboard\\IManager' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IManager.php', 'OCP\\Dashboard\\IOptionWidget' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IOptionWidget.php', 'OCP\\Dashboard\\IWidget' => __DIR__ . '/../../..' . '/lib/public/Dashboard/IWidget.php', - 'OCP\\Dashboard\\Model\\IWidgetConfig' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Model/IWidgetConfig.php', - 'OCP\\Dashboard\\Model\\IWidgetRequest' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Model/IWidgetRequest.php', 'OCP\\Dashboard\\Model\\WidgetButton' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Model/WidgetButton.php', 'OCP\\Dashboard\\Model\\WidgetItem' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Model/WidgetItem.php', 'OCP\\Dashboard\\Model\\WidgetOptions' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Model/WidgetOptions.php', - 'OCP\\Dashboard\\Model\\WidgetSetting' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Model/WidgetSetting.php', - 'OCP\\Dashboard\\Model\\WidgetSetup' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Model/WidgetSetup.php', - 'OCP\\Dashboard\\Model\\WidgetTemplate' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Model/WidgetTemplate.php', 'OCP\\Dashboard\\RegisterWidgetEvent' => __DIR__ . '/../../..' . '/lib/public/Dashboard/RegisterWidgetEvent.php', - 'OCP\\Dashboard\\Service\\IEventsService' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Service/IEventsService.php', - 'OCP\\Dashboard\\Service\\IWidgetsService' => __DIR__ . '/../../..' . '/lib/public/Dashboard/Service/IWidgetsService.php', 'OCP\\DataCollector\\AbstractDataCollector' => __DIR__ . '/../../..' . '/lib/public/DataCollector/AbstractDataCollector.php', 'OCP\\DataCollector\\IDataCollector' => __DIR__ . '/../../..' . '/lib/public/DataCollector/IDataCollector.php', 'OCP\\Defaults' => __DIR__ . '/../../..' . '/lib/public/Defaults.php', @@ -1158,7 +1148,6 @@ class ComposerStaticInit749170dad3f5e7f9ca158f5a9f04f6a2 'OC\\DB\\SQLiteSessionInit' => __DIR__ . '/../../..' . '/lib/private/DB/SQLiteSessionInit.php', 'OC\\DB\\SchemaWrapper' => __DIR__ . '/../../..' . '/lib/private/DB/SchemaWrapper.php', 'OC\\DB\\SetTransactionIsolationLevel' => __DIR__ . '/../../..' . '/lib/private/DB/SetTransactionIsolationLevel.php', - 'OC\\Dashboard\\DashboardManager' => __DIR__ . '/../../..' . '/lib/private/Dashboard/DashboardManager.php', 'OC\\Dashboard\\Manager' => __DIR__ . '/../../..' . '/lib/private/Dashboard/Manager.php', 'OC\\DatabaseException' => __DIR__ . '/../../..' . '/lib/private/DatabaseException.php', 'OC\\DatabaseSetupException' => __DIR__ . '/../../..' . '/lib/private/DatabaseSetupException.php', diff --git a/lib/private/Dashboard/DashboardManager.php b/lib/private/Dashboard/DashboardManager.php deleted file mode 100644 index abeb74eef30..00000000000 --- a/lib/private/Dashboard/DashboardManager.php +++ /dev/null @@ -1,139 +0,0 @@ - - * - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OC\Dashboard; - -use OCP\Dashboard\Exceptions\DashboardAppNotAvailableException; -use OCP\Dashboard\IDashboardManager; -use OCP\Dashboard\Model\IWidgetConfig; -use OCP\Dashboard\Service\IEventsService; -use OCP\Dashboard\Service\IWidgetsService; - -/** - * Class DashboardManager - * - * @package OC\Dashboard - */ -class DashboardManager implements IDashboardManager { - - - /** @var IWidgetsService */ - private $widgetsService; - - /** @var IEventsService */ - private $eventsService; - - - /** - * @param IEventsService $eventsService - */ - public function registerEventsService(IEventsService $eventsService) { - $this->eventsService = $eventsService; - } - - - /** - * @param IWidgetsService $widgetsService - */ - public function registerWidgetsService(IWidgetsService $widgetsService) { - $this->widgetsService = $widgetsService; - } - - - /** - * @param string $widgetId - * @param string $userId - * - * @return IWidgetConfig - * @throws DashboardAppNotAvailableException - */ - public function getWidgetConfig(string $widgetId, string $userId): IWidgetConfig { - return $this->getWidgetsService()->getWidgetConfig($widgetId, $userId); - } - - - /** - * @param string $widgetId - * @param array $users - * @param array $payload - * @param string $uniqueId - * - * @throws DashboardAppNotAvailableException - */ - public function createUsersEvent(string $widgetId, array $users, array $payload, string $uniqueId = '') { - $this->getEventsService()->createUsersEvent($widgetId, $users, $payload, $uniqueId); - } - - - /** - * @param string $widgetId - * @param array $groups - * @param array $payload - * @param string $uniqueId - * - * @throws DashboardAppNotAvailableException - */ - public function createGroupsEvent(string $widgetId, array $groups, array $payload, string $uniqueId = '') { - $this->getEventsService()->createGroupsEvent($widgetId, $groups, $payload, $uniqueId); - } - - - /** - * @param string $widgetId - * @param array $payload - * @param string $uniqueId - * - * @throws DashboardAppNotAvailableException - */ - public function createGlobalEvent(string $widgetId, array $payload, string $uniqueId = '') { - $this->getEventsService()->createGlobalEvent($widgetId, $payload, $uniqueId); - } - - - /** - * @return IWidgetsService - * @throws DashboardAppNotAvailableException - */ - private function getWidgetsService() { - if ($this->widgetsService === null) { - throw new DashboardAppNotAvailableException('No IWidgetsService registered'); - } - - return $this->widgetsService; - } - - - /** - * @return IEventsService - * @throws DashboardAppNotAvailableException - */ - private function getEventsService() { - if ($this->eventsService === null) { - throw new DashboardAppNotAvailableException('No IEventsService registered'); - } - - return $this->eventsService; - } -} diff --git a/lib/private/Server.php b/lib/private/Server.php index d420b6fd11d..92fa9bf768d 100644 --- a/lib/private/Server.php +++ b/lib/private/Server.php @@ -78,7 +78,6 @@ use OC\Command\CronBus; use OC\Comments\ManagerFactory as CommentsManagerFactory; use OC\Contacts\ContactsMenu\ActionFactory; use OC\Contacts\ContactsMenu\ContactsStore; -use OC\Dashboard\DashboardManager; use OC\DB\Connection; use OC\DB\ConnectionAdapter; use OC\Diagnostics\EventLogger; @@ -167,7 +166,6 @@ use OCP\Command\IBus; use OCP\Comments\ICommentsManager; use OCP\Contacts\ContactsMenu\IActionFactory; use OCP\Contacts\ContactsMenu\IContactsStore; -use OCP\Dashboard\IDashboardManager; use OCP\Defaults; use OCP\Diagnostics\IEventLogger; use OCP\Diagnostics\IQueryLogger; @@ -1434,8 +1432,8 @@ class Server extends ServerContainer implements IServerContainer { $this->registerAlias(IStorageFactory::class, StorageFactory::class); - $this->registerAlias(IDashboardManager::class, DashboardManager::class); $this->registerAlias(\OCP\Dashboard\IManager::class, \OC\Dashboard\Manager::class); + $this->registerAlias(IFullTextSearchManager::class, FullTextSearchManager::class); $this->registerAlias(ISubAdmin::class, SubAdmin::class); diff --git a/lib/public/Dashboard/Exceptions/DashboardAppNotAvailableException.php b/lib/public/Dashboard/Exceptions/DashboardAppNotAvailableException.php deleted file mode 100644 index 854848da5b7..00000000000 --- a/lib/public/Dashboard/Exceptions/DashboardAppNotAvailableException.php +++ /dev/null @@ -1,35 +0,0 @@ - - * - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard\Exceptions; - -/** - * @since 15.0.0 - * - * Class DashboardAppNotAvailableException - * - */ -class DashboardAppNotAvailableException extends \Exception { -} diff --git a/lib/public/Dashboard/IDashboardManager.php b/lib/public/Dashboard/IDashboardManager.php deleted file mode 100644 index 46f31cd8ff4..00000000000 --- a/lib/public/Dashboard/IDashboardManager.php +++ /dev/null @@ -1,136 +0,0 @@ - - * - * @author Julius Härtl - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard; - -use OCP\Dashboard\Exceptions\DashboardAppNotAvailableException; -use OCP\Dashboard\Model\IWidgetConfig; -use OCP\Dashboard\Service\IEventsService; -use OCP\Dashboard\Service\IWidgetsService; - -/** - * Interface IDashboardManager - * - * IDashboardManager should be used to manage widget from the backend. - * The call can be done from any Service. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -interface IDashboardManager { - - - /** - * Register a IWidgetsService. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param IWidgetsService $widgetsService - */ - public function registerWidgetsService(IWidgetsService $widgetsService); - - - /** - * Register a IEventsService. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param IEventsService $eventsService - */ - public function registerEventsService(IEventsService $eventsService); - - - /** - * returns the OCP\Dashboard\Model\IWidgetConfig for a widgetId and userId. - * - * @see IWidgetConfig - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $widgetId - * @param string $userId - * - * @throws DashboardAppNotAvailableException - * @return IWidgetConfig - */ - public function getWidgetConfig(string $widgetId, string $userId): IWidgetConfig; - - - /** - * Create push notifications for users. - * $payload is an array that will be send to the Javascript method - * called on push. - * $uniqueId needs to be used if you send the push to multiples users - * and multiples groups so that one user does not have duplicate - * notifications. - * - * Push notifications are created in database and broadcast to user - * that are running dashboard. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $widgetId - * @param array $users - * @param array $payload - * @param string $uniqueId - * @throws DashboardAppNotAvailableException - */ - public function createUsersEvent(string $widgetId, array $users, array $payload, string $uniqueId = ''); - - - /** - * Create push notifications for groups. (ie. createUsersEvent()) - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $widgetId - * @param array $groups - * @param array $payload - * @param string $uniqueId - * @throws DashboardAppNotAvailableException - */ - public function createGroupsEvent(string $widgetId, array $groups, array $payload, string $uniqueId = ''); - - - /** - * Create push notifications for everyone. (ie. createUsersEvent()) - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $widgetId - * @param array $payload - * @param string $uniqueId - * @throws DashboardAppNotAvailableException - */ - public function createGlobalEvent(string $widgetId, array $payload, string $uniqueId = ''); -} diff --git a/lib/public/Dashboard/IDashboardWidget.php b/lib/public/Dashboard/IDashboardWidget.php deleted file mode 100644 index fc7de4dae98..00000000000 --- a/lib/public/Dashboard/IDashboardWidget.php +++ /dev/null @@ -1,148 +0,0 @@ - - * - * @author Julius Härtl - * @author Maxence Lange - * @author Roeland Jago Douma - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard; - -use OCP\Dashboard\Model\IWidgetConfig; -use OCP\Dashboard\Model\IWidgetRequest; -use OCP\Dashboard\Model\WidgetSetup; -use OCP\Dashboard\Model\WidgetTemplate; - -/** - * Interface IDashboardWidget - * - * This interface is used to create a widget: the widget must implement this - * interface and be defined in appinfo/info.xml: - * - * - * OCA\YourApp\YourWidget - * - * - * Multiple widget can be defined in the same appinfo/info.xml. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -interface IDashboardWidget { - - /** - * Should returns the (unique) Id of the widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getId(): string; - - - /** - * Should returns the [display] name of the widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getName(): string; - - - /** - * Should returns some text describing the widget. - * This description is displayed in the listing of the available widgets. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getDescription(): string; - - - /** - * Must generate and return a WidgetTemplate that define important stuff - * about the Widget: icon, content, css or javascript. - * - * @see WidgetTemplate - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return WidgetTemplate - */ - public function getWidgetTemplate(): WidgetTemplate; - - - /** - * Must create and return a WidgetSetup containing the general setup of - * the widget - * - * @see WidgetSetup - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return WidgetSetup - */ - public function getWidgetSetup(): WidgetSetup; - - - /** - * This method is called when a widget is loaded on the dashboard. - * A widget is 'loaded on the dashboard' when one of these conditions - * occurs: - * - * - the user is adding the widget on his dashboard, - * - the user already added the widget on his dashboard and he is opening - * the dashboard app. - * - * @see IWidgetConfig - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param IWidgetConfig $settings - */ - public function loadWidget(IWidgetConfig $settings); - - - /** - * This method s executed when the widget call the net.requestWidget() - * from the Javascript API. - * - * This is used by the frontend to communicate with the backend. - * - * @see IWidgetRequest - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param IWidgetRequest $request - */ - public function requestWidget(IWidgetRequest $request); -} diff --git a/lib/public/Dashboard/Model/IWidgetConfig.php b/lib/public/Dashboard/Model/IWidgetConfig.php deleted file mode 100644 index b117660c441..00000000000 --- a/lib/public/Dashboard/Model/IWidgetConfig.php +++ /dev/null @@ -1,127 +0,0 @@ - - * - * @author Julius Härtl - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard\Model; - -use OCP\Dashboard\IDashboardWidget; - -/** - * Interface IWidgetConfig - * - * This object contains the configuration of a widget for a userId - * - * @see IDashboardWidget::loadWidget - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -interface IWidgetConfig { - - - /** - * Returns the userId - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getUserId(): string; - - - /** - * Returns the widgetId - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getWidgetId(): string; - - - /** - * Returns the current position and the current size of the widget as - * displayed on the user's dashboard - * - * The returned value is an array: - * [ - * 'x' => (int) position on the X axis, - * 'y' => (int) position on the Y axis, - * 'width' => (int) width of the widget, - * 'height' => (int) height of the widget - * ] - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getPosition(): array; - - - /** - * Returns an array with the settings defined by the user for the widget. - * The returned value is an array, with setting used as keys: - * - * [ - * 'setting1' => 'any value', - * 'setting2' => 'other value' - * ] - * - * Each setting that can be edited by a user should be defined in a - * WidgetSetting. - * - * @see WidgetSetting - * - * Those WidgetSetting are in the WidgetTemplate defined during the setup - * of the widget in the IDashboardWidget. - * - * @see IDashboardWidget::getWidgetTemplate - * @see WidgetTemplate - * - * When using this framework, the settings interface is generated by the - * Dashboard app. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getSettings(): array; - - - /** - * Returns if the widget is enabled/displayed in this user's dashboard. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return bool - */ - public function isEnabled(): bool; -} diff --git a/lib/public/Dashboard/Model/IWidgetRequest.php b/lib/public/Dashboard/Model/IWidgetRequest.php deleted file mode 100644 index 73fe5fc5c2c..00000000000 --- a/lib/public/Dashboard/Model/IWidgetRequest.php +++ /dev/null @@ -1,137 +0,0 @@ - - * - * @author Julius Härtl - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard\Model; - -use OCP\Dashboard\IDashboardWidget; - -/** - * Interface IWidgetRequest - * - * WidgetRequest are created by the Dashboard App and used to communicate from - * the frontend to the backend. - * The object is send to the WidgetClass using IDashboardWidget::requestWidget - * - * @see IDashboardWidget::requestWidget - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -interface IWidgetRequest { - - /** - * Get the widgetId. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getWidgetId(): string; - - - /** - * Get the WidgetClass. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return IDashboardWidget - */ - public function getWidget(): IDashboardWidget; - - - /** - * Get the 'request' string sent by the request from the front-end with - * the format: - * - * net.requestWidget( - * { - * widget: widgetId, - * request: request, - * value: value - * }, - * callback); - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getRequest(): string; - - - /** - * Get the 'value' string sent by the request from the front-end. - * - * @see getRequest - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getValue(): string; - - - /** - * Returns the result. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getResult(): array; - - - /** - * add a result (as string) - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $key - * @param string $result - * - * @return $this - */ - public function addResult(string $key, string $result): IWidgetRequest; - - /** - * add a result (as array) - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $key - * @param array $result - * - * @return $this - */ - public function addResultArray(string $key, array $result): IWidgetRequest; -} diff --git a/lib/public/Dashboard/Model/WidgetSetting.php b/lib/public/Dashboard/Model/WidgetSetting.php deleted file mode 100644 index fce59a4350b..00000000000 --- a/lib/public/Dashboard/Model/WidgetSetting.php +++ /dev/null @@ -1,243 +0,0 @@ - - * - * @author Christoph Wurst - * @author Julius Härtl - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard\Model; - -use JsonSerializable; - -/** - * Interface WidgetSetting - * - * Each setting that can be edited by a user should be defined in a - * WidgetSetting. - * - * When using this framework, the settings interface is generated by the - * Dashboard app. - * - * Each WidgetSetting must be generated and declared in the WidgetTemplate - * during the setup of the widget in the IDashboardWidget using addSetting(). - * - * @see IDashboardWidget::getWidgetTemplate - * @see WidgetTemplate::addSetting - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -final class WidgetSetting implements JsonSerializable { - public const TYPE_INPUT = 'input'; - public const TYPE_CHECKBOX = 'checkbox'; - - - /** @var string */ - private $name = ''; - - /** @var string */ - private $title = ''; - - /** @var string */ - private $type = ''; - - /** @var string */ - private $placeholder = ''; - - /** @var string */ - private $default = ''; - - - /** - * WidgetSetting constructor. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $type - */ - public function __construct(string $type = '') { - $this->type = $type; - } - - - /** - * Set the name of the setting (full string, no space) - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $name - * - * @return WidgetSetting - */ - public function setName(string $name): WidgetSetting { - $this->name = $name; - - return $this; - } - - /** - * Get the name of the setting - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getName(): string { - return $this->name; - } - - - /** - * Set the title/display name of the setting. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $title - * - * @return WidgetSetting - */ - public function setTitle(string $title): WidgetSetting { - $this->title = $title; - - return $this; - } - - /** - * Get the title of the setting - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getTitle(): string { - return $this->title; - } - - - /** - * Set the type of the setting (input, checkbox, ...) - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $type - * - * @return WidgetSetting - */ - public function setType(string $type): WidgetSetting { - $this->type = $type; - - return $this; - } - - /** - * Get the type of the setting. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getType(): string { - return $this->type; - } - - - /** - * Set the placeholder (in case of type=input) - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $text - * - * @return WidgetSetting - */ - public function setPlaceholder(string $text): WidgetSetting { - $this->placeholder = $text; - - return $this; - } - - /** - * Get the placeholder. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getPlaceholder(): string { - return $this->placeholder; - } - - - /** - * Set the default value of the setting. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $value - * - * @return WidgetSetting - */ - public function setDefault(string $value): WidgetSetting { - $this->default = $value; - - return $this; - } - - /** - * Get the default value. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getDefault(): string { - return $this->default; - } - - - /** - * @since 15.0.0 - * @deprecated 20.0.0 - */ - public function jsonSerialize(): array { - return [ - 'name' => $this->getName(), - 'title' => $this->getTitle(), - 'type' => $this->getTitle(), - 'default' => $this->getDefault(), - 'placeholder' => $this->getPlaceholder() - ]; - } -} diff --git a/lib/public/Dashboard/Model/WidgetSetup.php b/lib/public/Dashboard/Model/WidgetSetup.php deleted file mode 100644 index f3e09dcc71b..00000000000 --- a/lib/public/Dashboard/Model/WidgetSetup.php +++ /dev/null @@ -1,274 +0,0 @@ - - * - * @author Christoph Wurst - * @author Julius Härtl - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard\Model; - -use JsonSerializable; - -/** - * Interface WidgetSetup - * - * A widget must create an WidgetSetup object and returns it in the - * IDashboardWidget::getWidgetSetup method. - * - * @see IDashboardWidget::getWidgetSetup - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -final class WidgetSetup implements JsonSerializable { - public const SIZE_TYPE_MIN = 'min'; - public const SIZE_TYPE_MAX = 'max'; - public const SIZE_TYPE_DEFAULT = 'default'; - - - /** @var array */ - private $sizes = []; - - /** @var array */ - private $menus = []; - - /** @var array */ - private $jobs = []; - - /** @var string */ - private $push = ''; - - /** @var array */ - private $settings = []; - - - /** - * Get the defined size for a specific type (min, max, default) - * Returns an array: - * [ - * 'width' => width, - * 'height' => height - * ] - * - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $type - * - * @return array - */ - public function getSize(string $type): array { - if (array_key_exists($type, $this->sizes)) { - return $this->sizes[$type]; - } - - return []; - } - - /** - * Returns all sizes defined for the widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getSizes(): array { - return $this->sizes; - } - - /** - * Add a new size to the setup. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $type - * @param int $width - * @param int $height - * - * @return WidgetSetup - */ - public function addSize(string $type, int $width, int $height): WidgetSetup { - $this->sizes[$type] = [ - 'width' => $width, - 'height' => $height - ]; - - return $this; - } - - /** - * Returns menu entries. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getMenuEntries(): array { - return $this->menus; - } - - /** - * Add a menu entry to the widget. - * $function is the Javascript function to be called when clicking the - * menu entry. - * $icon is the css class of the icon. - * $text is the display name of the menu entry. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $function - * @param string $icon - * @param string $text - * - * @return WidgetSetup - */ - public function addMenuEntry(string $function, string $icon, string $text): WidgetSetup { - $this->menus[] = [ - 'function' => $function, - 'icon' => $icon, - 'text' => $text - ]; - - return $this; - } - - - /** - * Add a delayed job to the widget. - * - * $function is the Javascript function to be called. - * $delay is the time in seconds between each call. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $function - * @param int $delay - * - * @return WidgetSetup - */ - public function addDelayedJob(string $function, int $delay): WidgetSetup { - $this->jobs[] = [ - 'function' => $function, - 'delay' => $delay - ]; - - return $this; - } - - /** - * Get delayed jobs. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getDelayedJobs(): array { - return $this->jobs; - } - - - /** - * Get the push function, called when an event is send to the front-end - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getPush(): string { - return $this->push; - } - - /** - * Set the Javascript function to be called when an event is pushed to the - * frontend. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $function - * - * @return WidgetSetup - */ - public function setPush(string $function): WidgetSetup { - $this->push = $function; - - return $this; - } - - - /** - * Returns the default settings for a widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getDefaultSettings(): array { - return $this->settings; - } - - /** - * Set the default settings for a widget. - * This method is used by the Dashboard app, using the settings created - * using WidgetSetting - * - * @see WidgetSetting - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param array $settings - * - * @return WidgetSetup - */ - public function setDefaultSettings(array $settings): WidgetSetup { - $this->settings = $settings; - - return $this; - } - - - /** - * @since 15.0.0 - * @deprecated 20.0.0 - */ - public function jsonSerialize(): array { - return [ - 'size' => $this->getSizes(), - 'menu' => $this->getMenuEntries(), - 'jobs' => $this->getDelayedJobs(), - 'push' => $this->getPush(), - 'settings' => $this->getDefaultSettings() - ]; - } -} diff --git a/lib/public/Dashboard/Model/WidgetTemplate.php b/lib/public/Dashboard/Model/WidgetTemplate.php deleted file mode 100644 index 3521960c303..00000000000 --- a/lib/public/Dashboard/Model/WidgetTemplate.php +++ /dev/null @@ -1,326 +0,0 @@ - - * - * @author Julius Härtl - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard\Model; - -use JsonSerializable; - -/** - * Interface WidgetTemplate - * - * A widget must create an WidgetTemplate object and returns it in the - * IDashboardWidget::getWidgetTemplate method. - * - * @see IDashboardWidget::getWidgetTemplate - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -final class WidgetTemplate implements JsonSerializable { - - - /** @var string */ - private $icon = ''; - - /** @var array */ - private $css = []; - - /** @var array */ - private $js = []; - - /** @var string */ - private $content = ''; - - /** @var string */ - private $function = ''; - - /** @var WidgetSetting[] */ - private $settings = []; - - - /** - * Get the icon class of the widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getIcon(): string { - return $this->icon; - } - - /** - * Set the icon class of the widget. - * This class must be defined in one of the CSS file used by the widget. - * - * @see addCss - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $icon - * - * @return WidgetTemplate - */ - public function setIcon(string $icon): WidgetTemplate { - $this->icon = $icon; - - return $this; - } - - /** - * Get CSS files to be included when displaying a widget - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getCss(): array { - return $this->css; - } - - /** - * path and name of CSS files - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param array $css - * - * @return WidgetTemplate - */ - public function setCss(array $css): WidgetTemplate { - $this->css = $css; - - return $this; - } - - /** - * Add a CSS file to be included when displaying a widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $css - * - * @return WidgetTemplate - */ - public function addCss(string $css): WidgetTemplate { - $this->css[] = $css; - - return $this; - } - - /** - * Get JS files to be included when loading a widget - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return array - */ - public function getJs(): array { - return $this->js; - } - - /** - * Set an array of JS files to be included when loading a widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param array $js - * - * @return WidgetTemplate - */ - public function setJs(array $js): WidgetTemplate { - $this->js = $js; - - return $this; - } - - /** - * Add a JS file to be included when loading a widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $js - * - * @return WidgetTemplate - */ - public function addJs(string $js): WidgetTemplate { - $this->js[] = $js; - - return $this; - } - - /** - * Get the HTML file that contains the content of the widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getContent(): string { - return $this->content; - } - - /** - * Set the HTML file that contains the content of the widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $content - * - * @return WidgetTemplate - */ - public function setContent(string $content): WidgetTemplate { - $this->content = $content; - - return $this; - } - - /** - * Get the JS function to be called when loading the widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return string - */ - public function getInitFunction(): string { - return $this->function; - } - - /** - * JavaScript function to be called when loading the widget on the - * dashboard - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $function - * - * @return WidgetTemplate - */ - public function setInitFunction(string $function): WidgetTemplate { - $this->function = $function; - - return $this; - } - - /** - * Get all WidgetSetting defined for the widget. - * - * @see WidgetSetting - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @return WidgetSetting[] - */ - public function getSettings(): array { - return $this->settings; - } - - /** - * Define all WidgetSetting for the widget. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @see WidgetSetting - * - * @param WidgetSetting[] $settings - * - * @return WidgetTemplate - */ - public function setSettings(array $settings): WidgetTemplate { - $this->settings = $settings; - - return $this; - } - - /** - * Add a WidgetSetting. - * - * @see WidgetSetting - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param WidgetSetting $setting - * - * @return WidgetTemplate - */ - public function addSetting(WidgetSetting $setting): WidgetTemplate { - $this->settings[] = $setting; - - return $this; - } - - /** - * Get a WidgetSetting by its name - * - * @see WidgetSetting::setName - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $key - * - * @return WidgetSetting - */ - public function getSetting(string $key): WidgetSetting { - if (!array_key_exists($key, $this->settings)) { - return null; - } - - return $this->settings[$key]; - } - - - /** - * @since 15.0.0 - * @deprecated 20.0.0 - */ - public function jsonSerialize(): array { - return [ - 'icon' => $this->getIcon(), - 'css' => $this->getCss(), - 'js' => $this->getJs(), - 'content' => $this->getContent(), - 'function' => $this->getInitFunction(), - 'settings' => $this->getSettings() - ]; - } -} diff --git a/lib/public/Dashboard/Service/IEventsService.php b/lib/public/Dashboard/Service/IEventsService.php deleted file mode 100644 index a2a14e8c1c1..00000000000 --- a/lib/public/Dashboard/Service/IEventsService.php +++ /dev/null @@ -1,89 +0,0 @@ - - * - * @author Julius Härtl - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard\Service; - -use OCP\Dashboard\IDashboardManager; - -/** - * Interface IEventsService - * - * The Service is provided by the Dashboard app. The method in this interface - * are used by the IDashboardManager when creating push event. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -interface IEventsService { - - - /** - * Create an event for a widget and an array of users. - * - * @see IDashboardManager::createUsersEvent - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $widgetId - * @param array $users - * @param array $payload - * @param string $uniqueId - */ - public function createUsersEvent(string $widgetId, array $users, array $payload, string $uniqueId); - - - /** - * Create an event for a widget and an array of groups. - * - * @see IDashboardManager::createGroupsEvent - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $widgetId - * @param array $groups - * @param array $payload - * @param string $uniqueId - */ - public function createGroupsEvent(string $widgetId, array $groups, array $payload, string $uniqueId); - - - /** - * Create a global event for all users that use a specific widget. - * - * @see IDashboardManager::createGlobalEvent - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $widgetId - * @param array $payload - * @param string $uniqueId - */ - public function createGlobalEvent(string $widgetId, array $payload, string $uniqueId); -} diff --git a/lib/public/Dashboard/Service/IWidgetsService.php b/lib/public/Dashboard/Service/IWidgetsService.php deleted file mode 100644 index 9601a1a478e..00000000000 --- a/lib/public/Dashboard/Service/IWidgetsService.php +++ /dev/null @@ -1,56 +0,0 @@ - - * - * @author Julius Härtl - * @author Maxence Lange - * - * @license GNU AGPL version 3 or any later version - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU Affero General Public License as - * published by the Free Software Foundation, either version 3 of the - * License, or (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Affero General Public License for more details. - * - * You should have received a copy of the GNU Affero General Public License - * along with this program. If not, see . - * - */ -namespace OCP\Dashboard\Service; - -use OCP\Dashboard\Model\IWidgetConfig; - -/** - * Interface IWidgetsService - * - * The Service is provided by the Dashboard app. The method in this interface - * are used by the IDashboardManager when a widget needs to access the current - * configuration of a widget for a user. - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - */ -interface IWidgetsService { - - /** - * Returns the IWidgetConfig for a widgetId and userId - * - * @since 15.0.0 - * @deprecated 20.0.0 - * - * @param string $widgetId - * @param string $userId - * - * @return IWidgetConfig - */ - public function getWidgetConfig(string $widgetId, string $userId): IWidgetConfig; -} -- 2.39.5