heimrichhannot/contao-head-bundle

This module contains enhancements for the contao frontend page <head> region.

Thursday, July 26, 2018
by digitales@heimrich-hannot.de
Repository
6 Watchers
1 Stars
598 Installations

PHP
3 Dependents
0 Suggesters
1 Forks
1 Open issues
19 Versions
24 % Grown

The README.md

Contao Head bundle

, _(*1)

This bundle enhances the handling of html <head> section tags. It provides services to update head tags dynamically from your code., _(*2)

Features

Provide a nice api to set head tags like meta, title, base, link
Provide additional json-ld schema data
Sets important meta tags like og:title, og:description, og:url and twitter:card out of the box
Allow setting open graph and twitter fallback image on root page
Allow setting twitter author per root page
Backport canonical url option from contao 4.13 for contao 4.9+
Backport json-ld support for contao 4.9+

Usage

Setup

Install with composer
Update your database
Set following config variables (if you don't need the legacy implementation), _(*3)
```
huh_head:
  use_contao_head: true
  use_contao_variables: true
```
Optional: Set fallback image and twitter author in root page(s)

Add additional meta tags

In your root page, you can activate to add fallback image (og:image and twitter:image) and twitter username (twitter:site) meta tags to you web page., _(*4)

Screenshot Meta Data Settings , _(*5)

Add additional schema.org data

In your root page, you can activate to add additional structured data to you web page. Following schema.org types are available: * @Organization * @WebSite * @WebPage * @BreadcrumbList, _(*6)

Screenshot Structured Data Settings , _(*7)

Set json-ld in your templates

This bundle backports the methods of contao 4.12+ to contao 4.9+. So usage is the same as in the contao core., _(*8)

Twig templates

{% do add_schema_org({
    '@type': 'NewsArticle',
    'headline': newsHeadline|striptags,
    'datePublished': datetime|date('Y-m-d\TH:i:sP'),
}) %}

PHP templates

<?php $this->addSchemaOrg([
    '@type' => 'NewsArticle',
    'headline' => $newsHeadline,
    'datePublished' => $datetime->date('Y-m-d\TH:i:sP'),
]); ?>

Integration

Use head bundle api set in your code., _(*9)

Set head content

To set base, title, meta and link tags, use the HtmlHeadTagManager service:, _(*10)

use HeimrichHannot\HeadBundle\HeadTag\BaseTag;
use HeimrichHannot\HeadBundle\HeadTag\MetaTag;
use HeimrichHannot\HeadBundle\HeadTag\TitleTag;
use HeimrichHannot\HeadBundle\HeadTag\Meta\CharsetMetaTag;
use HeimrichHannot\HeadBundle\HeadTag\Meta\HttpEquivMetaTag;
use HeimrichHannot\HeadBundle\HeadTag\Meta\PropertyMetaTag;
use HeimrichHannot\HeadBundle\Manager\HtmlHeadTagManager;
use Symfony\Component\HttpFoundation\Request;

class SomeEventListener
{
    private HtmlHeadTagManager $headTagManager;

    public function updateBaseTag(Request $request): void
    {
        // Set base tag to null to remove it
        $this->headTagManager->setBaseTag(null);

        //Set base tag from object or url
        $this->headTagManager->setBaseTag(new BaseTag($request->getSchemeAndHttpHost()));
        $this->headTagManager->setBaseTag('https://example.org'));
    }

    public function updatedTitleTag(): void
    {
        // Set title to "Hello World"
        $this->headTagManager->setTitleTag('Hello World');

        // Set title tag from object and adjust output format
        $this->headTagManager->setTitleTag(new TitleTag('Foo Bar', '%s | {{page::rootPageTitle}}'))
        // Will output: <title>Foo Bar | My Great Website Page Title</title>
    }

    public function setMetaTags(): void
    {
        // Add a new meta tag. If a tag with the same name already exists, it will be overridden
        $this->headTagManager->addMetaTag(new MetaTag('author', 'John Doe'));

        // Get an existing tag
        $description = ($tag = $this->headTagManager->getMetaTag('og:description')) ? $tag->getContent() : '';

        // Remove a tag
        $this->headTagManager->removeMetaTag('twitter:site');

        // Create a tag for property meta tags
        $this->headTagManager->addMetaTag(new PropertyMetaTag('og:type', 'article'));

        // Create a http-equiv tag
        $this->headTagManager->addMetaTag(new HttpEquivMetaTag('refresh', '30'));

        // Set a charset tag
        $this->headTagManager->addMetaTag(new CharsetMetaTag('UTF-8'));

        // Create tags without class (usefull when creating tags in a loop without custom checks)
        $this->headTagManager->addMetaTag(
            $this->headTagManager->getHeadTagFactory()->createMetaTag('description', 'Lorem ipsum!')
        );
        $this->headTagManager->addMetaTag(
            $this->headTagManager->getHeadTagFactory()->createTagByName('meta_og:url', 'https://example.org')
        );
    }

    public function setLinkTags(): void
    {
        // Add a new link tag. If a tag with the same name already exists, it will be overridden
        $this->headTagManager->addLinkTag(new LinkTag('next', 'https://example.org?page=2'));

        // Get an existing tag
        $this->headTagManager->getLinkTag('prev');

        // Remove a tag
        $this->headTagManager->removeLinkTag('prev');

        // Shorthand for canonical tag
        $this->headTagManager->setCanonical('https://example.org');
    }
}

