[Glossary] Introduce terms listing & show pages

config/packages/twig.yaml

@@ -24,7 +24,7 @@ twig:
 
             trackers:
                 matomo: "%env(MATOMO_ID)%"
-            
+
             caseStudies:
                 enabled: true
 
@@ -45,6 +45,7 @@ twig:
             footer:
                 - { path: "case_studies", label: "Cas clients" }
                 - { path: "about", label: "À propos" }
+                - { path: "glossary", label: "Glossaire" }
                 - { path: "contact", label: "Contact" }
 
             footerServices:

content/member/_sample.yaml

@@ -20,10 +20,6 @@ linkedIn: ~
 email: ~
 avatar: content/images/member/avatars/path-to-avatar.jpg
 
-certifications:
-    - symfony
-    - opquast
-
 emojis:
     - 🎲
     - 🎮

content/member/frey.yaml

@@ -17,8 +17,6 @@ linkedIn: ~
 email: florian.rey@elao.com
 avatar: content/images/member/avatars/ffrey.jpg
 
-certifications: [ ]
-
 emojis:
     - 🌰
     - 👾

content/member/gfaivre.yaml

@@ -14,8 +14,6 @@ avatar: content/images/member/avatars/gfaivre.jpg
 
 phone: '007'
 
-certifications: [ ]
-
 emojis:
     - 🤾🏻‍♂️
     - 🎮

content/member/yheitz.yaml

@@ -13,6 +13,4 @@ linkedIn: ~
 email: yves.heitz@elao.com
 avatar: content/images/member/avatars/yheizt.png
 
-certifications: [ ]
-
 emojis: [ ]

content/term/aws.md

@@ -0,0 +1,8 @@
+---
+name: "AWS"
+logo: "build/images/services/aws.svg"
+externalLink: https://aws.amazon.com/fr/
+#metaDescription: TODO
+---
+
+Some **markdown** content

content/term/example.md

@@ -0,0 +1,17 @@
+---
+name: "Exemple"
+logo: "build/images/technos/exemple.svg"
+externalLink: http://example.org
+
+# False to prevent listing it on the glossary page.
+# Cans till be externalLinked from articles or case studies.
+listInGlossary: false
+
+# Array of slugs of related articles to show on the glossary term page.
+# If not provided (null), will search for related articles by their tags.
+articles: []
+
+metaDescription: Une description courte à utiliser dans les meta de la page
+---
+
+Some **markdown** content

content/term/ovh-cloud.md

@@ -0,0 +1,8 @@
+---
+name: "OVH Cloud"
+logo: "build/images/services/ovh-cloud.svg"
+externalLink: https://www.ovhcloud.com/fr/
+#metaDescription: TODO
+---
+
+Some **markdown** content

content/term/scaleway.md

@@ -0,0 +1,8 @@
+---
+name: "Scaleway"
+logo: "build/images/services/scaleway.svg"
+externalLink: https://www.scaleway.com/fr/
+#metaDescription: TODO
+---
+
+Some **markdown** content

src/Controller/GlossaryController.php

@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller;
+
+use App\Glossary\GlossaryBuilder;
+use App\Model\Article;
+use App\Model\CaseStudy;
+use App\Model\Glossary\Term;
+use Stenope\Bundle\ContentManagerInterface;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Annotation\Route;
+
+#[Route('/glossaire')]
+class GlossaryController extends AbstractController
+{
+    private ContentManagerInterface $manager;
+
+    public function __construct(ContentManagerInterface $manager)
+    {
+        $this->manager = $manager;
+    }
+
+    #[Route('/', name: 'glossary')]
+    public function glossary(GlossaryBuilder $builder): Response
+    {
+        $terms = $this->manager->getContents(Term::class, 'name', ['listInGlossary' => true]);
+        $articles = $this->manager->getContents(Article::class, ['date' => false]);
+
+        return $this->render('glossary/index.html.twig', [
+            'glossary' => $builder->build($terms),
+            'articles' => \array_slice($articles, 0, 4),
+        ]);
+    }
+
+    #[Route('/{term}', name: 'glossary_term')]
+    public function show(Term $term): Response
+    {
+        $articlesFilter = null !== $term->articles
+            // Search for articles by their slug if provided
+            ? static fn ($article) => \in_array($article->slug, $term->articles, true)
+            // otherwise by their tags matching the term slug
+            : static fn (Article $article): bool => $article->hasTag($term->slug)
+        ;
+
+        $articles = $this->manager->getContents(Article::class, ['date' => false], $articlesFilter);
+
+        $caseStudies = $this->manager->getContents(
+            CaseStudy::class,
+            ['date' => false],
+            fn (CaseStudy $caseStudy): bool => $caseStudy->enabled && $caseStudy->hasTerm($term)
+        );
+
+        return $this->render('glossary/term.html.twig', [
+            'term' => $term,
+            'articles' => \array_slice($articles, 0, 3),
+            'caseStudies' => $caseStudies,
+        ])->setLastModified($term->lastModified);
+    }
+}

src/Glossary/GlossaryBuilder.php

@@ -9,8 +9,8 @@
 class GlossaryBuilder
 {
     /**
-     * @param array|Term[] $terms
-     * @param int<0, max>  $split
+     * @param Term[]      $terms
+     * @param int<0, max> $split
      */
     public function build(array $terms, int $split = 3): array
     {

src/Model/Glossary/Term.php

@@ -4,11 +4,37 @@
 
 namespace App\Model\Glossary;
 
+use App\Model\MetaTrait;
+
 class Term
 {
-    public string $name;
-    public ?string $logo = null;
+    use MetaTrait;
+
     public string $slug;
-    public string $link;
+
+    public ?string $logo = null;
+
+    /** Link to outside resource for this term. */
+    public string $externalLink;
+
+    public string $name;
+
+    /** Main, markdown content */
+    public ?string $content = null;
+
+    /**
+     * Array of slugs of related articles to show on the glossary term page.
+     * If not provided (null), will search for related articles by their tags.
+     *
+     * @var string[]|null
+     */
+    public ?array $articles = null;
+
     public \DateTimeInterface $lastModified;
+
+    /**
+     * Set as false to prevent this term to appear in glossary listing.
+     * The term can still be referenced from articles or case studies.
+     */
+    public bool $listInGlossary = true;
 }

src/Model/Member.php

@@ -34,9 +34,6 @@ class Member
 
     public ?string $phone = null;
 
-    /** @var string[] */
-    public array $certifications = [];
-
     public ?array $emojis = [];
 
     // Flags

templates/case_study/show.html.twig

@@ -1,12 +1,13 @@
 {% import "macros.html.twig" as macros %}
+
 {% extends 'base.html.twig' %}
 
 {% block meta_title -%}
-    {{ caseStudy.metaTitle|default(caseStudy.title) }} | {{ parent() }}
+    {{ caseStudy.metaTitle ?? caseStudy.title }} | {{ parent() }}
 {%- endblock %}
 
 {% block meta_description -%}
-    {{ caseStudy.metaDescription|default(caseStudy.description)|default(parent()) }}
+    {{ caseStudy.metaDescription ?? parent() }}
 {%- endblock %}
 
 {% block og_image asset(caseStudy.images|first|glide_image_preset('opengraph_image')) %}
@@ -42,7 +43,7 @@
                     <div class="technologies-list__title">
                         <span class="h3--small">Les technos utilisées</span>
                     </div>
-                    {% include "glossary/term_list.html.twig" with {
+                    {% include "glossary/partials/_term_list.html.twig" with {
                         terms: caseStudy.terms
                     } only %}
                 </div>