2013-09-20 18:37:52 +04:00
|
|
|
<?php
|
2013-11-03 16:51:39 +04:00
|
|
|
/**
|
2013-09-20 18:37:52 +04:00
|
|
|
* ownCloud
|
|
|
|
*
|
|
|
|
* @author Thomas Müller
|
|
|
|
* @copyright 2013 Thomas Müller deepdiver@owncloud.com
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 3 of the License, or any later version.
|
|
|
|
*
|
|
|
|
* This library 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 library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
2013-11-25 19:39:01 +04:00
|
|
|
/**
|
|
|
|
* Public interface of ownCloud for apps to use.
|
|
|
|
* Activity/IManager interface
|
|
|
|
*/
|
|
|
|
|
2013-11-03 16:51:39 +04:00
|
|
|
// use OCP namespace for all classes that are considered public.
|
|
|
|
// This means that they should be used by apps instead of the internal ownCloud classes
|
2013-09-20 18:37:52 +04:00
|
|
|
namespace OCP\Activity;
|
|
|
|
|
|
|
|
interface IManager {
|
|
|
|
|
2013-09-29 22:31:12 +04:00
|
|
|
/**
|
|
|
|
* @param $app
|
|
|
|
* @param $subject
|
2013-10-09 20:06:21 +04:00
|
|
|
* @param $subjectParams
|
2013-09-29 22:31:12 +04:00
|
|
|
* @param $message
|
2013-10-09 20:06:21 +04:00
|
|
|
* @param $messageParams
|
2013-09-29 22:31:12 +04:00
|
|
|
* @param $file
|
|
|
|
* @param $link
|
2013-10-09 20:06:21 +04:00
|
|
|
* @param $affectedUser
|
|
|
|
* @param $type
|
|
|
|
* @param $priority
|
2013-09-29 22:31:12 +04:00
|
|
|
* @return mixed
|
|
|
|
*/
|
2013-10-09 20:06:21 +04:00
|
|
|
function publishActivity($app, $subject, $subjectParams, $message, $messageParams, $file, $link, $affectedUser, $type, $priority);
|
2013-09-20 18:37:52 +04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* In order to improve lazy loading a closure can be registered which will be called in case
|
|
|
|
* activity consumers are actually requested
|
|
|
|
*
|
2014-07-03 15:48:15 +04:00
|
|
|
* $callable has to return an instance of \OCP\Activity\IConsumer
|
2013-09-20 18:37:52 +04:00
|
|
|
*
|
|
|
|
* @param \Closure $callable
|
2014-02-06 19:30:58 +04:00
|
|
|
* @return void
|
2013-09-20 18:37:52 +04:00
|
|
|
*/
|
|
|
|
function registerConsumer(\Closure $callable);
|
|
|
|
|
2014-07-03 15:48:15 +04:00
|
|
|
/**
|
|
|
|
* In order to improve lazy loading a closure can be registered which will be called in case
|
|
|
|
* activity consumers are actually requested
|
|
|
|
*
|
|
|
|
* $callable has to return an instance of \OCP\Activity\IExtension
|
|
|
|
*
|
|
|
|
* @param \Closure $callable
|
|
|
|
* @return void
|
|
|
|
*/
|
|
|
|
function registerExtension(\Closure $callable);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Will return additional notification types as specified by other apps
|
|
|
|
* @param string $languageCode
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
function getNotificationTypes($languageCode);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param array $types
|
|
|
|
* @param string $filter
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
function filterNotificationTypes($types, $filter);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param string $method
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
function getDefaultTypes($method);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param string $app
|
|
|
|
* @param string $text
|
|
|
|
* @param array $params
|
|
|
|
* @param boolean $stripPath
|
|
|
|
* @param boolean $highlightParams
|
|
|
|
* @param string $languageCode
|
|
|
|
* @return string|false
|
|
|
|
*/
|
|
|
|
function translate($app, $text, $params, $stripPath, $highlightParams, $languageCode);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param string $type
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
function getTypeIcon($type);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param array $activity
|
|
|
|
* @return integer|false
|
|
|
|
*/
|
|
|
|
function getGroupParameter($activity);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
function getNavigation();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param string $filterValue
|
|
|
|
* @return boolean
|
|
|
|
*/
|
|
|
|
function isFilterValid($filterValue);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param string $filter
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
function getQueryForFilter($filter);
|
2013-09-20 18:37:52 +04:00
|
|
|
}
|