Collaborative Editing criterions and sort clauses

docs/search/collaborative_editing_search_reference/invitation/created_at_invitation_criterion.md

@@ -0,0 +1,23 @@
+---
+description: CreatedAt Search Criterion
+---
+
+# CreatedAt Search Criterion
+
+The `CreatedAt` Search Criterion searches for invitations based on the date they were created.
+
+## Arguments
+
+- `value` - date to be matched, provided as a DateTimeInterface object
+- `operator` - optional operator string (check the list of the allowed values: https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-CoreSearch-Values-Query-Criterion-FieldValueCriterion.html#constants)
+
+## Example
+
+```php
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\CreatedAt(
+    new DateTime('2025-05-01 14:07:02'),
+    FieldValueCriterion:: COMPARISON_GTE
+);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/created_at_invitation_sort_clause.md

@@ -0,0 +1,19 @@
+---
+description: CreatedAt Sort Clause
+---
+
+# CreatedAt Sort Clause
+
+The `CreatedAt` Sort Clause sorts search results by the date and time of the creation of invitation.
+
+## Arguments
+
+- (optional) `direction` - SortDirection constant, either SortDirection::ASC or SortDirection::DESC.
+
+## Example
+
+```php
+$sortClause = [new \Ibexa\Contracts\Collaboration\Invitation\Query\SortClause\CreatedAt(SortDirection::DESC)]);
+
+$query = new InvitationQuery($criteria, sortClause);
+```

docs/search/collaborative_editing_search_reference/invitation/id_invitation_criterion.md

@@ -0,0 +1,23 @@
+---
+description: Id Search Criterion
+---
+
+# Id Criterion
+
+The `Id` Search Criterion searches for invitations based on invitation ID.
+
+## Arguments
+
+- `value` - integer(s) representing the Invitation ID(s)
+
+## Example
+
+```php
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Id(1);
+
+OR
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Id([1, 2]);
+
+$query = new SessionQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/invitation_id_invitation_sort_clause.md

@@ -0,0 +1,19 @@
+---
+description: InvitationId Sort Clause
+---
+
+# InvitationId Sort Clause
+
+The `InvitationId` Sort Clause sorts search results by invitation ID.
+
+## Arguments
+
+- (optional) `direction` - SortDirection constant, either SortDirection::ASC or SortDirection::DESC.
+
+## Example
+
+```php
+$sortClause = [new \Ibexa\Contracts\Collaboration\Invitation\Query\SortClause\Id(SortDirection::DESC)]);
+
+$query = new InvitationQuery($criteria, sortClause);
+```

docs/search/collaborative_editing_search_reference/invitation/invitation_status_invitation_sort_clause.md

@@ -0,0 +1,19 @@
+---
+description: InvitationStatus Sort Clause
+---
+
+# InvitationStatus Sort Clause
+
+The `InvitationStatus` Sort Clause sorts search results by invitation status.
+
+## Arguments
+
+- (optional) `direction` - SortDirection constant, either SortDirection::ASC or SortDirection::DESC.
+
+## Example
+
+```php
+$sortClause = [new \Ibexa\Contracts\Collaboration\Invitation\Query\SortClause\Status(SortDirection::DESC)]);
+
+$query = new InvitationQuery($criteria, sortClause);
+```

docs/search/collaborative_editing_search_reference/invitation/logical_and_invitation_criterion.md

@@ -0,0 +1,20 @@
+---
+description: LogicalAnd Search Criterion
+---
+
+# LogicalAnd Criterion
+
+The `LogicalAnd` Search Criterion matches combined invitations by the logical operator.
+
+## Example
+
+```php
+$currentUser = $this->permissionResolver->getCurrentUserReference();
+
+$criteria = \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\LogicalAnd( 
+    new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Status('pending'), 
+    new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Sender($currentUser)
+);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/logical_or_invitation_criterion.md

@@ -0,0 +1,18 @@
+---
+description: LogicalOr Search Criterion
+---
+
+# LogicalOr Criterion
+
+The `LogicalOr` Search Criterion matches combined invitations by the logical operator.
+
+## Example
+
+```php
+$criteria = \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\LogicalOr( , 
+    new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Id(1),
+    new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Status('pending') 
+);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/sender_invitation_criterion.md

@@ -0,0 +1,26 @@
+---
+description: Sender Search Criterion
+---
+
+# Sender Search Criterion
+
+The `Sender` Search Criterion searches for invitations based on invitation sender.
+
+## Arguments
+
+- `value` - user(s) to be matched, provided as a UserReference object
+
+## Example
+
+```php
+$user = $this->userService->loadUserByLogin('foo');
+$currentUser = $this->permissionResolver->getCurrentUserReference();
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Owner($user);
+
+OR
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Owner([$user, $currentUser]);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/session_invitation_criterion.md

@@ -0,0 +1,26 @@
+---
+description: Session Search Criterion
+---
+
+# Session Search Criterion
+
+The `Session` Search Criterion searches for invitations based on session.
+
+## Arguments
+
+- `value` - objects(s) representing the session(s) and implementing `\Ibexa\Contracts\Collaboration\Session\SessionInterface`
+
+## Example
+
+```php
+$firstSession = $this->sessionService->getSession(1);
+$secondSession = $this->sessionService->getSession(2);
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Session($firstSession);
+
+OR
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Session([$firstSession, $secondSession]);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/status_invitation_criterion.md

