feat: added title slugify Twig extension

Author: thorsten

docs/development.md

@@ -428,6 +428,14 @@ Example:
 
     {{ 'string' | translate }}
 
+### Title slugify Twig Extensions
+
+The title slugify extension is used to create a slug from a string.
+
+Example:
+
+     {{ "Hello World"|slugify }}  {# outputs: hello-world #}
+
 ### User name Twig Extensions
 
 The username extension is used to get the name of a user by its ID.

phpmyfaq/assets/templates/admin/content/comments.twig

@@ -53,7 +53,7 @@
                     <div class="d-flex align-items-center me-3">
                       <i aria-hidden="true" class="bi bi-chat-dots me-1"></i>
                       <a
-                        href="../?action=faq&cat={{ comment.categoryId }}&id={{ comment.recordId }}&artlang={{ currentLocale }}">
+                        href="../content/{{ comment.categoryId }}/{{ comment.recordId }}/{{ currentLocale }}/{{ comment.recordId | faqQuestion | slugify }}.html">
                         {{ comment.recordId | faqQuestion | raw }}
                       </a>
                     </div>
@@ -102,7 +102,7 @@
                       {{ comment.date | format_datetime(locale=currentLocale) }}
                     </div>
                     <div class="d-flex align-items-center me-3">
-                      <a href="../?action=news&newsid={{ comment.recordId }}&artlang={{ currentLocale }}">
+                      <a href="../news/{{ comment.recordId }}/{{ currentLocale }}/news.html">
                         <i class="bi bi-newspaper"></i>
                       </a>
                     </div>

phpmyfaq/src/phpMyFAQ/Comments.php

@@ -154,7 +154,7 @@ public function getAllComments(string $type = CommentType::FAQ): array
     }
 
     /**
-     * Checks, if comments are disabled for the FAQ record.
+     * Checks if comments are disabled for the FAQ record.
      *
      * @param int    $recordId ID of FAQ or news entry
      * @param string $recordLang  Language

phpmyfaq/src/phpMyFAQ/Controller/Administration/CommentsController.php

@@ -26,6 +26,7 @@
 use phpMyFAQ\Pagination;
 use phpMyFAQ\Session\Token;
 use phpMyFAQ\Twig\Extensions\FaqTwigExtension;
+use phpMyFAQ\Twig\Extensions\TitleSlugifierTwigExtension;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Attribute\Route;
@@ -73,6 +74,7 @@ public function index(Request $request): Response
 
         $this->addExtension(new IntlExtension());
         $this->addExtension(new AttributeExtension(FaqTwigExtension::class));
+        $this->addExtension(new AttributeExtension(TitleSlugifierTwigExtension::class));
         return $this->render(file: '@admin/content/comments.twig', context: [
             ...$this->getHeader($request),
             ...$this->getFooter(),

phpmyfaq/src/phpMyFAQ/Twig/Extensions/CreateLinkTwigExtension.php

@@ -23,6 +23,7 @@
 use phpMyFAQ\Configuration;
 use phpMyFAQ\Faq;
 use phpMyFAQ\Link;
+use phpMyFAQ\Link\Util\TitleSlugifier;
 use Twig\Attribute\AsTwigFilter;
 use Twig\Attribute\AsTwigFunction;
 use Twig\Extension\AbstractExtension;
@@ -34,12 +35,18 @@ class CreateLinkTwigExtension extends AbstractExtension
     public static function categoryLink(int $categoryId): string
     {
         $configuration = Configuration::getConfigurationInstance();
-        $urlString = '%sindex.php?action=show&cat=%d';
-        $url = sprintf($urlString, $configuration->getDefaultUrl(), $categoryId);
 
         $category = new Category($configuration);
         $categoryEntity = $category->getCategoryData($categoryId);
 
+        $urlString = '%scategory/%d/%s.html';
+        $url = sprintf(
+            $urlString,
+            $configuration->getDefaultUrl(),
+            $categoryId,
+            TitleSlugifier::slug($categoryEntity->getName()),
+        );
+
         $link = new Link($url, $configuration);
         $link->setTitle($categoryEntity->getName());
 
@@ -51,12 +58,22 @@ public static function categoryLink(int $categoryId): string
     public static function faqLink(int $categoryId, int $faqId, string $faqLanguage): string
     {
         $configuration = Configuration::getConfigurationInstance();
-        $urlString = '%sindex.php?action=faq&cat=%d&id=%d&artlang=%s';
-        $url = sprintf($urlString, $configuration->getDefaultUrl(), $categoryId, $faqId, $faqLanguage);
 
         $faq = new Faq($configuration);
+        $question = $faq->getQuestion($faqId);
+
+        $urlString = '%scontent/%d/%d/%s/%s.html';
+        $url = sprintf(
+            $urlString,
+            $configuration->getDefaultUrl(),
+            $categoryId,
+            $faqId,
+            $faqLanguage,
+            TitleSlugifier::slug($question),
+        );
+
         $link = new Link($url, $configuration);
-        $link->setTitle($faq->getQuestion($faqId));
+        $link->setTitle($question);
 
         return $link->toString();
     }

phpmyfaq/src/phpMyFAQ/Twig/Extensions/TitleSlugifierTwigExtension.php

@@ -0,0 +1,33 @@
+<?php
+
+/**
+ * Twig extension to slugify titles
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * @package   phpMyFAQ\Template
+ * @author    Thorsten Rinne <thorsten@phpmyfaq.de>
+ * @copyright 2026 phpMyFAQ Team
+ * @license   https://www.mozilla.org/MPL/2.0/ Mozilla Public License Version 2.0
+ * @link      https://www.phpmyfaq.de
+ * @since     2026-01-05
+ */
+
+declare(strict_types=1);
+
+namespace phpMyFAQ\Twig\Extensions;
+
+use phpMyFAQ\Link\Util\TitleSlugifier;
+use Twig\Attribute\AsTwigFilter;
+use Twig\Extension\AbstractExtension;
+
+class TitleSlugifierTwigExtension extends AbstractExtension
+{
+    #[AsTwigFilter(name: 'slugify')]
+    public static function slugify(string $title): string
+    {
+        return TitleSlugifier::slug($title);
+    }
+}

