hofff/contao-rate-it

RateIt extension for the Contao Open Source CMS as contao 4 bundle

0.4.4 2023-03-07 15:06 UTC

Requires

• php: ^7.1 || ^8.0
• ext-iconv: *
• ext-json: *
• ext-mbstring: *
• ext-pdo: *
• ext-session: *
• contao/core-bundle: ^4.9
• doctrine/dbal: ^2.5 || ^3.0
• symfony/config: ^4.4 || ^5.1
• symfony/console: ^4.4 || ^5.1
• symfony/dependency-injection: ^4.4 || ^5.1
• symfony/http-foundation: ^4.4 || ^5.1
• symfony/http-kernel: ^4.4 || ^5.1
• symfony/security-core: ^4.4 || ^5.1
• symfony/translation-contracts: ^1.1 || ^2.0

Requires (Dev)

• contao/manager-plugin: ^2.0
• phpcq/runner-bootstrap: ^1.0@dev

Conflicts

• cgo-it/contao-rate-it: *
• cgo-it/contao-rate-it-bundle: *
• cgo-it/news4ward-rateit: *
• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• Nicky Hoff
• David Molineus

• bundle
• Rating
• contao
• rateit
• bewertung

README

This package hofff/contao-rate-it is a fork of Contao extension Rate It, provided as cgoIT/contao-rate-it-bundle with following differences:

Added

• Disable ratings for types which should not be used
• Migration command to migrate article ratings to page ratings
• Custom position for page ratings and rateit_page_rating insert tag

Changed

• Change namespaces of every class
• Use microdata templates as default.
• Do not use client ip to detect votes of the same user. Use session id instead.
• The configured rating templates is used everywhere where ratings are used.
• Use Font Awesome as rating_default template
• The rating for each element is retained when the element gets deleted. Ratings can be deleted in the backend.

Dropped

• Drop export feature
• Drop colorbox/mediabox rating
• Drop non microdata templates
• Drop support of heart ratings. Define your icons in a template
• Drop gallery picture rating
• Drop faq rating

Requirements

• At least Contao 4.6
• AT least PHP 7.1
• Integrated Font Awesome 5 (or a custom rating_* template)

Configuration

You man want to configure the bundle using the application configuration (config/config.yml or app/config/config.yml) depending on your project. Right now you are only able to disable supported content types.

# Default configuration
hofff_contao_rate_it:
    types:
        page:                 true
        article:              true
        news:                 true
        module:               true
        ce:                   true

If you use Contao just as a Symfony bundle (not a managed edition), don't forget to add the routing information to your routes.yaml:

# routes.yaml
HofffContaoRateItBundle:
    resource: '@HofffContaoRateItBundle/Resources/config/routing.xml'

How to

Migrate article ratings to page ratings

The migration command migrates all article ratings to the corresponding pages

• Enables rating for pages with rated articles
• Create rating items for pages if not exist
• Reassign article ratings to the page
• Deletes article rating items

1. Backup your database!
2. Run vendor/bin/contao-console hofff-rate-it:migrate