diff options
Diffstat (limited to 'lib/public/Comments/ICommentsManager.php')
| -rw-r--r-- | lib/public/Comments/ICommentsManager.php | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/lib/public/Comments/ICommentsManager.php b/lib/public/Comments/ICommentsManager.php index 9aacf028b4e..178401056c7 100644 --- a/lib/public/Comments/ICommentsManager.php +++ b/lib/public/Comments/ICommentsManager.php @@ -131,6 +131,7 @@ interface ICommentsManager { * @param bool $includeLastKnown * @return IComment[] * @since 14.0.0 + * @deprecated 24.0.0 - Use getCommentsWithVerbForObjectSinceComment instead */ public function getForObjectSince( string $objectType, @@ -142,6 +143,28 @@ interface ICommentsManager { ): array; /** + * @param string $objectType the object type, e.g. 'files' + * @param string $objectId the id of the object + * @param string[] $verbs List of verbs to filter by + * @param int $lastKnownCommentId the last known comment (will be used as offset) + * @param string $sortDirection direction of the comments (`asc` or `desc`) + * @param int $limit optional, number of maximum comments to be returned. if + * set to 0, all comments are returned. + * @param bool $includeLastKnown + * @return IComment[] + * @since 24.0.0 + */ + public function getCommentsWithVerbForObjectSinceComment( + string $objectType, + string $objectId, + array $verbs, + int $lastKnownCommentId, + string $sortDirection = 'asc', + int $limit = 30, + bool $includeLastKnown = false + ): array; + + /** * Search for comments with a given content * * @param string $search content to search for @@ -198,6 +221,7 @@ interface ICommentsManager { * @param string $verb * @return int * @since 21.0.0 + * @deprecated 24.0.0 - Use getNumberOfCommentsWithVerbsForObjectSinceComment instead */ public function getNumberOfCommentsForObjectSinceComment(string $objectType, string $objectId, int $lastRead, string $verb = ''): int; |