IBX-8726: IsBookmarked search criterion added (#2545)

* IsBookmarked criterion added

* code moved to code_samples

* PHP CS Fixes

* REST API examples added

* Fixes after review

---------

Co-authored-by: julitafalcondusza <julitafalcondusza@users.noreply.github.com>

code_samples/search/location/isbookmarked_criterion.php

@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+use Ibexa\Contracts\Core\Repository\Values\Content\LocationQuery;
+use Ibexa\Contracts\Core\Repository\Values\Content\Query\Criterion\Location\IsBookmarked;
+
+$query = new LocationQuery();
+$query->filter = new IsBookmarked();
+/** @var \Ibexa\Contracts\Core\Repository\SearchService $searchService */
+$results = $searchService->findLocations($query);

docs/search/criteria_reference/isbookmarked_criterion.md

@@ -0,0 +1,45 @@
+---
+description: IsBookmarked Search Criterion
+---
+
+# IsBookmarked Criterion
+
+The [`IsBookmarked` Search Criterion](../../api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-Query-Criterion-Location-IsBookmarked.html)
+searches for location based on whether it's bookmarked or not.
+It works with current user reference.
+
+This Criterion is available only for location Search.
+
+## Arguments
+
+- `value` - bool representing whether to search for bookmarked location (default `true`) or not bookmarked location (`false`)
+
+## Example
+
+### PHP
+
+``` php
+[[= include_file('code_samples/search/location/isbookmarked_criterion.php', 2) =]]
+```
+
+### REST API
+
+=== "XML"
+
+    ```xml
+    <Query>
+        <Filter>
+            <IsBookmarkedCriterion>true</IsBookmarkedCriterion>
+        </Filter>
+    </Query>
+    ```
+
+=== "JSON"
+
+    ```json
+    "Query": {
+        "Filter": {
+            "IsBookmarkedCriterion": true
+        }
+    }
+    ```

docs/search/criteria_reference/search_criteria_reference.md

@@ -42,6 +42,7 @@ Due to this storage limitation, searching content using the Country Field Type o
 |[ImageMimeType](imagemimetype_criterion.md)|Image type|✔|✔||
 |[ImageOrientation](imageorientation_criterion.md)|Image orientation|✔|✔||
 |[ImageWidth](imagewidth_criterion.md)|Image width in pixels|✔|✔||
+|[IsBookmarked](isbookmarked_criterion.md)|Whether a location is bookmarked or not| |✔ |✔ |
 |[IsCurrencyEnabledCriterion](iscurrencyenabled_criterion.md)|Whether a specified currency is enabled in the system| | | |
 |[IsFieldEmpty](isfieldempty_criterion.md)|Whether a specified Field of a content item is empty or not|✔ |✔ | |
 |[IsMainLocation](ismainlocation_criterion.md)|Whether a Location is the main Location of a content item| |✔ |✔ |

mkdocs.yml

@@ -503,6 +503,7 @@ nav:
             - ImageMimeType: search/criteria_reference/imagemimetype_criterion.md
             - ImageOrientation: search/criteria_reference/imageorientation_criterion.md
             - ImageWidth: search/criteria_reference/imagewidth_criterion.md
+            - IsBookmarked: search/criteria_reference/isbookmarked_criterion.md
             - IsCurrencyEnabled: search/criteria_reference/iscurrencyenabled_criterion.md
             - IsFieldEmpty: search/criteria_reference/isfieldempty_criterion.md
             - IsMainLocation: search/criteria_reference/ismainlocation_criterion.md