heimrichhannot/contao-likes-bundle

Put like/dislike buttons on anything in Contao CMS.

0.1.2 2025-06-17 16:17 UTC

Requires

• php: ^8.2
• contao/core-bundle: ^5.1
• doctrine/dbal: ^2.13 || ^3.0
• psr/log: ^1.0 || ^2.0 || ^3.0
• symfony/config: ^6.4 || ^7.0
• symfony/event-dispatcher-contracts: ^1.0 || ^2.0 || ^3.0
• symfony/filesystem: ^6.4 || ^7.0
• symfony/http-foundation: ^6.0 || ^7.0
• symfony/http-kernel: ^6.0 || ^7.0
• symfony/string: ^6.0 || ^7.0
• twig/twig: ^3.0

Requires (Dev)

• contao/manager-plugin: ^2.0
• contao/test-case: ^4.0 || ^5.0
• heimrichhannot/contao-test-utilities-bundle: ^0.1
• php-coveralls/php-coveralls: ^2.0
• phpstan/phpstan: ^1.10
• phpstan/phpstan-symfony: ^1.2
• phpunit/phpunit: ^8.0 || ^9.0
• symfony/phpunit-bridge: ^5.4 || ^6.0

LGPL-3.0-or-later

README

Slap a like button on anything in Contao.

This Contao CMS bundle allows you to add like and dislike buttons to any (twig) template, liking or disliking whatever you please to your heart's content.

Features

• Add like and dislike buttons to any template, attached to anything you want, e.g. models or your grandma's favorite knitting patterns
• CSRF protection
• Extensive base template included
• Rate Limiting to prevent abuse
• Session-less association of likes and dislikes to individual user-agents using a tiny anonymous fingerprint
• Presumably GDPR-compliant, as no personal data is stored

Installation

You can install this bundle using Composer:

composer require heimrichhannot/contao-likes-bundle

Usage

To add a like button to your template, include a like & dislike button template and pass options as likes, preferably created by calling huh_likes() with a namespace and a target (these can be literally any strings you like to reference this likeable thing).

{{ include('@Contao/huh_likes/buttons.html.twig', { likes: huh_likes('knitting-pattern', 'honeycomb-lace') }) }}

On the Matter of liking Models

Most commonly, you will want to add a like button to something related to contao models, like a news article or a calendar event. In this case, we recommend using the model's table name as namespace and the model's ID as target. Or, even better, if you have access to the \Contao\Model instance directly in your template, just pass it in.

Table and ID	Model Instance
huh_likes('tl_news', 42)	huh_likes(model)

The Dislike Button and other Options

In the provided default template, the dislike button is NOT shown by default. If you want to show it, pass more options to the huh_likes() function:

huh_likes(model, null, {
    likes_enabled: true,
    dislikes_enabled: true,
})

Customization

Within the default template @Contao/huh_likes/buttons.html.twig, you will find four blocks that you can override with your custom icons:

• icon_like_neutral
• icon_like_set
• icon_dislike_neutral
• icon_dislike_set

With these blocks, you can easily replace the default icons with your own SVGs or any other HTML content.