languagecode_criterion.md: Move code to PHP files

Author: adriendupuis

code_samples/search/language/config/append_to_routes.yaml

@@ -0,0 +1,4 @@
+list_articles_to_translate:
+    path: /list/articles_to_translate/{language}
+    defaults:
+        _controller: 'App\Controller\ArticlesToTranslateController::listView'

code_samples/search/language/src/Command/SearchTestCommand.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Command;
+
+use Ibexa\Contracts\Core\Repository\SearchService;
+use Ibexa\Contracts\Core\Repository\Values\Content\Query;
+use Ibexa\Contracts\Core\Repository\Values\Content\Query\Criterion;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+class SearchTestCommand extends Command
+{
+    protected static $defaultName = 'doc:test:search';
+    private SearchService $searchService;
+
+    public function __construct(
+        SearchService $searchService
+    )
+    {
+        parent::__construct(self::$defaultName);
+        $this->searchService = $searchService;
+    }
+
+    protected function configure(): void
+    {
+        $this->setDescription('Search test.')
+            ->addArgument('text', InputArgument::REQUIRED | InputArgument::IS_ARRAY, 'Searched text.');
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $text = implode(' ', $input->getArgument('text'));
+
+        $query = new Query(['query' =>
+            new Criterion\LogicalAnd([
+                new Criterion\FullText($text),
+                new Criterion\LanguageCode(['eng-GB'], false)
+            ])
+        ]);
+
+        $results = $this->searchService->findContent($query, ['eng-GB', 'fre-FR', 'ger-DE']);
+        foreach ($results->searchHits as $searchHit) {
+            /** @var $content \Ibexa\Core\Repository\Values\Content\Content */
+            $content = $searchHit->valueObject;
+            dump($content->getName('eng-GB'));
+        }
+
+        return Command::SUCCESS;
+    }
+}

code_samples/search/language/src/Controller/ArticlesToTranslateController.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace App\Controller;
+
+use Ibexa\Contracts\Core\Repository\SearchService;
+use Ibexa\Contracts\Core\Repository\Values\Content\Query;
+use Ibexa\Contracts\Core\Repository\Values\Content\Query\Criterion;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class ArticlesToTranslateController extends AbstractController {
+    private SearchService $searchService;
+
+    public function __construct(SearchService $searchService)
+    {
+        $this->searchService = $searchService;
+    }
+
+    public function listView(Request $request): Response {
+        $languageCode = $request->get('language');
+
+        $query = new Query();
+        $query->query = new Criterion\LogicalAnd([
+            new Criterion\ContentTypeIdentifier('article'),
+            new Criterion\LogicalNot(
+                new Criterion\LanguageCode($languageCode, false)
+            )
+        ]);
+
+        $results = $this->searchService->findContent($query);
+        $articles = [];
+        foreach ($results->searchHits as $searchHit) {
+            $articles[] = $searchHit->valueObject;
+        }
+
+        return $this->render('@ibexadesign/list/articles_to_translate.html.twig', [
+            'articles' => $articles,
+        ]);
+    }
+}

code_samples/search/language/templates/themes/standard/list/articles_to_translate.html.twig

@@ -0,0 +1,9 @@
+{% extends '@ibexadesign/pagelayout.html.twig' %}
+
+{% block content %}
+    <ul>
+        {% for article in articles %}
+            <li><a href="{{ ibexa_path(article.contentInfo) }}">{{ ibexa_content_name(article) }}</a></li>
+        {% endfor %}
+    </ul>
+{% endblock %}

docs/search/criteria_reference/languagecode_criterion.md

@@ -45,41 +45,12 @@ You can use the `LanguageCode` Criterion to search for articles that are lacking
 into a specific language:
 
 ``` php hl_lines="5"
-$query = new Query();
-$query->query = new Criterion\LogicalAnd([
-    new Criterion\ContentTypeIdentifier('article'),
-    new Criterion\LogicalNot(
-        new Criterion\LanguageCode('ger-DE', false)
-    )
-]);
-
-$results = $this->searchService->findContent($query);
-$articles = [];
-foreach ($results->searchHits as $searchHit) {
-    $articles[] = $searchHit;
-}
-
-return $this->render('list/articles_to_translate.html.twig', [
-    'articles' => $articles,
-]);
+[[= include_file('code_samples/search/language/src/Controller/ArticlesToTranslateController.php', 22, 39) =]]
 ```
 
 You can use the `LanguageCode` Criterion to search in
 several languages while ensuring result have a translation in one language:
 
-```php
-$query = new Query(['query' =>
-    new Criterion\LogicalAnd([
-        new Criterion\FullText($text),
-        new Criterion\LanguageCode(['eng-GB'], false)
-    ])
-]);
-
-$results = $this->searchService->findContent($query, ['eng-GB', 'fre-FR', 'ger-DE']);
-
-foreach ($results->searchHits as $searchHit) {
-    /** @var $content \Ibexa\Core\Repository\Values\Content\Content */
-    $content = $searchHit->valueObject;
-    dump($content->getName('eng-GB'));
-}
+``` php
+[[= include_file('code_samples/search/language/src/Command/SearchTestCommand.php', 35, 48) =]]
 ```