IBX-6878: Customize search sorting

code_samples/back_office/search/config/append_to_services.yaml

@@ -0,0 +1,5 @@
+services:
+
+    App\Search\SortingDefinition\Provider\RandomSortingDefinitionProvider:
+        tags:
+            -   name: ibexa.search.sorting_definition.provider

code_samples/back_office/search/src/Search/SortingDefinition/Provider/RandomSortingDefinitionProvider.php

@@ -0,0 +1,41 @@
+<?php declare(strict_types=1);
+
+namespace App\Search\SortingDefinition\Provider;
+
+use Ibexa\Contracts\Core\Repository\Values\Content\Query\SortClause;
+use Ibexa\Contracts\Search\SortingDefinition\SortingDefinition;
+use Ibexa\Contracts\Search\SortingDefinition\SortingDefinitionProviderInterface;
+use JMS\TranslationBundle\Model\Message;
+use JMS\TranslationBundle\Translation\TranslationContainerInterface;
+use Symfony\Contracts\Translation\TranslatorInterface;
+
+final class RandomSortingDefinitionProvider implements SortingDefinitionProviderInterface, TranslationContainerInterface
+{
+    private TranslatorInterface $translator;
+
+    public function __construct(TranslatorInterface $translator)
+    {
+        $this->translator = $translator;
+    }
+
+    public function getSortingDefinitions(): array
+    {
+        return [
+            new SortingDefinition(
+                'random',
+                $this->translator->trans('sort_definition.random.label'),
+                [
+                    new SortClause\Random(),
+                ],
+                400
+            ),
+        ];
+    }
+
+    public static function getTranslationMessages(): array
+    {
+        return [
+            (new Message('sort_definition.random.label', 'ibexa_search'))->setDesc('Shuffle'),
+        ];
+    }
+}

code_samples/back_office/search/translations/ibexa_search.en.yaml

@@ -0,0 +1 @@
+sort_definition.random.label: 'Shuffle'

docs/administration/back_office/search_sorting.md

@@ -0,0 +1,7 @@
+---
+description: Add a "sort by" method to the Back Office search result page.
+---
+
+- Implements `SortingDefinitionProviderInterface::getSortingDefinitions`
+- Implements `TranslationContainerInterface::getTranslationMessages`
+- Tag as `ibexa.search.sorting_definition.provider`

mkdocs.yml

@@ -137,6 +137,7 @@ nav:
             - Multi-file upload: administration/back_office/multifile_upload.md
             - Sub-items list: administration/back_office/subitems_list.md
             - Notifications: administration/back_office/notifications.md
+            - Customize search sorting: administration/back_office/search_sorting.md
     - Content management:
         - Content management: content_management/content_management.md
         - Content management guide: content_management/content_management_guide.md