Set json-ld schema data

From contao 4.12 you can use the JsonLdManager service from the core., _(*11)

To set json-ld schema data, use the JsonLdManager service:, _(*12)

jsonLdManager->getGraphForSchema(JsonLdManager::SCHEMA_ORG)->organization();
      $organisation->name('Example and Sons Ltd.');
      $organisation->url('https://example.org');
   }
}
```
### Reader Config Contao sample
![image](https://github.com/heimrichhannot/contao-head-bundle/assets/51906753/a5e30fdc-66f9-419a-a5a4-1805bb66b227)



## Legacy integration

Be sure, `huh_head.use_contao_head` and/or `huh_head.use_contao_variables` are not set to true.

Output `$this->meta()` in your fe_page template ()

```
block('meta'); ?>
    <?= $this->meta(); ?>
endblock(); ?>

Make sure, that you remove (are outputted by $this->meta() if huh_head.use_contao_head is not true):, _(*13)

<meta charset="<?= $this->charset ?>">
<title><?= $this->title ?></title>
<base href="<?php echo $this->base; ?>">
<meta name="robots" content="<?= $this->robots ?>">
<meta name="description" content="<?= $this->description ?>">

The meta function accepts currently one parameter that can contain service names (array) that should be skipped., _(*14)

Developers

Backend field

Get tag options for a select field. If you want to define options by your own, prepend meta tag options with meta_., _(*15)

use HeimrichHannot\HeadBundle\Helper\DcaHelper;

class HeadTagOptionsListener {
    private DcaHelper $dcaHelper;

    public function __invoke() {
        return $this->dcaHelper->getTagOptions([
            // filter: (array|null) If set, only tags fulfill given filters will be returned. See FILTER constants for available options. Default null
            'filter' => [DcaHelper::FILTER_META, DcaHelper::FILTER_TITLE],
            // skip_tags: (array) Skip specific tags. Default empty
            'skip_tag' => ['og:locale'],
        ]);
    }
}

Example how to evaluate field values:, _(*16)

use Contao\ContentModel;
use HeimrichHannot\HeadBundle\Manager\HtmlHeadTagManager;

class SomeEventListener {
    private HtmlHeadTagManager $headTagManager;

    public function __invoke(ContentModel $contentModel){
        $tag = $this->headTagManager->getHeadTagFactory()->createTagByName($contentModel->headTag);
        if ($tag) {
            $tag->setAttribute("content", $contentModel->headTagContent);
            $this->headTagManager->addTag($tag);
        }
    }
}

Config reference

# Default configuration for extension with alias: "huh_head"
huh_head:

    # Use the default head variables for title,base,robots and description instead of removing them from the page template.
    use_contao_head:      false

    # Use the default contao template variables for outputting head tags instead of the meta function.
    use_contao_variables: false

The Versions

26/07 2018

dev-master

9999999-dev

This module contains enhancements for the contao frontend page <head> region.

contao-bundle contao-head-bundle

This module contains enhancements for the contao frontend page <head> region.

heimrichhannot/contao-head-bundle

The README.md

Contao Head bundle

Features

Usage

Setup

Add additional meta tags

Add additional schema.org data

Set json-ld in your templates

Twig templates

PHP templates

Integration

Set head content

Set json-ld schema data

Developers

Backend field

Config reference

The Versions

dev-master

The Requires

The Development Requires

1.1.6

The Requires

The Development Requires

1.1.5

The Requires

The Development Requires

1.1.4

The Requires

The Development Requires

1.1.3

The Requires

The Development Requires

1.1.2

The Requires

The Development Requires

1.1.1

The Requires

The Development Requires

1.1.0

The Requires

The Development Requires

1.0.10

The Requires

The Development Requires

1.0.9

The Requires

The Development Requires

1.0.8

The Requires

The Development Requires

1.0.7

The Requires

The Development Requires

1.0.6

The Requires

The Development Requires

1.0.5

The Requires

The Development Requires

1.0.4

The Requires

The Development Requires

1.0.3

The Requires

The Development Requires

1.0.2

The Requires

The Development Requires

1.0.1

The Requires

The Development Requires

1.0.0

The Requires

The Development Requires