]> source.dussan.org Git - nextcloud-server.git/commitdiff
Move comments activities to the new API
authorJoas Schilling <coding@schilljs.com>
Wed, 16 Nov 2016 10:39:06 +0000 (11:39 +0100)
committerJoas Schilling <coding@schilljs.com>
Wed, 16 Nov 2016 11:20:03 +0000 (12:20 +0100)
Signed-off-by: Joas Schilling <coding@schilljs.com>
apps/comments/appinfo/app.php
apps/comments/appinfo/info.xml
apps/comments/js/activitytabviewplugin.js
apps/comments/lib/Activity/Extension.php [deleted file]
apps/comments/lib/Activity/Filter.php [new file with mode: 0644]
apps/comments/lib/Activity/Listener.php
apps/comments/lib/Activity/Provider.php [new file with mode: 0644]
apps/comments/lib/Activity/Setting.php [new file with mode: 0644]

index 66e60dbbd85fccb95c1d0e29599113578b4f7869..144a4506d380e460bd999d9754d62e823b4640a2 100644 (file)
@@ -37,14 +37,6 @@ $eventDispatcher->addListener(
        }
 );
 
-$activityManager = \OC::$server->getActivityManager();
-$activityManager->registerExtension(function() {
-       $application = new \OCP\AppFramework\App('comments');
-       /** @var \OCA\Comments\Activity\Extension $extension */
-       $extension = $application->getContainer()->query(\OCA\Comments\Activity\Extension::class);
-       return $extension;
-});
-
 $eventDispatcher->addListener(\OCP\Comments\CommentsEntityEvent::EVENT_ENTITY, function(\OCP\Comments\CommentsEntityEvent $event) {
        $event->addEntityCollection('files', function($name) {
                $nodes = \OC::$server->getUserFolder()->getById(intval($name));
@@ -67,7 +59,7 @@ $notificationManager->registerNotifier(
 $commentsManager = \OC::$server->getCommentsManager();
 $commentsManager->registerEventHandler(function () {
        $application = new \OCP\AppFramework\App('comments');
-       /** @var \OCA\Comments\Activity\Extension $extension */
+       /** @var \OCA\Comments\EventHandler $handler */
        $handler = $application->getContainer()->query(\OCA\Comments\EventHandler::class);
        return $handler;
 });
index 1c0a38e5668ad83bcd1ad3faaee8f4da53e0313f..9d5409a2d629dfea458ba5882865b084e2d28070 100644 (file)
        <types>
                <logging/>
        </types>
+
+       <activity>
+               <settings>
+                       <setting>OCA\Comments\Activity\Setting</setting>
+               </settings>
+
+               <filters>
+                       <filter>OCA\Comments\Activity\Filter</filter>
+               </filters>
+
+               <providers>
+                       <provider>OCA\Comments\Activity\Provider</provider>
+               </providers>
+       </activity>
 </info>
index ca3253bd1375b15e639c1f4ea2fbb528dfab57b4..b6195b80c457ea2bcbf57a7deaa5236efcd8619b 100644 (file)
@@ -25,7 +25,7 @@
 
                        if (view === 'ActivityTabView') {
                                $el.addClass('comment');
-                               if (this._isLong(model.get('message_prepared'))) {
+                               if (model.get('message') && this._isLong(model.get('message'))) {
                                        $el.addClass('collapsed');
                                        var $overlay = $('<div>').addClass('message-overlay');
                                        $el.find('.activitymessage').after($overlay);
diff --git a/apps/comments/lib/Activity/Extension.php b/apps/comments/lib/Activity/Extension.php
deleted file mode 100644 (file)
index 2a155dd..0000000
+++ /dev/null
@@ -1,342 +0,0 @@
-<?php
-/**
- * @copyright Copyright (c) 2016, ownCloud, Inc.
- *
- * @author Joas Schilling <coding@schilljs.com>
- *
- * @license AGPL-3.0
- *
- * This code is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License, version 3,
- * as published by the Free Software Foundation.
- *
- * 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, version 3,
- * along with this program.  If not, see <http://www.gnu.org/licenses/>
- *
- */
-
-namespace OCA\Comments\Activity;
-
-use OCP\Activity\IExtension;
-use OCP\Activity\IManager;
-use OCP\Comments\ICommentsManager;
-use OCP\Comments\NotFoundException;
-use OCP\IL10N;
-use OCP\IURLGenerator;
-use OCP\L10N\IFactory;
-use OCP\Util;
-
-/**
- * Class Extension
- *
- * @package OCA\Comments\Activity
- */
-class Extension implements IExtension {
-       const APP_NAME = 'comments';
-
-       const ADD_COMMENT_SUBJECT = 'add_comment_subject';
-       const ADD_COMMENT_MESSAGE = 'add_comment_message';
-
-       /** @var IFactory */
-       protected $languageFactory;
-
-       /** @var IManager */
-       protected $activityManager;
-
-       /** @var ICommentsManager */
-       protected $commentsManager;
-
-       /** @var IURLGenerator */
-       protected $URLGenerator;
-
-       /**
-        * @param IFactory $languageFactory
-        * @param IManager $activityManager
-        * @param ICommentsManager $commentsManager
-        * @param IURLGenerator $URLGenerator
-        */
-       public function __construct(IFactory $languageFactory, IManager $activityManager, ICommentsManager $commentsManager, IURLGenerator $URLGenerator) {
-               $this->languageFactory = $languageFactory;
-               $this->activityManager = $activityManager;
-               $this->commentsManager = $commentsManager;
-               $this->URLGenerator = $URLGenerator;
-       }
-
-       protected function getL10N($languageCode = null) {
-               return $this->languageFactory->get(self::APP_NAME, $languageCode);
-       }
-
-       /**
-        * The extension can return an array of additional notification types.
-        * If no additional types are to be added false is to be returned
-        *
-        * @param string $languageCode
-        * @return array|false
-        */
-       public function getNotificationTypes($languageCode) {
-               $l = $this->getL10N($languageCode);
-
-               return array(
-                       self::APP_NAME => [
-                               'desc' => (string) $l->t('<strong>Comments</strong> for files'),
-                               'methods' => [self::METHOD_MAIL, self::METHOD_STREAM],
-                       ],
-               );
-       }
-
-       /**
-        * For a given method additional types to be displayed in the settings can be returned.
-        * In case no additional types are to be added false is to be returned.
-        *
-        * @param string $method
-        * @return array|false
-        */
-       public function getDefaultTypes($method) {
-               return $method === self::METHOD_STREAM ? [self::APP_NAME] : false;
-       }
-
-       /**
-        * A string naming the css class for the icon to be used can be returned.
-        * If no icon is known for the given type false is to be returned.
-        *
-        * @param string $type
-        * @return string|false
-        */
-       public function getTypeIcon($type) {
-               switch ($type) {
-                       case self::APP_NAME:
-                               return 'icon-comment';
-               }
-
-               return false;
-       }
-
-       /**
-        * The extension can translate a given message to the requested languages.
-        * If no translation is available false is to be returned.
-        *
-        * @param string $app
-        * @param string $text
-        * @param array $params
-        * @param boolean $stripPath
-        * @param boolean $highlightParams
-        * @param string $languageCode
-        * @return string|false
-        */
-       public function translate($app, $text, $params, $stripPath, $highlightParams, $languageCode) {
-               if ($app !== self::APP_NAME) {
-                       return false;
-               }
-
-               $l = $this->getL10N($languageCode);
-
-               if ($this->activityManager->isFormattingFilteredObject()) {
-                       $translation = $this->translateShort($text, $l, $params);
-                       if ($translation !== false) {
-                               return $translation;
-                       }
-               }
-
-               return $this->translateLong($text, $l, $params);
-       }
-
-       /**
-        * @param string $text
-        * @param IL10N $l
-        * @param array $params
-        * @return bool|string
-        */
-       protected function translateShort($text, IL10N $l, array $params) {
-
-               switch ($text) {
-                       case self::ADD_COMMENT_SUBJECT:
-                               if ($this->authorIsCurrentUser($params[0])) {
-                                       return (string) $l->t('You commented');
-                               }
-                               return (string) $l->t('%1$s commented', $params);
-                       case self::ADD_COMMENT_MESSAGE:
-                               return $this->convertParameterToComment($params[0]);
-               }
-
-               return false;
-       }
-
-       /**
-        * @param string $text
-        * @param IL10N $l
-        * @param array $params
-        * @return bool|string
-        */
-       protected function translateLong($text, IL10N $l, array $params) {
-
-               switch ($text) {
-                       case self::ADD_COMMENT_SUBJECT:
-                               if ($this->authorIsCurrentUser($params[0])) {
-                                       return (string) $l->t('You commented on %2$s', $params);
-                               }
-                               return (string) $l->t('%1$s commented on %2$s', $params);
-                       case self::ADD_COMMENT_MESSAGE:
-                               return $this->convertParameterToComment($params[0]);
-               }
-
-               return false;
-       }
-
-       /**
-        * Check if the author is the current user
-        *
-        * @param string $user Parameter e.g. `<user display-name="admin">admin</user>`
-        * @return bool
-        */
-       protected function authorIsCurrentUser($user) {
-               try {
-                       return strip_tags($user) === $this->activityManager->getCurrentUserId();
-               } catch (\UnexpectedValueException $e) {
-                       return false;
-               }
-       }
-
-       /**
-        * The extension can define the type of parameters for translation
-        *
-        * Currently known types are:
-        * * file               => will strip away the path of the file and add a tooltip with it
-        * * username   => will add the avatar of the user
-        *
-        * @param string $app
-        * @param string $text
-        * @return array|false
-        */
-       public function getSpecialParameterList($app, $text) {
-               if ($app === self::APP_NAME) {
-                       switch ($text) {
-                               case self::ADD_COMMENT_SUBJECT:
-                                       return [
-                                               0 => 'username',
-                                               1 => 'file',
-                                       ];
-                       }
-               }
-
-               return false;
-       }
-
-       /**
-        * The extension can define the parameter grouping by returning the index as integer.
-        * In case no grouping is required false is to be returned.
-        *
-        * @param array $activity
-        * @return integer|false
-        */
-       public function getGroupParameter($activity) {
-               return false;
-       }
-
-       /**
-        * The extension can define additional navigation entries. The array returned has to contain two keys 'top'
-        * and 'apps' which hold arrays with the relevant entries.
-        * If no further entries are to be added false is no be returned.
-        *
-        * @return array|false
-        */
-       public function getNavigation() {
-               $l = $this->getL10N();
-               return [
-                       'apps' => [
-                               self::APP_NAME => [
-                                       'id' => self::APP_NAME,
-                                       'icon' => 'icon-comment',
-                                       'name' => (string) $l->t('Comments'),
-                                       'url' => $this->URLGenerator->linkToRoute('activity.Activities.showList', ['filter' => self::APP_NAME]),
-                               ],
-                       ],
-                       'top' => [],
-               ];
-       }
-
-       /**
-        * The extension can check if a custom filter (given by a query string like filter=abc) is valid or not.
-        *
-        * @param string $filterValue
-        * @return boolean
-        */
-       public function isFilterValid($filterValue) {
-               return $filterValue === self::APP_NAME;
-       }
-
-       /**
-        * The extension can filter the types based on the filter if required.
-        * In case no filter is to be applied false is to be returned unchanged.
-        *
-        * @param array $types
-        * @param string $filter
-        * @return array|false
-        */
-       public function filterNotificationTypes($types, $filter) {
-               if ($filter === self::APP_NAME) {
-                       return array_intersect($types, [self::APP_NAME]);
-               }
-               return false;
-       }
-
-       /**
-        * For a given filter the extension can specify the sql query conditions including parameters for that query.
-        * In case the extension does not know the filter false is to be returned.
-        * The query condition and the parameters are to be returned as array with two elements.
-        * E.g. return array('`app` = ? and `message` like ?', array('mail', 'ownCloud%'));
-        *
-        * @param string $filter
-        * @return array|false
-        */
-       public function getQueryForFilter($filter) {
-               return false;
-       }
-
-       /**
-        * @param string $parameter
-        * @return string
-        */
-       protected function convertParameterToComment($parameter) {
-               if (preg_match('/^\<parameter\>(\d*)\<\/parameter\>$/', $parameter, $matches)) {
-                       try {
-                               $comment = $this->commentsManager->get((int) $matches[1]);
-                               $message = $comment->getMessage();
-                               $message = str_replace("\n", '<br />', str_replace(['<', '>'], ['&lt;', '&gt;'], $message));
-
-                               foreach ($comment->getMentions() as $mention) {
-                                       if ($mention['type'] !== 'user') {
-                                               continue;
-                                       }
-
-                                       try {
-                                               $displayName = $this->commentsManager->resolveDisplayName($mention['type'], $mention['id']);
-                                       } catch (\OutOfBoundsException $e) {
-                                               // No displayname, upon client's discretion what to display.
-                                               $displayName = $mention['id'];
-                                       }
-
-                                       $message = preg_replace(
-                                               '/(^|\s)(' . '@' . $mention['id'] . ')(\b)/',
-                                               '${1}' . $this->regexSafeUser($mention['id'], $displayName) . '${3}',
-                                               $message
-                                       );
-                               }
-                               return $message;
-                       } catch (NotFoundException $e) {
-                               return '';
-                       }
-               }
-
-               return '';
-       }
-
-       protected function regexSafeUser($uid, $displayName) {
-               // FIXME evil internal API hackery, do NOT copy this
-               return str_replace('$', '\$', '<user display-name="' . Util::sanitizeHTML($displayName) . '">' . Util::sanitizeHTML($uid) . '</user>');
-       }
-}
diff --git a/apps/comments/lib/Activity/Filter.php b/apps/comments/lib/Activity/Filter.php
new file mode 100644 (file)
index 0000000..b9417b6
--- /dev/null
@@ -0,0 +1,90 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCA\Comments\Activity;
+
+
+use OCP\Activity\IFilter;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+
+class Filter implements IFilter {
+
+       /** @var IL10N */
+       protected $l;
+
+       /** @var IURLGenerator */
+       protected $url;
+
+       public function __construct(IL10N $l, IURLGenerator $url) {
+               $this->l = $l;
+               $this->url = $url;
+       }
+
+       /**
+        * @return string Lowercase a-z only identifier
+        * @since 11.0.0
+        */
+       public function getIdentifier() {
+               return 'comments';
+       }
+
+       /**
+        * @return string A translated string
+        * @since 11.0.0
+        */
+       public function getName() {
+               return $this->l->t('Comments');
+       }
+
+       /**
+        * @return int
+        * @since 11.0.0
+        */
+       public function getPriority() {
+               return 40;
+       }
+
+       /**
+        * @return string Full URL to an icon, empty string when none is given
+        * @since 11.0.0
+        */
+       public function getIcon() {
+               return $this->url->getAbsoluteURL($this->url->imagePath('core', 'actions/comment.svg'));
+       }
+
+       /**
+        * @param string[] $types
+        * @return string[] An array of allowed apps from which activities should be displayed
+        * @since 11.0.0
+        */
+       public function filterTypes(array $types) {
+               return $types;
+       }
+
+       /**
+        * @return string[] An array of allowed apps from which activities should be displayed
+        * @since 11.0.0
+        */
+       public function allowedApps() {
+               return ['comments'];
+       }
+}
index ad1e277414888f77f0f0e5ef7c5a2678542c81fe..2ac49144690285e127bd5047bd2a3d234d73626f 100644 (file)
@@ -108,18 +108,18 @@ class Listener {
                }
 
                $activity = $this->activityManager->generateEvent();
-               $activity->setApp(Extension::APP_NAME)
-                       ->setType(Extension::APP_NAME)
+               $activity->setApp('comments')
+                       ->setType('comments')
                        ->setAuthor($actor)
-                       ->setObject($event->getComment()->getObjectType(), $event->getComment()->getObjectId())
-                       ->setMessage(Extension::ADD_COMMENT_MESSAGE, [
+                       ->setObject($event->getComment()->getObjectType(), (int) $event->getComment()->getObjectId())
+                       ->setMessage('add_comment_message', [
                                $event->getComment()->getId(),
                        ]);
 
                foreach ($users as $user => $path) {
                        $activity->setAffectedUser($user);
 
-                       $activity->setSubject(Extension::ADD_COMMENT_SUBJECT, [
+                       $activity->setSubject('add_comment_subject', [
                                $actor,
                                $path,
                        ]);
diff --git a/apps/comments/lib/Activity/Provider.php b/apps/comments/lib/Activity/Provider.php
new file mode 100644 (file)
index 0000000..4999d41
--- /dev/null
@@ -0,0 +1,198 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCA\Comments\Activity;
+
+use OCP\Activity\IEvent;
+use OCP\Activity\IManager;
+use OCP\Activity\IProvider;
+use OCP\Comments\ICommentsManager;
+use OCP\Comments\NotFoundException;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+
+class Provider implements IProvider {
+
+       /** @var IL10N */
+       protected $l;
+
+       /** @var IURLGenerator */
+       protected $url;
+
+       /** @var ICommentsManager */
+       protected $commentsManager;
+
+       /** @var IManager */
+       protected $activityManager;
+
+       /**
+        * @param IL10N $l
+        * @param IURLGenerator $url
+        * @param ICommentsManager $commentsManager
+        * @param IManager $activityManager
+        */
+       public function __construct(IL10N $l, IURLGenerator $url, ICommentsManager $commentsManager, IManager $activityManager) {
+               $this->l = $l;
+               $this->url = $url;
+               $this->commentsManager = $commentsManager;
+               $this->activityManager = $activityManager;
+       }
+
+       /**
+        * @param IEvent $event
+        * @param IEvent|null $previousEvent
+        * @return IEvent
+        * @throws \InvalidArgumentException
+        * @since 11.0.0
+        */
+       public function parse(IEvent $event, IEvent $previousEvent = null) {
+               if ($event->getApp() !== 'comments') {
+                       throw new \InvalidArgumentException();
+               }
+
+               if ($event->getSubject() === 'add_comment_subject') {
+                       $this->parseMessage($event);
+                       $event->setIcon($this->url->getAbsoluteURL($this->url->imagePath('core', 'actions/comment.svg')));
+
+                       if ($this->activityManager->isFormattingFilteredObject()) {
+                               try {
+                                       return $this->parseShortVersion($event);
+                               } catch (\InvalidArgumentException $e) {
+                                       // Ignore and simply use the long version...
+                               }
+                       }
+
+                       return $this->parseLongVersion($event);
+               } else {
+                       throw new \InvalidArgumentException();
+               }
+       }
+
+       /**
+        * @param IEvent $event
+        * @return IEvent
+        * @throws \InvalidArgumentException
+        * @since 11.0.0
+        */
+       protected function parseShortVersion(IEvent $event) {
+               $subjectParameters = $event->getSubjectParameters();
+
+               if ($event->getSubject() === 'add_comment_subject') {
+                       if ($subjectParameters[0] === $this->activityManager->getCurrentUserId()) {
+                               $event->setParsedSubject($this->l->t('You commented'))
+                                       ->setRichSubject($this->l->t('You commented'), []);
+                       } else {
+                               $author = $this->generateUserParameter($subjectParameters[0]);
+                               $event->setParsedSubject($this->l->t('%1$s commented', [$author['name']]))
+                                       ->setRichSubject($this->l->t('{author} commented'), [
+                                               'author' => $author,
+                                       ]);
+                       }
+               } else {
+                       throw new \InvalidArgumentException();
+               }
+
+               return $event;
+       }
+
+       /**
+        * @param IEvent $event
+        * @return IEvent
+        * @throws \InvalidArgumentException
+        * @since 11.0.0
+        */
+       protected function parseLongVersion(IEvent $event) {
+               $subjectParameters = $event->getSubjectParameters();
+
+               if ($event->getSubject() === 'add_comment_subject') {
+                       if ($subjectParameters[0] === $this->activityManager->getCurrentUserId()) {
+                               $event->setParsedSubject($this->l->t('You commented on %1$s', [
+                                               trim($subjectParameters[1], '/'),
+                                       ]))
+                                       ->setRichSubject($this->l->t('You commented on {file}'), [
+                                               'file' => $this->generateFileParameter($event->getObjectId(), $subjectParameters[1]),
+                                       ]);
+                       } else {
+                               $author = $this->generateUserParameter($subjectParameters[0]);
+                               $event->setParsedSubject($this->l->t('%1$s commented on %2$s', [
+                                               $author['name'],
+                                               trim($subjectParameters[1], '/'),
+                                       ]))
+                                       ->setRichSubject($this->l->t('{author} commented on {file}'), [
+                                               'author' => $author,
+                                               'file' => $this->generateFileParameter($event->getObjectId(), $subjectParameters[1]),
+                                       ]);
+                       }
+               } else {
+                       throw new \InvalidArgumentException();
+               }
+
+               return $event;
+       }
+
+       protected function parseMessage(IEvent $event) {
+               $messageParameters = $event->getMessageParameters();
+               try {
+                       $comment = $this->commentsManager->get((int) $messageParameters[0]);
+                       $message = $comment->getMessage();
+                       $message = str_replace("\n", '<br />', str_replace(['<', '>'], ['&lt;', '&gt;'], $message));
+
+                       $mentionCount = 1;
+                       $mentions = [];
+                       foreach ($comment->getMentions() as $mention) {
+                               if ($mention['type'] !== 'user') {
+                                       continue;
+                               }
+
+                               $message = preg_replace(
+                                       '/(^|\s)(' . '@' . $mention['id'] . ')(\b)/',
+                                       //'${1}' . $this->regexSafeUser($mention['id'], $displayName) . '${3}',
+                                       '${1}' . '{mention' . $mentionCount . '}' . '${3}',
+                                       $message
+                               );
+                               $mentions['mention' . $mentionCount] = $this->generateUserParameter($mention['id']);
+                               $mentionCount++;
+                       }
+
+                       $event->setParsedMessage($comment->getMessage())
+                               ->setRichMessage($message, $mentions);
+               } catch (NotFoundException $e) {
+               }
+       }
+
+       protected function generateFileParameter($id, $path) {
+               return [
+                       'type' => 'file',
+                       'id' => $id,
+                       'name' => basename($path),
+                       'path' => $path,
+                       'link' => $this->url->linkToRouteAbsolute('files.viewcontroller.showFile', ['fileid' => $id]),
+               ];
+       }
+
+       protected function generateUserParameter($uid) {
+               return [
+                       'type' => 'user',
+                       'id' => $uid,
+                       'name' => $uid,// FIXME Use display name
+               ];
+       }
+}
diff --git a/apps/comments/lib/Activity/Setting.php b/apps/comments/lib/Activity/Setting.php
new file mode 100644 (file)
index 0000000..110ec4a
--- /dev/null
@@ -0,0 +1,98 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Joas Schilling <coding@schilljs.com>
+ *
+ * @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 <http://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCA\Comments\Activity;
+
+
+use OCP\Activity\ISetting;
+use OCP\IL10N;
+
+class Setting implements ISetting {
+
+       /** @var IL10N */
+       protected $l;
+
+       /**
+        * @param IL10N $l
+        */
+       public function __construct(IL10N $l) {
+               $this->l = $l;
+       }
+
+       /**
+        * @return string Lowercase a-z and underscore only identifier
+        * @since 11.0.0
+        */
+       public function getIdentifier() {
+               return 'comments';
+       }
+
+       /**
+        * @return string A translated string
+        * @since 11.0.0
+        */
+       public function getName() {
+               return $this->l->t('<strong>Comments</strong> for files');
+       }
+
+       /**
+        * @return int whether the filter should be rather on the top or bottom of
+        * the admin section. The filters are arranged in ascending order of the
+        * priority values. It is required to return a value between 0 and 100.
+        * @since 11.0.0
+        */
+       public function getPriority() {
+               return 50;
+       }
+
+       /**
+        * @return bool True when the option can be changed for the stream
+        * @since 11.0.0
+        */
+       public function canChangeStream() {
+               return true;
+       }
+
+       /**
+        * @return bool True when the option can be changed for the stream
+        * @since 11.0.0
+        */
+       public function isDefaultEnabledStream() {
+               return true;
+       }
+
+       /**
+        * @return bool True when the option can be changed for the mail
+        * @since 11.0.0
+        */
+       public function canChangeMail() {
+               return true;
+       }
+
+       /**
+        * @return bool True when the option can be changed for the stream
+        * @since 11.0.0
+        */
+       public function isDefaultEnabledMail() {
+               return false;
+       }
+}
+