tests/phpMyFAQ/Twig/Extensions/CreateLinkTwigExtensionTest.php

@@ -152,6 +152,7 @@ public function testClassHasCorrectImports(): void
             'use phpMyFAQ\Configuration;',
             'use phpMyFAQ\Faq;',
             'use phpMyFAQ\Link;',
+            'use phpMyFAQ\Link\Util\TitleSlugifier;',
             'use Twig\Attribute\AsTwigFilter;',
             'use Twig\Attribute\AsTwigFunction;',
             'use Twig\Extension\AbstractExtension;',
@@ -177,10 +178,11 @@ public function testMethodCreatesCorrectUrlFormat(): void
         $filename = new ReflectionClass(CreateLinkTwigExtension::class)->getFileName();
         $source = file_get_contents($filename);
 
-        // Should create URL with proper format
-        $this->assertStringContainsString('index.php?action=show&cat=', $source);
+        // Should create URL with proper format using TitleSlugifier
+        $this->assertStringContainsString('category/%d/%s.html', $source);
         $this->assertStringContainsString('sprintf', $source);
         $this->assertStringContainsString('$categoryId', $source);
+        $this->assertStringContainsString('TitleSlugifier::slug', $source);
     }
 
     public function testMethodIsStaticForTwigCompatibility(): void
@@ -293,8 +295,8 @@ public function testUrlGenerationPattern(): void
         // Should use Configuration to get default URL
         $this->assertStringContainsString('$configuration->getDefaultUrl()', $source);
 
-        // Should format URL with category ID
-        $this->assertStringContainsString('%sindex.php?action=show&cat=%d', $source);
+        // Should format URL with category ID and slug
+        $this->assertStringContainsString('%scategory/%d/%s.html', $source);
     }
 
     public function testMethodHandlesConfigurationProperly(): void

tests/phpMyFAQ/Twig/Extensions/TitleSlugifierTwigExtensionTest.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace phpMyFAQ\Twig\Extensions;
+
+use PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations;
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\TestCase;
+use Twig\Environment;
+use Twig\Error\LoaderError;
+use Twig\Error\RuntimeError;
+use Twig\Error\SyntaxError;
+use Twig\Extension\AttributeExtension;
+use Twig\Loader\ArrayLoader;
+
+#[AllowMockObjectsWithoutExpectations]
+class TitleSlugifierTwigExtensionTest extends TestCase
+{
+    /**
+     * @throws SyntaxError
+     * @throws RuntimeError
+     * @throws LoaderError
+     */
+    #[DataProvider('slugifyProvider')]
+    public function testSlugifyFilter(string $input, string $expected): void
+    {
+        $loader = new ArrayLoader([
+            'index' => '{{ title|slugify }}',
+        ]);
+        $twig = new Environment($loader);
+        $twig->addExtension(new AttributeExtension(TitleSlugifierTwigExtension::class));
+
+        $output = $twig->render('index', ['title' => $input]);
+        $this->assertSame($expected, $output);
+    }
+
+    /**
+     * @return array<string, array<string, string>>
+     */
+    public static function slugifyProvider(): array
+    {
+        return [
+            'simple title' => [
+                'input' => 'Hello World',
+                'expected' => 'hello-world',
+            ],
+            'title with umlauts' => [
+                'input' => 'Über uns',
+                'expected' => 'ueber-uns',
+            ],
+            'title with punctuation' => [
+                'input' => 'What is PHP?',
+                'expected' => 'what-is-php',
+            ],
+            'title with apostrophe' => [
+                'input' => "It's a test",
+                'expected' => 'it_s-a-test',
+            ],
+            'title with multiple spaces' => [
+                'input' => 'Multiple   spaces   here',
+                'expected' => 'multiple-spaces-here',
+            ],
+            'title with dashes' => [
+                'input' => 'HD-Ready TV',
+                'expected' => 'hd_ready-tv',
+            ],
+        ];
+    }
+}