Move code to external file

Author: dabrt

code_samples/api/public_php_api/src/Command/FindContentTypeCommand.php

@@ -0,0 +1,59 @@
+<?php declare(strict_types=1);
+
+namespace App\Command;
+
+use Ibexa\Contracts\Core\Repository\ContentTypeService;
+use Ibexa\Contracts\Core\Repository\Values\ContentType\Query\ContentTypeQuery;
+use Ibexa\Contracts\Core\Repository\Values\ContentType\Query\Criterion;
+use Ibexa\Contracts\Core\Repository\Values\ContentType\Query\SortClause;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+#[AsCommand(
+    name: 'doc:find_content_types',
+    description: 'Lists content types that match specific criteria.'
+)]
+class FindContentTypesCommand extends Command
+{
+    public function __construct(private readonly ContentTypeService $contentTypeService)
+    {
+        parent::__construct();
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        // Find content types whose identifier is "folder" or "article",
+        // or content type "user"
+        $query = new ContentTypeQuery(
+            new Criterion\LogicalOr([
+                new Criterion\LogicalAnd([
+                    new Criterion\ContentTypeIdentifier(['folder', 'article']),
+                ]),
+                new Criterion\ContentTypeIdentifier(['user']),
+            ]),
+            [
+                new SortClause\Id(),
+                new SortClause\Identifiers(),
+                new SortClause\Name(),
+            ]
+        );
+
+        $searchResult = $this->contentTypeService->findContentTypes($query);
+
+        $output->writeln('Found ' . $searchResult->totalCount . ' content types:');
+
+        foreach ($searchResult->searchHits as $searchHit) {
+            $contentType = $searchHit->valueObject;
+            $output->writeln(sprintf(
+                '- [%d] %s (identifier: %s)',
+                $contentType->id,
+                $contentType->getName(),
+                $contentType->identifier
+            ));
+        }
+
+        return Command::SUCCESS;
+    }
+}

docs/content_management/content_api/managing_content.md

@@ -177,31 +177,8 @@ This method accepts a `ContentTypeQuery` object that supports filtering and sort
 
 The following example shows how you can use the criteria to find content types:
 
-```php hl_lines="9-15"
-<?php
-
-declare(strict_types=1);
-
-use Ibexa\Contracts\Core\Repository\Values\ContentType\Query\Criterion;
-use Ibexa\Contracts\Core\Repository\Values\ContentType\Query\ContentTypeQuery;
-
-// Example: find content types whose identifier is "folder" or "article" *and* are in group 1, or identifier is "user":
-$query = new ContentTypeQuery(
-    new Criterion\LogicalOr([
-        new Criterion\LogicalAnd([
-            new Criterion\ContentTypeIdentifier(['folder','article']),
-            new Criterion\ContentTypeGroupIds([1]),
-        ]),
-        new Criterion\ContentTypeIdentifier(['user']),
-    ]),
-    [
-        new SortClause\Id(),
-        new SortClause\Identifier(),
-        new SortClause\Name(),
-    ]
-);
-
-$results = $contentTypeService->findContentTypes($query);
+```php hl_lines="12-17"
+[[= include_file('code_samples/api/public_php_api/src/Command/FindContentTypeCommand.php', 17, 43) =]]
 ```
 
 #### Query parameters

docs/search/content_type_search_reference/content_type_sort_clauses.md

@@ -19,31 +19,8 @@ Sort Clauses are found in the [`Ibexa\Contracts\Core\Repository\Values\ContentTy
 
 The following example shows how to use them to sort the searched content items:
 
-```php hl_lines="18-20"
-<?php
-
-declare(strict_types=1);
-
-use Ibexa\Contracts\Core\Repository\Values\ContentType\Query\Criterion;
-use Ibexa\Contracts\Core\Repository\Values\ContentType\Query\ContentTypeQuery;
-
-// Example: find content types whose identifier is "folder" or "article" *and* are in group 1, or identifier is "user":
-$query = new ContentTypeQuery(
-    new Criterion\LogicalOr([
-        new Criterion\LogicalAnd([
-            new Criterion\ContentTypeIdentifier(['folder','article']),
-            new Criterion\ContentTypeGroupIds([1]),
-        ]),
-        new Criterion\ContentTypeIdentifier(['user']),
-    ]),
-    [
-        new SortClause\Id(),
-        new SortClause\Identifier(),
-        new SortClause\Name(),
-    ]
-);
-
-$results = $contentTypeService->findContentTypes($query);
+```php hl_lines="37-39"
+[[= include_file('code_samples/api/public_php_api/src/Command/FindContentTypeCommand.php') =]]
 ```
 
 You can change the default sorting order by using the `SORT_ASC` and `SORT_DESC` constants from [`AbstractSortClause`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-CoreSearch-Values-Query-AbstractSortClause.html#constants).