TYPO3: Title-Tag und Description Meta Tags setzen

Einer der wichtigsten Punkte im SEO ist das korrekte Setzen des Title-Tags. Auch die Beschreibung sinnvoller Meta-Tags füllen ganze Webseiten verschiedener SEO Agenturen. Was uns jedoch mehr interessiert, sind die technischen Aspekte im TYPO3 CMS.

Seit kurzem ist es nicht mehr notwendig, umständlich im TypoScript mit UserFuncs oder ähnlichem herumzubasteln, wenn man in einer Extbase ControllerAction auf einer Detailseite sinnvolle Metatags setzen will. Alternativ ist das über die neue API auch mit Hilfe von ViewHelpern nun kein Problem mehr.

Setzen des Title Tags in TYPO3

Wir zeigen euch ein paar Beispiele (hier in einer Action):

<?php

declare(strict_types = 1);

namespace In2code\In2mvadviser\Controller;

use In2code\In2mvadviser\PageTitle\Provider;
use TYPO3\CMS\Core\Utility\GeneralUtility;

class AuthorController extends ActionController
{
    public function detailAction(Author $author): void
    {
        // Set a new title tag
        $titleProvider = GeneralUtility::makeInstance(Provider::class);
        $titleProvider->setTitle($author->getTitle());
    }
}

Das Ganze erweitern wir noch mit einem eigenen Provider:

<?php

declare(strict_types = 1);

namespace In2code\In2mvadviser\PageTitle;

use TYPO3\CMS\Core\PageTitle\AbstractPageTitleProvider;

class Provider extends AbstractPageTitleProvider
{
    public function setTitle(string $title): void
    {
        $this->title = $title;
    }
}

Wichtig ist hierbei noch eine Registrierung via TypoScript. Dies ist notwendig, damit TYPO3 entscheiden kann, welcher Titel wann ausgeliefert werden soll:

config.pageTitleProviders {
  adviser {
    provider = In2code\In2mvadviser\PageTitle\Provider
    before = altPageTitle,record,seo,news
  }
}

Setzen von Metatags in TYPO3

Das Setzen von Metatags wie beispielsweise og:image, description, og:description oder twitter:description geht sogar noch einfacher und nur via PHP:

<?php

declare(strict_types = 1);

namespace In2code\In2mvadviser\Controller;

class AuthorController extends ActionController
{
    public function detailAction(Author $author): void
    {
        // Set metatag "og:image"
        $registry = GeneralUtility::makeInstance(MetaTagManagerRegistry::class);
        $metaTagManager = $registry->getManagerForProperty('og:image');
        $metaTagManager->addProperty('og:image', '/path/to/image.jpg', ['width' => 400, 'height' => 400]);


        // Set metatags "description", "og:description" and "twitter:description"
        $descriptionFields = ['description', 'og:description', 'twitter:description'];
        foreach ($descriptionFields as $field) {
            $metaTagManager = $registry->getManagerForProperty($field);
            $metaTagManager->addProperty($field, $author->getDescription());
        }
    }
}

Hier geht es zur offiziellen Dokumentation zur PageTitle API und zur MetaTag API.

Weiteren Code in den Head bringen

Natürlich könnt ihr auch anderen, individuellen Code über PHP in den Head Bereich eures Frontends bringen - hier ein Beispiel für STYLE:

$pageRenderer = GeneralUtility::makeInstance(PageRenderer::class);
$pageRenderer->addHeaderData('<style>body{--color-brand:red;}</style>');

Übrigens: Wie ihr den Title, Metatags direkt in FLUID setzen könnt, seht ihr in einem anderen Blogpost.