@@ -0,0 +1,23 @@
+---
+description: Status Search Criterion
+---
+
+# Status Search Criterion
+
+The `Status` Search Criterion searches for invitations based on status.
+
+## Arguments
+
+- `value` - string(s) representing the invitation status(es)
+
+## Example
+
+```php
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Type('pending');
+
+OR
+
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\Type(['pending', 'accepted']);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/updated_at_invitation_criterion.md

@@ -0,0 +1,23 @@
+---
+description: UpdatedAt Search Criterion
+---
+
+# UpdatedAt Criterion
+
+The `UpdatedAt` Search Criterion searches for invitations based on the date they were updated.
+
+## Arguments
+
+- `value` - date to be matched, provided as a DateTimeInterface object
+- `operator` - optional operator string ((check the list of the allowed values: https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-CoreSearch-Values-Query-Criterion-FieldValueCriterion.html#constants)
+
+## Example
+
+```php
+$criteria = new \Ibexa\Contracts\Collaboration\Invitation\Query\Criterion\UpdatedAt(
+    new DateTime('2025-05-01 14:07:02'),
+    FieldValueCriterion:: COMPARISON_GTE
+);
+
+$query = new InvitationQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/invitation/updated_at_invitation_sort_clause.md

@@ -0,0 +1,19 @@
+---
+description: UpdatedAt Sort Clause
+---
+
+# UpdatedAt Sort Clause
+
+The UpdatedAt Sort Clause sorts search results by the date and time when invitation was updated.
+
+## Arguments
+
+- (optional) `direction` - SortDirection constant, either SortDirection::ASC or SortDirection::DESC.
+
+## Example
+
+```php
+$sortClause = [new \Ibexa\Contracts\Collaboration\Invitation\Query\SortClause\UpdatedAt(SortDirection::DESC)]);
+
+$query = new InvitationQuery($criteria, sortClause);
+```

docs/search/collaborative_editing_search_reference/session/content_id_session_criterion.md

@@ -0,0 +1,23 @@
+---
+description: ContentID Search Criterion
+---
+
+# ContentID Criterion
+
+The `ContentID` Search Criterion searches for content sessions based on content item ID.
+
+## Arguments
+
+- `value` - integer(s) representing the content item id(s)
+
+## Example
+
+```php
+$criteria = new \Ibexa\Share\Session\Query\Criterion\ContentId(1);
+
+OR
+
+$criteria = new \Ibexa\Share\Session\Query\Criterion\ContentId([1, 2]);
+
+$query = new SessionQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/session/content_session_criterion.md

@@ -0,0 +1,26 @@
+---
+description: ContentSession Search Criterion
+---
+
+# ContentSession Criterion
+
+The `ContentSession` Search Criterion searches for contentId, versionNo, languageId.
+
+## Arguments
+
+- `contentId` - integer representing content item ID
+- `versionNo` - integer representing version number
+- `languageId` - integer representing language ID
+
+## Example
+
+```php
+$criteria = new \Ibexa\Share\Session\Query\Criterion\ContentSession(1, 2, 3);
+
+OR
+
+$versionInfo = $this->contentService->loadVersionInfoById(1);
+$criteria = new \Ibexa\Share\Session\Query\Criterion\ContentSession::fromVersionInfo($versionInfo);
+
+$query = new SessionQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/session/created_at_session_criterion.md

@@ -0,0 +1,23 @@
+---
+description: CreatedAt Search Criterion
+---
+
+# CreatedAt Criterion
+
+The `CreatedAt` Search Criterion searches for sessions based on the date when they were created.
+
+## Arguments
+
+- `value` - date to be matched, provided as a DateTimeInterface object
+- `operator` - optional operator string ((check the list of the allowed values: https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-CoreSearch-Values-Query-Criterion-FieldValueCriterion.html#constants)
+
+## Example
+
+```php
+$criteria = new Ibexa\Contracts\Collaboration\Session\Query\Criterion\CreatedAt(
+    new DateTime('2025-05-01 14:07:02'),
+    FieldValueCriterion:: COMPARISON_GTE
+);
+
+$query = new SessionQuery($criteria);
+```

docs/search/collaborative_editing_search_reference/session/created_at_session_sort_clause.md

@@ -0,0 +1,19 @@
+---
+description: CreatedAt Sort Clause
+---
+
+# CreatedAt Sort Clause
+
+The `CreatedAt` Sort Clause sorts search results by the date and time of the creation of session.
+
+## Arguments
+
+- (optional) `direction` - SortDirection constant, either SortDirection::ASC or SortDirection::DESC.
+
+## Example
+
+```php
+$sortClause = [new \Ibexa\Contracts\Collaboration\Session\Query\SortClause\CreatedAt(SortDirection::DESC)]);
+
+$query = new SessionQuery($criteria, sortClause);
+```