Add a Twig function to generate content URLs

core-bundle/config/services.yaml

@@ -1131,6 +1131,11 @@ services:
             - '@contao.framework'
             - '@contao.resource_finder'
 
+    contao.twig.content_url_runtime:
+        class: Contao\CoreBundle\Twig\Runtime\ContentUrlRuntime
+        arguments:
+            - '@contao.routing.content_url_generator'
+
     contao.twig.csp_runtime:
         class: Contao\CoreBundle\Twig\Runtime\CspRuntime
         arguments:

core-bundle/src/Twig/Extension/ContaoExtension.php

@@ -26,6 +26,7 @@
 use Contao\CoreBundle\Twig\Interop\PhpTemplateProxyNodeVisitor;
 use Contao\CoreBundle\Twig\ResponseContext\AddTokenParser;
 use Contao\CoreBundle\Twig\ResponseContext\DocumentLocation;
+use Contao\CoreBundle\Twig\Runtime\ContentUrlRuntime;
 use Contao\CoreBundle\Twig\Runtime\CspRuntime;
 use Contao\CoreBundle\Twig\Runtime\FigureRuntime;
 use Contao\CoreBundle\Twig\Runtime\FormatterRuntime;
@@ -219,6 +220,10 @@ function (Environment $env, $context, $template, $variables = [], $withContext =
                 'csp_hash',
                 [CspRuntime::class, 'addHash'],
             ),
+            new TwigFunction(
+                'content_url',
+                [ContentUrlRuntime::class, 'generate'],
+            ),
         ];
     }
 

core-bundle/src/Twig/Runtime/ContentUrlRuntime.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of Contao.
+ *
+ * (c) Leo Feyer
+ *
+ * @license LGPL-3.0-or-later
+ */
+
+namespace Contao\CoreBundle\Twig\Runtime;
+
+use Contao\CoreBundle\Routing\ContentUrlGenerator;
+use Symfony\Component\Routing\Exception\ExceptionInterface;
+use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+use Twig\Extension\RuntimeExtensionInterface;
+
+final class ContentUrlRuntime implements RuntimeExtensionInterface
+{
+    /**
+     * @internal
+     */
+    public function __construct(private readonly ContentUrlGenerator $urlGenerator)
+    {
+    }
+
+    public function generate(object $content, array $parameters = [], bool $relative = false): string|null
+    {
+        try {
+            return $this->urlGenerator->generate($content, $parameters, $relative ? UrlGeneratorInterface::ABSOLUTE_PATH : UrlGeneratorInterface::ABSOLUTE_URL);
+        } catch (ExceptionInterface) {
+            return null;
+        }
+    }
+}

core-bundle/tests/Twig/Extension/ContaoExtensionTest.php

@@ -99,6 +99,7 @@ public function testAddsTheFunctions(): void
             'csp_nonce' => [],
             'csp_source' => [],
             'csp_hash' => [],
+            'content_url' => [],
         ];
 
         $functions = $this->getContaoExtension()->getFunctions();